- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- LocationBias
- LocationRestriction
- Suggerimento
- PlacePrediction
- FormattableText
- StringRange
- StructuredFormat
- QueryPrediction
Restituisce 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 eseguire la ricerca. |
locationBias |
(Facoltativo) Indirizza i risultati verso una località specificata. Deve essere impostato al massimo un valore tra |
locationRestriction |
(Facoltativo) Limita i risultati a una località specificata. Deve essere impostato al massimo un valore tra |
includedPrimaryTypes[] |
(Facoltativo) Tipo di luogo principale incluso (ad esempio "ristorante" o "gas_station") della Tabella A o della Tabella B nei tipi di luogo (https://developers.google.com/maps/documentation/places/web-service/place-types), solo (regioni) o solo (città). Un luogo viene restituito solo se il suo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non viene specificato alcun tipo, vengono restituiti tutti i tipi di luogo. |
includedRegionCodes[] |
(Facoltativo) Includi i risultati solo nelle regioni specificate, specificate fino a un massimo di 15 codici regione a due caratteri CLDR. Un set vuoto non limiterà i risultati. Se sono impostati sia |
languageCode |
(Facoltativo) La lingua in cui restituire i risultati. Il valore predefinito è en-US. I risultati potrebbero essere in lingue diverse se la lingua utilizzata in |
regionCode |
(Facoltativo) Il codice regione, specificato come codice regione a due caratteri CLDR. Ciò influisce sulla formattazione degli indirizzi e sul ranking dei risultati e potrebbe influire sui risultati restituiti. I risultati non vengono limitati 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 |
inputOffset |
(Facoltativo) Un offset del carattere Unicode in base zero di Se vuoto, il valore predefinito è la lunghezza di |
includeQueryPredictions |
(Facoltativo) Se il valore è true, la risposta includerà le previsioni sia di Place sia di query. In caso contrario, la risposta restituirà solo previsioni sui luoghi. |
sessionToken |
(Facoltativo) Una stringa che identifica una sessione di completamento automatico ai fini della 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 Place Details o Address Validation. Ogni sessione può avere più query, seguite da una richiesta Place Details o Address Validation. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Una volta terminata la sessione, il token non è più valido. la tua app deve generare un nuovo token per ogni sessione. Se il parametro Consigliamo di attenerti alle seguenti linee guida:
|
Corpo della risposta
Protocollo 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, in ordine decrescente di pertinenza. |
LocationBias
La regione in cui eseguire la ricerca. I risultati potrebbero essere distorti rispetto alla regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
rectangle |
Una visualizzazione definita da un angolo nord-est e un angolo sud-ovest. |
circle |
Un cerchio definito da un centro e da un raggio. |
LocationRestriction
La regione in cui eseguire la ricerca. I risultati saranno limitati alla regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
rectangle |
Una visualizzazione definita da un angolo nord-est e un angolo sud-ovest. |
circle |
Un cerchio definito da un centro e da un raggio. |
Suggerimento
Un risultato di suggerimento di completamento automatico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
placePrediction |
Una previsione per un luogo. |
queryPrediction |
Una previsione per una query. |
PlacePrediction
Risultati della previsione per una previsione di Place Autocomplete.
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 i nomi dei luoghi. |
placeId |
L'identificatore univoco del luogo suggerito. Questo identificatore può essere utilizzato in altre API che accettano gli ID luogo. |
text |
Contiene il nome leggibile per il risultato restituito. Per i risultati relativi alle attività, generalmente si tratta del nome e dell'indirizzo dell'attività. L'istruzione Questo testo potrebbe essere diverso da Potrebbero essere in lingue diverse se le richieste |
structuredFormat |
Una suddivisione della previsione relativa a un luogo in testo principale contenente il nome del luogo e testo secondario contenente altri elementi di disambiguazione (ad esempio una città o una regione). L'istruzione |
types[] |
Elenco dei tipi applicabili a questo luogo dalla Tabella A o dalla Tabella B in https://developers.google.com/maps/documentation/places/web-service/place-types. Un tipo è la categorizzazione di un luogo. I luoghi con tipi condivisi avranno caratteristiche simili. |
distanceMeters |
La lunghezza della geodetica in metri da |
FormattableText
Testo che rappresenta una previsione di un luogo 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 il punto in cui la richiesta di input ha trovato una corrispondenza in Questi valori sono offset di caratteri Unicode di |
StringRange
Identifica una sottostringa all'interno di un determinato testo.
Rappresentazione JSON |
---|
{ "startOffset": integer, "endOffset": integer } |
Campi | |
---|---|
startOffset |
Offset su base zero del primo carattere Unicode della stringa (incluso). |
endOffset |
Offset su base zero dell'ultimo carattere Unicode (escluso). |
StructuredFormat
Contiene una suddivisione di una previsione relativa a luoghi o query in testo principale e testo secondario.
Per le previsioni di 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 altre caratteristiche di disambiguazione (come una città o una regione) per identificare ulteriormente il luogo o perfezionare la query.
Rappresentazione JSON |
---|
{ "mainText": { object ( |
Campi | |
---|---|
mainText |
Rappresenta il nome del luogo o della query. |
secondaryText |
Rappresenta altre caratteristiche di disambiguazione (come una città o una regione) per identificare ulteriormente il luogo o perfezionare la query. |
QueryPrediction
Risultati di una previsione di completamento automatico di 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 testuale). L'istruzione Potrebbero essere in lingue diverse se le richieste |
structuredFormat |
Un'analisi della previsione della query in testo principale contenente la query e testo secondario contenente ulteriori caratteristiche di disambiguazione (ad esempio una città o una regione). L'istruzione |