本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
Google Maps Platform 是集成最广泛的地理编码服务之一,这也使它成为最难迁移的服务之一。仅仅为了试用另一家提供商,就在整个代码库中重写请求构建和响应解析代码,这很少值得投入相应的工程时间。所以我们构建了一个不要求您重写任何代码的主机。
我们的 Google Maps Platform 兼容主机完全复刻原服务的请求参数和响应结构,唯一的区别是版权、条款和隐私文本,这些是我们自己的内容。您的集成目前发送给 Google 地理编码端点的任何请求,都可以改为发送给我们。切换提供商变成了更换主机名和密钥的小事,而不是一个开发项目。
它与我们自己的原生端点并存。如果您是从零开始,/v1/forward、/v1/reverse、/v1/autocomplete 和 /v1/postcode 的文档位于 /docs/,可以直接使用我们的请求结构。如果您已经有按 Google 格式编写的代码,位于 /compatibility/google-maps/ 的兼容主机可以让您原样保留这些代码。
身份验证与 My Geocode 所有地方一样灵活:通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数发送您的密钥。无论您现有的客户端库对 Google API 使用哪种方式,这四种中总有一种与之匹配,因此集成中的身份验证代码通常也无需修改。
兼容主机上的定价与 My Geocode 其他地方相同。每个密钥每天可获得 2,500 次免费请求,此外任何地址无需密钥即可每天使用 2,500 次,按网络统计。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量。使用兼容主机而非原生端点,并不会有单独的、更高的费率。每个端点和每个兼容替换主机的价格都相同。
每个响应也都带有与 API 其余部分相同的配额响应头,包括 X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Credits-Remaining 等,为您提供用量可见性,而单纯更换提供商并不会免费带来这一点。
如果您的集成需要标准响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在兼容结构之上叠加可选的额外字段,例如地面海拔。这完全是附加性的:不开启它,响应就与原提供商的格式完全一致。
试用只需几分钟,而不是一个迭代周期。用一个新密钥向 /compatibility/google-maps/ 发送一次测试调用,然后把响应与您现在得到的结果进行比较。