Geocoding API v4 概览

欧洲经济区 (EEA) 开发者

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

Geocoding API 的用途

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

此版本的 Geocoding API v4 包含以下端点：

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

试用演示

Geocoding API 的运作方式

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

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

下表总结了可通过 Geocoding API 获取的资源以及每种方法返回的数据。

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

发布阶段渠道

Geocoding API 版本 4 针对正式版、预览版和实验版功能提供了不同的渠道。如果您想使用预览版或实验版功能，请务必在请求中指定正确的渠道。例如，如需访问实验性 Destinations 端点的功能，请使用以下 HTTP 请求：https://geocode.googleapis.com/v4alpha/geocode/destinations。

发布阶段 频道名称
GA /v4/
预览 /v4beta/
实验性 /v4alpha/
  • 如需查看所有可用 REST 资源的列表和说明，请参阅 REST 参考文档。
  • 如需详细了解每个阶段，请参阅发布阶段。

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 场景，例如 Web 服务器场景。

添加了字段掩码支持

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

API 安全性

Geocoding API v4 是一种服务器到服务器 API。从浏览器直接进行客户端调用会使 API 密钥面临被盗和滥用的重大风险，因为 HTTP 引荐来源网址限制不足以保护 Web 服务端点。

我们强烈建议您从自己的后端服务器调用 Geocoding API v4。如需详细了解安全实现模式和客户端需求替代方案，请参阅安全注意事项。