将 Zapier 或 Make 自动化流程迁移到新的地理编码主机
基于地理编码步骤构建的无代码自动化流程,需要与自定义代码不同的迁移方法。下面介绍如何完成这种切换。
HERE Geocoding and Search 经常出现在汽车和物流软件中,在这些行业里,拥有指定联系人和支持合同的企业账户是常规的合作方式。认证通常使用 API 密钥或 OAuth 令牌,响应以 items 数组的形式返回,其中每个元素都带有一个 position 对象和一个结构化的 address 块,包含 label、countryCode 和 houseNumber 等字段。
在依赖它的公司内部,这种结构往往有完善的文档记录,因为选择 HERE 通常正是看中它在特定地区的地址解析质量,或它与技术栈其他部分的路线规划集成。一次破坏响应结构的迁移,会同时破坏所有这些下游代码,这就是为什么在这里兼容性比账户本身的切换成本更重要。
My Geocode 的 HERE 兼容主机完全按照 HERE 返回的方式重现 items 数组及其嵌套的 position 和 address 字段,只替换了版权、条款和隐私文本。字段参考见 /compatibility/here/。在大多数情况下,应用代码中需要更改的只是主机名和密钥,读取 items[0].position 或 items[0].address.label 的代码无需任何改动。
从 HERE 迁出的企业团队,往往在多个服务而不是一个服务中接入了地理编码,因此先盘点每一个调用点会很有帮助:批处理任务、地址验证表单、配送路线规划以及任何管理工具,往往都会各自独立地调用同一个 API。从流量较低的服务开始,一次迁移一个服务,是在调用量最大的服务切换之前,在真实条件下验证新主机的明智方法。
在认证方面,My Geocode 签发的密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数发送。如果您现有的 HERE 客户端库已经以某种特定方式进行认证,通常只需用新密钥将其指向新主机即可,因为库本身无需更改。
价格方面省去了企业合同常有的一层谈判。没有分级的账户结构:无需密钥即可每天免费请求 2,500 次,每个密钥每天再增加 2,500 次免费请求,按网络计算,超出之后是每次请求 €0.0001 的预付额度或每月 €50 的 Unlimited 密钥。每个端点(包括这个兼容主机)的费用都相同,因此不需要为地理编码调用量与搜索或自动建议调用量分别谈判。
如果您对 HERE 的部分使用是自动建议而不是直接的地理编码,值得把它作为单独的迁移步骤来处理,因为自动补全类端点有自己的响应结构,其请求模式依赖于不完整的输入,应当单独测试,而不是并入地理编码的切换中。每个请求(包括兼容主机上的请求)的配额用量,都可以通过 X-Quota-Used 和 X-Credits-Remaining 等响应头查看,相关文档见 /docs/rate-limits/。