使用导航点令牌进行路线规划

欧洲经济区 (EEA) 开发者

借助导航点令牌，您可以向 Navigation SDK for Android、Navigation SDK for iOS 或 Routes API 发送有关目的地的关键情境信息，从而改进路线规划和司机体验。 这在食品配送或网约车等情况下非常有用，因为如果没有用户输入，取货或送货点可能会不明确。

如需创建并传递导航点令牌，请使用 Geocoding API 的 Destinations 方法，以便用户从导航点列表中选择首选位置。 用户的选择会成为 Geocoding API 的 Destinations 方法返回的导航点。

然后，您可以将包含目的地坐标和上下文信息的导航点令牌传递给 Navigation SDK for Android、Navigation SDK for iOS 或 Routes API，以便创建用于精确路线规划的航点。导航 SDK 会根据令牌关联的地点，为司机突出显示目的地。

示例：网约车使用情形

概览

此示例展示了如何结合使用 Geocoding API、Routes API 以及 Navigation SDK for iOS 或 Android 来创建网约车应用，该应用可计算路线价格并引导司机前往正确的上车点。

以下是大致步骤：

  1. 通过 Geocoding API 检索导航点令牌。
  2. 使用 Routes API 计算路线并将其编码为路线令牌。
  3. 将导航点令牌和路线令牌都传递给 Navigation SDK。
  4. 使用 Navigation SDK 将司机引导至正确的上车点。

如需获取相关 Routes API、Navigation SDK for iOS 和 Navigation SDK for Android 文档的链接，请参阅延伸阅读部分。

此图显示了网约车或送餐应用如何使用 Geocoding API、Routes API 和 Navigation SDK for iOS 或 Android，通过路线令牌和导航点令牌为司机规划路线：

“网约车或送货”使用场景图示
网约车或送货使用场景示意图

网约车示例

假设有这样一个网约车场景：消费者使用一个应用预订行程，而司机使用第二个应用接收行程通知和前往目的地的路线信息。

此图片显示了以下示例：消费者网约车应用（其中选择了导航点）和使用 Navigation SDK for Android 精确规划司机路线的司机应用。

消费者应用和司机应用示例

当消费者打开消费者应用时，该应用会调用 Geocoding API 的 Destinations 方法，并向消费者提供一系列潜在的导航点供其选择：

消费者选择送达点

用户选择其首选点，该点是 SearchDestinations 请求的响应正文中 navigationPoints 数组中的一个点：

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

应用后端向 Routes API 提供导航点令牌，以计算路线并检索路线令牌。

最后，导航点令牌和路线令牌都会传递给使用 Navigation SDK for iOS 或 Android 的移动版司机应用，以创建航点，从而将司机引导至正确的上车点。

深入阅读