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

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

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

1. 使用 Routes API 计算路线，并在响应中返回路线多段线。

2. 使用 searchAlongRouteParameters.polyline.encodedPolyline 参数将路线多段线传递给文本搜索（新）功能，以便将搜索结果偏向于路线。然后，响应中会包含与搜索条件匹配且位于指定路线附近的地点。

3. 在字段掩码中添加 routingSummaries，以便响应包含 routingSummaries 数组。此数组包含从路线起点到响应中每个地点的用时和距离。

借助 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 米。

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

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

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

在下例中，您将路线起点指定为加利福尼亚州圣马特奥的坐标，指定避开收费站，并将结果数量设置为 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 之后：