将 Zapier 或 Make 自动化流程迁移到新的地理编码主机
基于地理编码步骤构建的无代码自动化流程,需要与自定义代码不同的迁移方法。下面介绍如何完成这种切换。
MapQuest Geocoding 已经存在很久,许多基于它构建的集成比当前这一波地图 API 中的很多产品还要早。它的密钥通过 MapQuest 开发者账户生成,作为查询参数发送,响应返回一个 results 数组,其中嵌套一个 locations 数组,每一项都带有一个 latLng 对象和拆分好的地址结构,例如表示城市的 adminArea5 和表示邮政编码的 postalCode。
这么老的集成有时会带着一种特殊的技术债:调用 MapQuest 的代码可能是一位已经离开团队的人写的,注释里提到的决定也没人记得是谁做的。这不是回避迁移的理由,但它是彻底测试的理由,而不要假定现在负责迁移的人已经充分理解了现有代码。
My Geocode 的 MapQuest 兼容主机复现了 results 和 locations 数组结构以及 latLng 和地址字段,只修改了版权、条款和隐私文字。完整详情见 /compatibility/mapquest/。在大多数情况下,更新主机和密钥就是全部改动;嵌套的 results[0].locations[0].latLng 访问方式应当继续返回相同结构的数据。
对于这样的旧集成,合理的操作顺序如下:
新服务的身份验证接受 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数,因此无论旧的 MapQuest 密钥是以何种方式发送的,这里都有对应的选项。
价格统一,不需要选择账户档位:不用密钥每天免费 2,500 次请求,每个密钥每天另有 2,500 次免费请求,按网络计算,之后按每次请求 €0.0001 使用预付额度,或使用每月 €50 的 Unlimited 密钥。所有端点(包括这个兼容主机)价格相同,这就去掉了旧合同中有时以按量档位跳变形式存在的一个变量。
对于一个多年来无需太多关注就一直默默运行的 MapQuest 集成,这类迁移的目标是让它在迁移后同样安静:相同的响应结构,相同的代码,只是幕后换了主机和密钥。