新闻

与 Bing Maps REST Services 的兼容替换已上线

许多地图集成是多年前基于 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-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-Remaining 以及我们标准响应头集合中的其余各项,让您始终准确了解某个密钥或网络的用量状况,而原服务并不以这种形式提供这些信息。

对于希望获得比严格兼容响应更多内容的团队,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在标准结构之上添加可选字段,而不会打乱原有结构。完全不设置该标志时,响应在结构上与原 API 返回的内容毫无区别。

逐个端点讲解如何迁移现有集成的迁移指南位于 /docs/compatibility/,主机本身的文档位于 /compatibility/bing-maps/。测试它只需要几分钟空闲时间和一个密钥,不花任何费用。