Method: searchAlongRoute

Nach Orten entlang einer Reiseroute suchen

HTTP-Anfrage

POST https://mapstools.googleapis.com/v1:searchAlongRoute

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
Felder
textQuery

string

Erforderlich. Suchanfrage in natürlicher Sprache (z.B. „Ladestationen für Elektrofahrzeuge“, „Kaffee“).
languageCode

string

Optional. Die Sprache für die Zusammenfassung und die Ortsdetails. Der Standardwert ist „en-US“.
regionCode

string

Optional. Länder-/Regionscode (CLDR) des Standorts (z.B. „US“).
routingPreference

enum (RoutingPreference)

Optional. Optionale Routing-Einstellung, die angibt, wie Verkehrsdaten verwendet werden. Die Standardeinstellung ist TRAFFIC_UNAWARE.
includeExtendedDetails

boolean

Optional. Enthält erweiterte Ortsdetails in der Antwort.

Setzen Sie dieses Feld auf true, wenn die Nutzeranfrage umfassende qualitative Informationen, Echtzeitdynamik oder spezielle Entitätsattribute erfordert: - Qualitative Rezensionen, Kundenstimmung und Feedback. - Spezifische Angebote wie Menüpunkte, Gerichte, Spezialitäten, Getränke oder Highlights des Unternehmens. – Qualitative Atmosphäre, Inneneinrichtung, Ästhetik, Ambiente oder Stimmung. - Echtzeitdaten und spezielle Informationen zu Einrichtungen, Besucherrichtlinien/-tipps, Wartezeiten.

Lassen Sie false (Standard) für Standardsuchen (z.B. Küchen, Geschäftstypen), Standort-/Adresssuchen, Kontaktdaten, Öffnungszeiten und Standardmetadaten/-ausstattung stehen.

Das Aktivieren dieses Felds kann zu einer höheren Latenz führen.
travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an, die zur Berechnung der Route und der Umwege verwendet wird. Die Standardeinstellung ist DRIVE. WALK und BICYCLE werden nur mit routeEndpoints unterstützt. TRANSIT wird nicht unterstützt.
Routenspezifikation: entweder eine vorhandene Route, ein Routentoken oder Start- und Zielendpunkte. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
encodedPolyline

string

Ein codierter Polylinien-String, der die Route darstellt. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
retrievalToken

string

Ein Abruftoken, das von einem vorherigen v1.computeRoutes-Aufruf zurückgegeben wurde und die Route darstellt.
routeEndpoints

object (RouteEndpoints)

Explizite Routenendpunkte (Start und Ziel)
Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SearchAlongRouteResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/maps-platform.mapstools