Directions API（旧版）概览

欧洲经济区 (EEA) 开发者

Directions API（旧版）是一项服务，可接受 HTTP 请求，并返回 JSON 或 XML 格式的地点间路线。

为什么要使用 Directions API（旧版）

借助 Directions API（旧版），您可以获取多种交通方式（如公交、驾车、步行或骑车）的路线。

您可以使用 Directions API（旧版）做什么？

借助 Directions API（旧版），您可以计算地点间的路线，包括以下详细信息：

  • 多种交通方式（包括公交、驾车、步行或骑车）的路线。
  • 使用一系列航点的多段式路线。
  • 以多种方式指定出发地、目的地和航点，包括文本字符串（例如“伊利诺伊州芝加哥市”或“澳大利亚北领地达尔文市”）、地点 ID 或纬度/经度坐标。

Directions API（旧版）的工作原理

Directions API（旧版）在计算路线时会返回最高效的路线。该产品在确定最高效的路线时会考虑以下行程要素：

  • 行程时间（主要）
  • 距离
  • 转弯次数

以下示例请求会返回从安大略省多伦多到魁北克省蒙特利尔的行车路线，格式为 JSON：

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

资源

下表总结了可通过 Directions API（旧版）获得的资源以及返回的数据。

数据资源 返回的数据 返回格式
路线

以地点 ID、地址、 或纬度/经度坐标的形式提供出发地和目的地。如需了解详情，请参阅必需参数 。

详细路线，分为路线、路段和步骤。如需了解详情，请参阅 路线响应。
  • JSON
  • XML

如何使用 Directions API（旧版）

1 进行设置。 首先，请按照设置 Google Cloud 项目中的说明进行操作，然后完成后续设置说明。
2 试用演示版 获得 API 密钥和云项目后，您可以免费试用路线演示。请参阅 Directions API（旧版）演示。
3 构建请求 查看示例请求，了解您可以提供的可用 选项，例如交通方式、航点和 路线限制。请参阅路线示例。
4 了解响应基础知识 探索数据响应，为在应用中使用路线数据做好准备。如需了解详情，请参阅 路线响应 。
5 将路线数据整合到您自己的应用中！ 您可以使用此数据计算行程距离和时间。

可用的客户端库

您可以通过以下任一客户端库，以您选择的语言调用此 API：

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

后续步骤