此页面由 Cloud Translation API 翻译。

将路线摘要与沿路线搜索结合使用

您可以将路线摘要计算与沿路线搜索结合使用。在这种情况下，文本搜索（新）会在响应中返回到每个地点的旅行时长和距离，然后返回从每个地点到路线最终目的地的距离。

如需使用文本搜索（新版）计算路线摘要以及沿路线搜索，请执行以下操作：

使用 Routes API 计算路线，并在响应中返回路线多段线。
使用 searchAlongRouteParameters.polyline.encodedPolyline 参数将路线多段线传递给文本搜索（新）功能，以便将搜索结果偏向于路线。然后，响应中会包含与搜索条件匹配且位于指定路线附近的地点。
在字段掩码中添加 routingSummaries，以便响应包含 routingSummaries 数组。此数组包含从路线起点到响应中每个地点的用时和距离。

注意：如果在字段掩码中添加 routingSummaries，但未在请求中添加 routingParameters.origin 参数或 searchAlongRouteParameters.polyline.encodedPolyline 参数，则会导致错误。

借助 API Explorer，您可以发出实时请求，以便熟悉 API 和 API 选项：

默认情况下，“文本搜索（新）”会沿整个路线执行搜索：

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "searchAlongRouteParameters": {
    "polyline": {
      "encodedPolyline": "ROUTE_POLYLINE"
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

响应包含两个数组：包含匹配地点的 places 数组，以及包含前往每个地点所需时间和距离的 routingSummaries 数组：

{
  "places": [
    {
      "formattedAddress": "1199 El Camino Real, San Bruno, CA 94066, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Vegan Mob - Vegan BBQ and Soul Food",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "839 Kearny St, San Francisco, CA 94108, USA",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Enjoy Vegetarian",
        "languageCode": "en"
      }
    },
   …
],
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "285s",
          "distanceMeters": 1616
        },
        {
          "duration": "2466s",
          "distanceMeters": 58147
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808f87f9ede375f5:0xa37171fea1a16b28!1m0!3e0"
    },
    {
      "legs": [
        {
          "duration": "696s",
          "distanceMeters": 4704
        },
        {
          "duration": "2787s",
          "distanceMeters": 58901
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808580f4cebdb06f:0xd3af09e5742234f2!1m0!3e0"
    },
   …
  ]
}

对于 legs 数组中的每个条目，文本搜索（新）都会返回两段式行程时间：

第 1 段包含从起点到地点的旅行时长和距离。在此示例中，从起点到结果中第一名之间的时长和距离分别为 285 秒和 1616 米。
第二段包含从相应地点到路线目的地的行程时长和距离。在此示例中，时长和距离分别为 2466 秒和 58147 米。

注意： 此响应还会在每个地点的路线摘要中包含“预览版（GA 版之前）”directionsUri 字段。此字段包含一个链接，用于在 Google 地图中打开前往相应地点的路线。多段线起点或 routingParameters.origin 参数指定路线起点，多段线目的地指定路线目的地，出行方式为驾车。路线从起点开始，经过作为航点的地点，并在路线目的地结束。

指定路由起点、出行方式和路线修饰符

您可以通过指定路线起点、出行方式、路线修饰符和路线偏好设置来修改搜索和路线摘要计算方式。如指定出行方式主题中所示，在计算路线摘要时，不指定路线时，行程模式和路线修饰符的运作方式相同。

默认情况下，每个结果的第一段包含多段线所定义的起点到每个地点的距离。不过，您可以通过在请求中明确指定路由来源来替换该默认值。如果指定，则所有响应的第一个路段都会指定相对于指定路线起点的距离和用时，从而替换多段线起点。

在下例中，您将路线起点指定为加利福尼亚州圣马特奥的坐标，指定避开收费站，并将结果数量设置为 5：

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "maxResultCount": 5,
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      },
      "travelMode":"DRIVE",
      "routeModifiers": {
        "avoidTolls": true
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
  'https://places.googleapis.com/v1/places:searchText'

下图显示了一张地图，其中包含路线多段线、新起点（浅蓝色图钉）和搜索结果中的地点（绿色图钉）。请注意，所有结果都位于相应路线上，但都位于 San Mateo 之后：

计算路由摘要