为什么要使用 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、地址或纬度/经度坐标的形式提供出发地和目的地。如需了解详情,请参阅必需参数。 |
详细路线,细分为路线、路段和路段。如需了解详情,请参阅路线响应。 |
|
如何使用 Directions API
1 | 开始设置。 | 从设置您的 Google Cloud 项目开始,并按照随后显示的设置说明完成设置。 |
2 | 试用演示版 | 拥有 API 密钥和云项目后,您可以免费试用路线演示。请参阅 Directions API 演示。 |
3 | 构建请求 | 查看示例请求,了解您可以提供的选项,例如出行方式、航点和路线限制。请参阅路线示例。 |
4 | 了解响应基础知识 | 探索数据响应,准备为应用使用路线数据。如需了解详情,请参阅路线响应。 |
5 | 将路线数据整合到您自己的应用中! | 您可以使用此数据计算行程距离和时间。 |
可用的客户端库
通过以下某个客户端库,以您选择的语言调用此 API:
- 适用于 Google 地图服务的 Java 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开源。您可以从 GitHub 下载它们,您还可以在 GitHub 上找到安装说明和示例代码。
后续步骤
- 开始使用 Directions API:转到开始使用。
- 开始发出路线请求:转到查询路线。
- 遵循最佳实践:前往 Web 服务最佳实践。