Geocoding API 概览

Geocoding API 是一项服务,可接受以地址、经纬度坐标或地点 ID 形式表示的地点。它会将地址转换为经纬度坐标以及地点 ID,或将纬度和经度坐标或地点 ID 转换为地址。

为何使用 Geocoding API

如果您想在某个 Google Maps Platform API 提供的地图中使用地理编码数据,请使用适用于网站或移动应用的 Geocoding API。借助 Geocoding API,您可以使用地址在地图上放置标记,或将地图上的标记转换为地址。此服务旨在对预定义的静态地址进行地理编码,以便在地图上放置应用内容。

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 密钥后,您可以直接从 c网址 或浏览器开始测试 Geocoding API。您需要为地址或组成部分查找提供正确的查找参数。如需了解详情,请参阅地理编码参数
3 尝试反向地理编码请求 请随 API 密钥提供纬度/经度坐标,以获取该位置最接近人类可读地址的地址组成部分。 如需了解详情,请参阅反向地理编码请求
4 了解响应基础知识 Geocoding API 中的所有端点会以 JSON 或 XML 格式返回相同的数据。有关数据、状态代码和错误消息的说明,请参阅地理编码响应
5 将地理编码数据整合到您自己的应用中! 您可以使用地理编码数据从地图标记获取地址,或根据已知地址在地图上提供标记。

可用的客户端库

请通过以下任一客户端库使用您选择的语言调用此 API:

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

后续步骤