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

欧洲经济区 (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，以便创建航点，实现精确路线规划。Navigation 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 创建航点，以便将司机引导至正确的上车点。

深入阅读