Method: searchAlongRoute

Cercare luoghi lungo un percorso di viaggio.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "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.
}
Campi
textQuery

string

Obbligatorio. Query di ricerca in linguaggio naturale (ad es. "caricabatterie EV", "caffè").
languageCode

string

Facoltativo. La lingua per il riepilogo e i dettagli del luogo. Il valore predefinito è "en-US".
regionCode

string

Facoltativo. Codice paese/regione (CLDR) della località (ad es. "US").
routingPreference

enum (RoutingPreference)

Facoltativo. Preferenza di routing facoltativa che specifica come vengono utilizzati i dati sul traffico. Il valore predefinito è TRAFFIC_UNAWARE.
includeExtendedDetails

boolean

Facoltativo. Include i Place Details estesi nella risposta.

Imposta questo campo su true quando la richiesta dell'utente richiede insight qualitativi dettagliati, dinamiche in tempo reale o attributi di entità specializzati: - Recensioni qualitative, sentiment dei clienti e feedback. - Offerte specifiche come voci di menu, piatti, specialità gastronomiche, bevande o caratteristiche dell'attività. - Atmosfera, arredamento interno, estetica, ambiente o mood qualitativi. - Dati in tempo reale e specifiche delle strutture specializzate, norme/suggerimenti per i visitatori, tempi di attesa.

Lascia false (valore predefinito) per le ricerche di scoperta standard (ad es. tipi di cucina, tipi di negozio), ricerche di località/indirizzi, dati di contatto, orari di apertura e metadati/servizi standard.

L'attivazione di questo campo potrebbe comportare una latenza maggiore.
travelMode

enum (RouteTravelMode)

Facoltativo. Specifica la modalità di viaggio utilizzata per calcolare il percorso e le deviazioni. Il valore predefinito è DRIVE. WALK e BICYCLE sono supportati solo con routeEndpoints. TRANSIT non è supportato.
Specifica del percorso: un percorso esistente, un token del percorso o gli endpoint di origine/destinazione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
encodedPolyline

string

Una stringa di polilinea codificata che rappresenta il percorso. Consulta https://developers.google.com/maps/documentation/utilities/polylinealgorithm
retrievalToken

string

Un token di recupero restituito da una chiamata v1alpha.computeRoutes precedente che rappresenta il percorso.
routeEndpoints

object (RouteEndpoints)

Endpoint espliciti del percorso (origine e destinazione).
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di SearchAlongRouteResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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