Geocoding API 是一项服务，它接受地点作为地址、纬度和经度坐标或地点 ID。它会将地址转换为纬度和经度坐标以及地点 ID，或者将纬度和经度坐标或地点 ID 转换为地址。
Geocoding API 的功能
您可以使用 Geocoding API 获取一个或多个地址或地点的地理编码数据，包括：
此版本的 Geocoding API v4 包含以下端点的发布：
- 对地址进行地理编码 - 地址的地理坐标。也称为“正向地理编码” 。
- 对位置进行地理编码 - 一组纬度和经度坐标的地址。也称为“反向地理编码” 。
- 地点地理编码 - 从地点 ID 检索地址。
- 搜索目的地 - 从地址、地点 ID 或位置搜索目的地。
您可以控制结果的显示位置，并将结果限制为特定区域、县或邮政编码。
试用演示
Geocoding API 的工作方式
Geocoding API 可执行地理编码和反向地理编码：
- 地理编码：将地址 （例如“1600 Amphitheatre Parkway, Mountain View, CA”）转换为纬度和 经度坐标或地点 ID。您可以使用这些坐标在地图上放置标记，或在视口内居中或重新定位地图。
- 反向地理编码： 将纬度和经度坐标或地点 ID 转换为 人类可读的地址。您可以将地址用于各种场景，包括送货或取货。
下表总结了可通过 Geocoding API 获得的资源以及每种方法返回的数据。
| 数据资源 | 返回的数据 | 返回格式 |
|---|---|---|
| 地理编码 | 返回地址、地址组成部分和地址类型。请参阅 地理编码响应文档。 |
|
| 反向地理编码 | 返回地址、地址组成部分和地址类型。请参阅 反向地理编码响应 文档。 | |
| 地点地理编码 | 返回地址、地址组成部分和地址类型。请参阅 地点地理编码响应 文档。 | |
| 目的地搜索 | 根据不同的输入条件（例如地址、地点 ID 或纬度和经度坐标），返回有关各种目的地的详细信息。请参阅 目的地搜索文档。 |
Geocoding API v4 中的功能
Geocoding API 第 4 版提供了以下新功能。
目的地搜索方法
v4 引入了 目的地搜索 方法，可让您 根据不同的 输入条件（例如地址、地点 ID 或纬度和经度 坐标）检索有关各种目的地的详细信息。响应包括 AI 生成的 摘要和导航 点令牌，其中 包含可传递给Navigation SDK以进行精确路线规划的情境信息。
。在 Google Cloud 标准平台上实现
Geocoding API v4 在 Google Cloud 的 服务 基础架构 上实现。此实现带来了更安全、更值得信赖的 平台，并提供了 OAuth等增强的安全选项。这种标准 API 设计在 API 之间带来了一致性，提高了使用 Geocoding API v4 进行开发的效率。
添加了 OAuth 支持
Geocoding API v4 支持使用 OAuth 2.0 进行身份验证。Google 支持常见的 OAuth 2.0 用例，例如网络服务器用例。
添加了字段掩码支持
使用字段掩码指定响应应返回哪些 信息。对于“对地址进行地理编码”“对位置进行地理编码”和“地点地理编码”方法，默认情况下会返回响应对象中的所有字段。对于“搜索目的地”方法，您必须在 API 请求中指定字段掩码。
API 安全性
Geocoding API v4 设计为服务器到服务器 API。如果直接从浏览器进行客户端调用，API 密钥会面临被盗用和滥用的重大风险，因为 HTTP 引荐来源网址限制不足以保护 Web 服务端点。
我们强烈建议您从自己的后端服务器调用 Geocoding API v4。如需详细了解安全实现模式和 客户端需求的替代方案，请参阅安全 注意事项。