将 Zapier 或 Make 自动化流程迁移到新的地理编码主机
基于地理编码步骤构建的无代码自动化流程,需要与自定义代码不同的迁移方法。下面介绍如何完成这种切换。
Google Maps Platform 往往是一个团队接入的第一个地理编码 API,这主要是因为它是业内最响亮的名字。如今大多数开发者都熟悉它的认证模式:一个与 Google Cloud 项目中的结算账户绑定的 API 密钥,在每个请求中以查询参数的形式发送。它的地理编码响应以 JSON 对象的形式返回,包含一个 results 数组、一个 status 字段、一个 formatted_address 字符串,以及一个保存纬度和经度的嵌套 geometry.location 对象。
团队对切换通常最担心的,是围绕这一确切结构编写的解析代码。地址组成部分、视口边界、地点 ID,所有这些都由分散在代码库各处的函数读取,而重写这些函数是谁都不想排进日程的任务。这正是兼容主机旨在避免的具体问题。
My Geocode 运行着一个 Google Maps 兼容主机,逐字段重现 Google 自己的地理编码请求和响应格式。响应中唯一属于我们的文本是版权、条款和隐私声明;其他一切,包括字段名称和嵌套结构,都与您的代码已经预期的内容一致。实际上,迁移意味着更改一个主机名和一个密钥,而不是改动解析器。详情见 /compatibility/google-maps/。
保持不变的部分:
会变化的部分:
由于密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数发送,已经以自己特定方式进行认证的客户端库通常无需修改即可继续工作。这种灵活性比听起来更重要,因为实际中很多迁移的痛苦都来自那些假定只有一种特定凭据传递方式的库。
在价格方面,模式很简单:任何地址无需密钥即可每天免费请求 2,500 次,每个密钥还有每天 2,500 次免费请求,按网络计算。超出之后是每次请求 €0.0001 的预付额度,或每月 €50 的 Unlimited 套餐,每个端点(包括每个兼容主机)的费用都相同。不会因为调用哪个产品而需要协商不同的档位。
可选的附加字段,包括地面海拔、IP 威胁信号和网络详情,可以通过添加 mg_extras=1 或 X-MG-Extras 请求头在任何兼容主机上获得,而不会破坏您其余代码所依赖的结构。这为您以后获取更丰富的数据提供了一条路径,而无需第二次迁移。
如果您的集成还涉及逆地理编码、地址自动补全或邮政编码查询,同样只需更换主机和密钥,不过由于各国的地址格式惯例不同,在切换之前,值得对照您当前的代码检查这些端点的确切请求和响应结构。在完全切换之前,先用一部分生产流量测试新主机,是确认结构符合预期的合理方法。所有兼容主机的完整字段参考请参见 /docs/compatibility/。