Geocoding API v4 概览

欧洲经济区 (EEA) 开发者

Geocoding API 是一项服务，可接受地点作为地址、经纬度坐标或地点 ID。它可将地址转换为纬度和经度坐标以及地点 ID，也可将纬度和经度坐标或地点 ID 转换为地址。

Geocoding API 的用途

您可以使用 Geocoding API 获取一个或多个地址或地点的地理编码数据，包括：

此版本的地理编码 API v4 包含以下端点的发布：

您可以控制结果的显示位置，并将结果限制在特定区域、县或邮政编码范围内。

Geocoding API 的运作方式

Geocoding API 可执行地理编码和反向地理编码：

  • 地理编码：将地址（例如“1600 Amphitheatre Parkway, Mountain View, CA”）转换为纬度和经度坐标或地点 ID。您可以使用这些坐标在地图上放置标记，或在视图框架内居中放置地图或重新定位地图。
  • 反向地理编码：将纬度和经度坐标或地点 ID 转换为直观易懂的地址。地址可用于各种场景，包括送货或取货。

下表总结了可通过地理编码 API 获取的资源，以及每个端点返回的数据。

数据资源 返回的数据 返回格式
地理编码 返回地址、地址组成部分和地址类型。请参阅地理编码响应文档。
  • JSON
反向地理编码 返回地址、地址组成部分和地址类型。请参阅反向地理编码响应文档。
地点地理编码 返回地址、地址组成部分和地址类型。请参阅地点地理编码响应文档。
目的地搜索 根据不同的输入条件（例如地址、地点 ID 或纬度和经度坐标）返回有关各种目的地的详细信息。请参阅目的地搜索文档。

Geocoding API v4 中的功能

Geocoding API 第 4 版提供以下新功能。

目的地搜索端点

v4 引入了目的地搜索端点，可让您根据不同的输入条件（例如地址、地点 ID 或纬度和经度坐标）检索有关各种目的地的详细信息。响应包含 AI 赋能的摘要和包含可传递给 Navigation SDK 的情境信息的导航点令牌，以便进行精准的路线规划。

在 Google Cloud 标准平台上实现

地理编码 API v4 在 Google Cloud 的服务基础架构上实现。此实现带来了更安全可靠的平台，并提供了增强的安全选项，例如 OAuth。这种标准 API 设计可提高 API 之间的一致性，从而提高使用 Geocoding API v4 进行开发的效率。

添加了 OAuth 支持

Geocoding API v4 支持使用 OAuth 2.0 进行身份验证。Google 支持常见的 OAuth 2.0 用例，例如网络服务器用例。

添加了字段掩码支持

使用字段掩码指定响应应返回哪些信息。对于对地址进行地理编码、对位置进行地理编码和地点地理编码端点，默认情况下会返回响应对象中的所有字段。对于搜索目的地端点，您必须在 API 请求中指定字段掩码。

在预览版期间使用无需付费

Geocoding API v4 目前处于预 GA 预览版阶段，在预览版期间使用该 API 不会产生任何费用。API 调用将显示在 Cloud 控制台的“结算”页面上，但费用将为 0 美元。

反馈

这是一项预览版功能。欢迎发送电子邮件至 geocoding-feedback-channel@google.com 提供反馈。