适用于 Google 地图网络服务的客户端库

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

为何要使用客户端库？

借助适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端，您可以在自己的服务器上使用 Google 地图网络服务。这些客户端库封装了以下 API 的功能：

除了这些 API 提供的功能外，客户端库还能略微简化一些常见任务。

  • 自动速率限制：默认情况下，按照各网络服务的预期速率限制发送请求。您可以通过 new GeoApiContext().setQueryRateLimit(qps) 提供自定义 QPS 限制。
  • 失败时重试：客户端库将在 API 发送 5xx 错误时自动重试任何请求。重试使用指数退避，这有助于解决间歇性故障。
  • 轻松进行身份验证：利用客户端库，您可以使用免费提供的 API 密钥轻松进行身份验证。Google Maps Platform 专业版方案客户可以使用其客户端 ID 和密钥进行身份验证。
  • POJO：Java 客户端库将针对每个 API 响应返回原生对象。Python 客户端库将从 API 收到的结构原样返回。
  • 异步或同步：所有请求都支持同步或异步调用样式。

条款及条件

适用于 Google 地图网络服务的客户端库已获得 Apache 2.0 许可。

客户端库是 Google 地图网络服务的封装容器。使用 Google 地图网络服务时，需遵守 Google Maps Platform 服务条款。

重要提示：这些客户端库不在标准 Google 弃用政策或支持协议的涵盖范围内。

API 密钥和客户端 ID

每项 Google 地图网络服务都需要 API 密钥或客户端 ID。如需了解何时使用 API 密钥、何时使用客户端 ID，以及如何获取 API 密钥或客户端 ID，请参阅您正在使用的 API 对应的身份验证指南：