Geocoding API 概览

欧洲经济区 (EEA) 开发者

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

Geocoding API 的用途

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

  • 地址的地理坐标。
  • 一组纬度和经度坐标对应的地址。
  • 地点 ID 对应的地址。

您可以控制结果的显示位置，并将结果限制为特定地区、县或邮政编码。

Geocoding API 的运作方式

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

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

以下演示使用 Maps JavaScript API 中的地理编码服务来演示 Geocoding API 的运作方式。在单独的标签页中打开地图， 即可查看更多选项和详细信息。

资源

下表总结了通过 Geocoding API 提供的资源，以及每个端点返回的数据。

数据资源 返回的数据 返回格式
地理编码 返回地址、地址组成部分和地址类型。请参阅地理编码请求和响应指南中的结果。
  • JSON
  • XML
反向地理编码 返回地址、地址组成部分和地址类型。请参阅反向地理编码请求和响应指南中的反向地理编码响应。
地点地理编码 返回地址、地址组成部分和地址类型。请参阅地点地理编码请求和响应指南中的反向地理编码响应。

如何使用 Geocoding API

1 进行设置。 首先设置您的 Google Cloud 项目，然后按照后续的设置说明完成操作。
2 尝试地理编码请求 获得 API 密钥后，您就可以直接通过 curl 或浏览器开始测试 Geocoding API。您需要为地址或组件查找提供正确的查找参数。如需了解详情，请参阅地理编码参数。
3 尝试发出反向地理编码请求 提供纬度/经度坐标以及 API 密钥，以获取相应位置最近的直观易懂的地址的地址组成部分。如需了解详情，请参阅反向地理编码请求。
4 了解响应基础知识 Geocoding API 中的所有端点都会以 JSON 或 XML 格式返回相同的数据。 如需了解数据、状态代码和错误消息，请参阅地理编码响应。
5 将地理编码数据纳入您自己的应用中！ 您可以使用地理编码数据从地图标记中获取地址，或根据已知地址在地图上提供标记。

可用的客户端库

通过以下客户端库之一，以您选择的语言调用此 API：

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库，并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些客户端库，还可以在其中找到安装说明和示例代码。

后续步骤