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