- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- LocationBias
- LocationRestriction
- Suggerimento
- PlacePrediction
- FormattableText
- StringRange
- StructuredFormat
- QueryPrediction
Restituisce le previsioni per l'input specificato.
Richiesta HTTP
POST https://places.googleapis.com/v1/places:autocomplete
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "input": string, "locationBias": { object ( |
Campi | |
---|---|
input |
Obbligatorio. La stringa di testo in cui cercare. |
location |
(Facoltativo) Spostare i risultati in base a una località specificata. Deve essere impostato al massimo un valore per |
location |
(Facoltativo) Limita i risultati a una località specificata. Deve essere impostato al massimo un valore per |
included |
(Facoltativo) Tipo di luogo principale incluso (ad es. "restaurant" o "gas_station") nei tipi di luogo (https://developers.google.com/maps/documentation/places/web-service/place-types) oppure solo |
included |
(Facoltativo) Includi solo i risultati nelle regioni specificate, specificate come massimo 15 codici regione CLDR di due caratteri. Un insieme vuoto non limita i risultati. Se sono impostati sia |
language |
(Facoltativo) La lingua in cui restituire i risultati. Il valore predefinito è en-US. I risultati possono essere in lingue miste se la lingua utilizzata in |
region |
(Facoltativo) Il codice regione, specificato come codice regione CLDR a due caratteri. Ciò influisce sulla formattazione degli indirizzi, sul ranking dei risultati e può influire sui risultati restituiti. Ciò non limita i risultati alla regione specificata. Per limitare i risultati a una regione, utilizza |
origin |
(Facoltativo) Il punto di partenza da cui calcolare la distanza geodetica alla destinazione (restituito come |
input |
(Facoltativo) Un offset di caratteri Unicode basato su zero di Se è vuoto, il valore predefinito è |
include |
(Facoltativo) Se true, la risposta includerà sia le previsioni di luoghi che quelle di query. In caso contrario, la risposta restituirà solo le previsioni dei luoghi. |
session |
(Facoltativo) Una stringa che identifica una sessione Autocomplete a fini di fatturazione. Deve essere una stringa base64 sicura per URL e nomi file con una lunghezza massima di 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT. La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Dettagli dei luoghi o Convalida indirizzo. Ogni sessione può avere più query, seguite da una richiesta di dettagli sui luoghi o di convalida dell'indirizzo. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Al termine di una sessione, il token non è più valido; l'app deve generare un nuovo token per ogni sessione. Se il parametro Ti consigliamo di seguire le seguenti linee guida:
|
include |
(Facoltativo) Includi le attività al domicilio del cliente se il campo è impostato su true. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività non hanno un indirizzo fisico o una sede su Google Maps. Per queste attività, Places non restituirà campi tra cui |
Corpo della risposta
Protocollo di risposta per places.autocomplete.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"suggestions": [
{
object ( |
Campi | |
---|---|
suggestions[] |
Contiene un elenco di suggerimenti, ordinati in ordine decrescente di pertinenza. |
LocationBias
La regione in cui cercare. I risultati potrebbero essere parziali per la regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
rectangle |
Un viewport definito da un angolo nord-est e da un angolo sud-ovest. |
circle |
Un cerchio definito da un punto centrale e un raggio. |
LocationRestriction
La regione in cui cercare. I risultati saranno limitati alla regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
rectangle |
Un viewport definito da un angolo nord-est e da un angolo sud-ovest. |
circle |
Un cerchio definito da un punto centrale e un raggio. |
Suggerimento
Un risultato del suggerimento di completamento automatico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
place |
Una previsione per un luogo. |
query |
Una previsione per una query. |
PlacePrediction
Risultati della previsione per una previsione di completamento automatico dei luoghi.
Rappresentazione JSON |
---|
{ "place": string, "placeId": string, "text": { object ( |
Campi | |
---|---|
place |
Il nome della risorsa del luogo suggerito. Questo nome può essere utilizzato in altre API che accettano nomi di luoghi. |
place |
L'identificatore univoco del luogo suggerito. Questo identificatore può essere utilizzato in altre API che accettano ID luogo. |
text |
Contiene il nome leggibile del risultato restituito. Per i risultati relativi a un'attività, in genere si tratta del nome e dell'indirizzo dell'attività.
Questo testo potrebbe essere diverso da Può essere in lingue miste se le richieste |
structured |
Un'analisi della previsione del luogo in un testo principale contenente il nome del luogo e un testo secondario contenente ulteriori elementi di disambiguazione (ad esempio una città o una regione).
|
types[] |
Elenco dei tipi che si applicano a questo luogo dalla Tabella A o dalla Tabella B in https://developers.google.com/maps/documentation/places/web-service/place-types. Un tipo è una classificazione di un luogo. I luoghi con tipi condivisi avranno caratteristiche simili. |
distance |
La lunghezza della geodetica in metri da |
FormattableText
Testo che rappresenta una previsione di una località o di una query. Il testo può essere utilizzato così com'è o formattato.
Rappresentazione JSON |
---|
{
"text": string,
"matches": [
{
object ( |
Campi | |
---|---|
text |
Testo che può essere utilizzato così com'è o formattato con |
matches[] |
Un elenco di intervalli di stringhe che identificano la posizione in cui la richiesta di input corrisponde a Questi valori sono gli offset dei caratteri Unicode di |
StringRange
Identifica una sottostringa all'interno di un determinato testo.
Rappresentazione JSON |
---|
{ "startOffset": integer, "endOffset": integer } |
Campi | |
---|---|
start |
Offset a partire da zero del primo carattere Unicode della stringa (incluso). |
end |
Offset basato su zero dell'ultimo carattere Unicode (esclusivo). |
StructuredFormat
Contiene una suddivisione della previsione di un luogo o di una query in testo principale e testo secondario.
Per le previsioni dei luoghi, il testo principale contiene il nome specifico del luogo. Per le previsioni delle query, il testo principale contiene la query.
Il testo secondario contiene ulteriori elementi di disambiguazione (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query.
Rappresentazione JSON |
---|
{ "mainText": { object ( |
Campi | |
---|---|
main |
Rappresenta il nome del luogo o della query. |
secondary |
Rappresenta elementi aggiuntivi per distinguere (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query. |
QueryPrediction
Risultati di previsione per una previsione di completamento automatico della query.
Rappresentazione JSON |
---|
{ "text": { object ( |
Campi | |
---|---|
text |
Il testo previsto. Questo testo non rappresenta un luogo, ma una query di testo che potrebbe essere utilizzata in un endpoint di ricerca (ad esempio Ricerca di testo).
Può essere in lingue miste se la richiesta |
structured |
Un'analisi dettagliata della previsione della query in un testo principale contenente la query e un testo secondario contenente ulteriori elementi di disambiguazione (ad esempio una città o una regione).
|