迁移

迁出 Bing Maps 海拔集成

Bing Maps 通过其 Elevations API 提供海拔数据,为一个或多个坐标点返回地面海拔值(通常以米为单位),它属于用于地理编码和其他位置服务的同一个 Bing Maps Dev Center 账户。与大多数海拔依赖一样,它往往只在应用的一小部分中被调用:路线剖面图、地形叠加层或飞行规划工具,而不是贯穿整个代码库。

这种局限性对迁移确实很有帮助。海拔调用通常被隔离在一个小型服务或工具模块之后,响应本身除了坐标和一个数字之外几乎没有别的内容,因此与地理编码迁移相比,需要审查的解析逻辑要少得多。

My Geocode 的海拔查询是一个完全可用的独立端点,文档见 /docs/elevation-lookup/,与任何地理编码兼容主机无关。对一个坐标发出请求会直接返回地面海拔,而且由于这是可以具体描述和测试真实结果的查询之一,用几个已知的海拔参考点来验证迁移,是一种实用且快速的建立信心的方法。

从 Bing 海拔服务迁出时特别值得检查的事项:

  • 您的应用是否批量请求海拔(每次调用多个坐标),如果是,请在假定吞吐量相同之前,用您的典型批量大小测试新端点
  • 下游是否有地方在意单位约定,因为以米为单位的海拔值是标准做法,但任何为显示而转换为英尺的代码都应对照新端点的原始输出进行验证
  • 海拔调用是作为面向用户请求的一部分同步进行,还是作为后台处理的一部分异步进行,因为这会影响您实际需要测试的延迟容忍度

新端点的身份验证接受通过 X-API-KeyAuthorization: Bearer、HTTP Basic 认证或查询参数发送的密钥。价格与其他所有端点一样采用统一结构:不用密钥每天免费 2,500 次请求,每个密钥每天另有 2,500 次免费请求,按网络计算,之后按每次请求 €0.0001 使用预付额度,或使用每月 €50 的 Unlimited 密钥。

如果海拔功能当初被捆绑进更大的 Bing Maps 账户主要是为了方便而非必要,那么在地理编码迁移之前先把它迁出,可以缩小仍依赖原账户的范围,并让您在处理更大的任务之前,以低风险的方式试运行一次迁移流程。