Directions API 概览

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 中找到安装说明和示例代码。

后续步骤