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

欧洲经济区 (EEA) 开发者

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

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

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

如需创建和传递导航点令牌，请使用 Geocoding API 的 Destinations 端点，以便用户从导航点列表中选择首选位置。 用户的选择会成为 Geocoding API 的 Destinations 端点返回的导航点。然后，您可以将包含目的地坐标和情境信息的导航点令牌传递给 Navigation SDK for Android，以便创建用于精确路线规划的途经点。导航 SDK 会根据令牌关联的地点，为司机突出显示目的地。

导航点令牌的创建方式以及如何将其发送到导航 SDK 以进行路线规划

例如，假设有一个网约车用例，其中包含一个供消费者预订行程的应用，以及一个供司机接收行程通知和前往目的地路线信息的应用。

当消费者打开消费者应用时，该应用会调用 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
      }
      }
    }
]

响应中的导航点令牌会传递给使用 Navigation SDK for Android 的移动版司机应用，以创建Waypoint，从而引导司机前往正确的上车点。