Method: searchText

Cerca luoghi con una query di testo.

Richiesta HTTP

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

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,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Campi
textQuery

string

Obbligatorio. La query di testo.
languageCode

string

Facoltativo. La lingua in cui richiedere la restituzione del riepilogo. Se il codice lingua non è specificato o non viene riconosciuto, verrà restituito il riepilogo con una preferenza per l'inglese.

Ad esempio, "en" per l'inglese.

Elenco attuale delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Facoltativo. Il codice paese/regione Unicode (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i Place Details, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente.

Ad esempio, "US" per gli Stati Uniti.

Per saperne di più, visita la pagina https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Tieni presente che i codici regione a 3 cifre non sono attualmente supportati.
pageSize

integer

Facoltativo. Il numero massimo di luoghi da restituire, fino a 10. Il servizio potrebbe restituire un numero inferiore a questo valore. Il valore predefinito è 5.

La richiesta di più di 5 luoghi attiverà il livello Pro e comporterà costi di fatturazione e latenza più elevati.
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'abilitazione di questo campo attiverà il livello Pro e comporterà costi di fatturazione più elevati e una latenza maggiore.
locationBias

object (LocationBias)

Una regione facoltativa per influenzare i risultati di ricerca. Se in textQuery è presente una località esplicita, verrà utilizzata per influenzare i risultati di ricerca anziché questo campo.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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