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

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

为何要使用客户端库？

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

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

  • 自动速率限制：默认情况下，按照各网络服务的预期速率限制发送请求。您可以通过 new GeoApiContext().setQueryRateLimit(qpm) 提供自定义每分钟查询次数 (QPM) 限制。
  • 失败时重试：当 API 发送 500 级错误时，自动重试任何请求，并使用指数退避算法来帮助处理间歇性故障。
  • 简单的身份验证：让您可以使用 API 密钥进行身份验证，或者让 Google Maps Platform 专业版方案客户可以使用客户端 ID 和密钥进行身份验证。
  • 普通的旧 Java 对象 (POJO)：针对 Java 库中的每个 API 响应返回类型化 Java 对象，而 Python 库则直接从 API 返回响应结构。
  • 异步或同步调用：支持对所有请求使用同步和异步调用样式。

条款及条件

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

客户端库是 Google 地图网络服务的封装容器，这些服务受 Google Maps Platform 服务条款约束。

API 密钥和客户端 ID

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