新闻

专用的邮政编码查询端点

并不是每个位置问题都真的是地理编码问题。有时应用真正需要的只是某个区域的邮政编码,或某个邮政编码覆盖的区域,而不需要正向或逆地理编码提供的更全面的地址解析。/v1/postcode 正是为这个更窄的问题而设,它是一个独立的专用端点,而不是更通用查询的附带功能。

将它与 /v1/forward/v1/reverse 分开,有几个实际原因。这意味着请求结构可以专门围绕邮政编码参数构建,而不是从更宽泛的地址结构改造而来。这意味着响应可以专注于只需要邮政编码的集成真正需要的内容,无需过滤多余的地址字段。这也意味着文档(完整内容见 /docs/postal-code-lookup/)可以单独解释邮政编码的行为,而不是作为一篇更长的地理编码指南中的一个小节。

身份验证规则与其他所有端点相同:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数,都以同样方式被接受。价格也相同:先使用同一份每日免费配额(无论来自调用方网络还是来自密钥),超出部分同样按每次请求 €0.0001 从预付额度扣除,或由 Unlimited 套餐覆盖。

批量请求在这里的工作方式与平台上其他地方完全相同:在一次调用中提交的每个邮政编码或地址都算作一次请求,而不是整个调用算一次。一个需要校验大量客户名单中邮政编码的团队,可以将名单作为批量请求发送,并享受与 My Geocode 上任何其他批量操作相同的逐项计数方式。

有了专用端点,我们十七个兼容主机中的邮政编码兼容工作也更加精确,因为对于提供专用邮政编码查询的服务商,可以做到精确匹配,而不是通过更宽泛的地理编码结构来近似模拟。

如果您的应用只需要邮政编码信息,而此前一直在发送更宽泛的地理编码请求来提取这一个字段,那么值得直接改用 /v1/postcode。它的完整文档见 /docs/postal-code-lookup/,其余端点参考见 /docs/