获取备选路线

欧洲经济区 (EEA) 开发者

默认情况下，Routes API 会返回默认路线，该路线通常是从起点到目的地的最快路线。当您请求备选路线时，该 API 最多会返回三条路线以及默认路线。然后，您的客户可以选择最符合其要求的路线。

请求备选路线时的注意事项

如需请求备选路线，请注意以下事项：

响应最多包含三条备选路线。不过，有时没有备选路线，因此响应仅包含默认路线。
由于计算备选路线需要额外的处理，因此请求备选路线可能会增加 API 的响应时间。

备选路线请求示例

将 computeAlternativeRoutes 设置为 true 以请求备选路线。以下示例展示了如何在 computeRoutes 方法 (REST) 请求中请求备选路线。

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

在此示例中，您指定了一个字段掩码，以便响应仅包含每条路线的 duration、distanceMeters, 和 routeLabels 属性。然后，您的客户可以使用该信息来选择要走的路线。如需了解更多信息，请参阅选择要返回的信息。

备选路线响应示例

在响应中，使用 routeLabels 数组属性来标识每条路线：

对于默认路线，routeLabels 属性包含 DEFAULT_ROUTE。
对于任何备选路线，routeLabels 属性包含 DEFAULT_ROUTE_ALTERNATE。

在此示例中，响应包含默认路线和两条备选路线。请注意，每条路线的 duration 和 distanceMeters 属性的值不同：

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

在响应中添加路线

为了方便用户选择路线，请将每条路线的多段线添加到响应中。然后，您可以在地图上显示每条多段线。

如需添加多段线，请在字段掩码中添加 routes.polyline：

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

然后，响应将包含每条路线的多段线：

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}