Directions API 概览

Directions API 是一项服务,可接受 HTTP 请求并返回 不同位置之间的 JSON 或 XML 格式方向。

为何使用 Directions API

利用 Google Directions API,您可以获取不同路线的 例如公共交通、驾车、步行或骑车。

Directions API 有哪些用途?

借助 Directions API,您可以计算不同地点之间的路线, 包括以下详细信息:

  • 包括公交、驾车、 例如步行或骑车
  • 使用一系列路径点返回多段式路线。
  • 您可以通过多种方式指定起点、目的地和路径点,包括文本字符串(例如“伊利诺伊州芝加哥市”或“澳大利亚新南威尔士州达尔文市”)、地点 ID 或纬度/经度坐标。

Directions API 的工作原理

在以下情况下,Google 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 上找到安装说明和示例代码。

后续步骤