本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
许多地图集成是多年前基于 Bing Maps REST Services 构建的,此后一直原封不动地运行着,因为从来没有足够的理由去重写它们。我们认为现在有了一个理由:一个兼容主机,接受同样的请求,返回同样结构的响应,而价格和配额结构从第一次调用起就清清楚楚。
我们的 Bing Maps REST Services 兼容主机完全复刻原服务的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容对应的是 My Geocode 而非原提供商。现有代码无论是按 Bing 的格式构建请求、按 Bing 的格式解析响应,还是两者兼有,都可以直接指向我们的主机,无需任何重写。
切换只需改两处:请求发送到的主机名,以及用于身份验证的密钥。密钥可以按您的集成原本期望的任何方式传递:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或普通的查询参数。这四种方式在 My Geocode 的所有主机上(包括这一个)效果完全相同。
兼容层之下的定价与平台其他地方完全相同。每个地址无需任何密钥即可获得每天 2,500 次免费请求,按网络统计,因此无法把一个共享连接拆分到多个密钥上来成倍增加免费额度。每个密钥还会在此基础上额外提供每天 2,500 次免费请求。超出这些配额后,用量从预付额度中扣除,每次请求 €0.0001,或者选择每月 €50 的 Unlimited 套餐;无论请求发往哪个主机或端点,这一费率都保持不变。
即使响应结构与另一家提供商一致,配额可见性也不会消失。每次调用仍然会返回 X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining 以及我们标准响应头集合中的其余各项,让您始终准确了解某个密钥或网络的用量状况,而原服务并不以这种形式提供这些信息。
对于希望获得比严格兼容响应更多内容的团队,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在标准结构之上添加可选字段,而不会打乱原有结构。完全不设置该标志时,响应在结构上与原 API 返回的内容毫无区别。
逐个端点讲解如何迁移现有集成的迁移指南位于 /docs/compatibility/,主机本身的文档位于 /compatibility/bing-maps/。测试它只需要几分钟空闲时间和一个密钥,不花任何费用。