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 提供的资源以及每个端点返回的数据。
数据资源 | 返回的数据 | 返回格式 |
---|---|---|
地理编码 | 返回地址、地址组成部分和地址类型。请参阅地理编码请求和响应指南中的结果。 |
|
反向地理编码 | 返回地址、地址组成部分和地址类型。请参阅反向地理编码请求和响应指南中的反向地理编码响应。 | |
地点地理编码 | 返回地址、地址组成部分和地址类型。请参阅地点地理编码请求和响应指南中的反向地理编码响应。 |
如何使用 Geocoding API
1 | 开始设置。 | 请先设置您的 Google Cloud 项目,并完成后面的设置说明。 |
2 | 尝试地理编码请求 | 有了 API 密钥后,您就可以直接通过 c网址 或浏览器测试 Geocoding API 了。您需要提供正确的查询参数来进行地址或组成部分查找。如需了解详情,请参阅地理编码参数。 |
3 | 尝试反向地理编码请求 | 提供纬度/经度坐标以及您的 API 密钥,即可获取该位置距离最近且直观易懂的地址地址组成部分。 如需了解详情,请参阅反向地理编码请求 。 |
4 | 了解回复基础知识 | Geocoding API 中的所有端点都以 JSON 或 XML 格式返回相同的数据。 请参阅地理编码响应,了解有关数据、状态代码和错误消息的说明。 |
5 | 将地理编码数据整合到您自己的应用中! | 您可以使用地理编码数据从地图标记中获取地址,或根据已知地址在地图上提供标记。 |
可用的客户端库
通过以下某个客户端库使用您选择的语言调用此 API:
- 适用于 Google 地图服务的 Java 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开放源代码。 请从 GitHub 下载这些客户端库,并在那里找到安装说明和示例代码。
后续步骤
- 开始使用 Geocoding API:前往设置您的 Google Cloud 项目。
- 示例请求和响应使用入门:前往地理编码请求和响应
- 遵循最佳做法:转到地理编码地址最佳做法。