- 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 |
Campo facoltativo. Risultati con bias per una località specificata. Deve essere impostato al massimo un valore tra |
locationRestriction |
Campo facoltativo. Limita i risultati a una località specificata. Deve essere impostato al massimo un valore tra |
includedPrimaryTypes[] |
Campo facoltativo. Tipo di luogo principale incluso (ad esempio, "ristorante" o "gas_station") da https://developers.google.com/maps/documentation/places/web-service/place-types. Un luogo viene restituito solo se il suo tipo principale è incluso nell'elenco. È possibile specificare fino a 5 valori. Se non viene specificato alcun tipo, vengono restituiti tutti i tipi di luogo. |
includedRegionCodes[] |
Campo facoltativo. Includi solo i risultati nelle regioni specificate, specificate con un massimo di 15 codici regione a due caratteri CLDR. Un set vuoto non limiterà i risultati. Se |
languageCode |
Campo facoltativo. La lingua in cui restituire i risultati. Il valore predefinito è en-US. I risultati possono essere in lingue miste se la lingua usata in |
regionCode |
Campo facoltativo. Il codice regione specificato come codice regione a due caratteri CLDR. Questo influisce sulla formattazione dell'indirizzo, sul ranking dei risultati e può influenzare i risultati restituiti. I risultati non vengono limitati alla regione specificata. Per limitare i risultati a una regione, utilizza |
origin |
Campo facoltativo. Il punto di origine da cui calcolare la distanza geodetica dalla destinazione (restituito come |
inputOffset |
Campo facoltativo. Un offset di caratteri Unicode in base zero di Se vuoto, il valore predefinito è |
includeQueryPredictions |
Campo facoltativo. Se true, la risposta includerà sia le previsioni di luogo sia quelle delle query. In caso contrario, la risposta restituirà solo previsioni Place. |
sessionToken |
Campo facoltativo. Una stringa che identifica una sessione di completamento automatico ai fini della fatturazione. Deve essere una stringa Base64 sicura per URL e nome file con al massimo 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT. La sessione inizia quando l'utente inizia a digitare una query e si conclude quando seleziona un luogo e viene effettuata una chiamata a Place Details o Address Validation. Ogni sessione può includere più query, seguite da una richiesta Dettagli luogo o Convalida 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 token nuovo per ogni sessione. Se il parametro Consigliamo le seguenti linee guida:
|
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 in ordine decrescente in base alla pertinenza. |
LocationBias
La regione in cui cercare. I risultati potrebbero essere influenzati dalla regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione
|
|
rectangle |
Un'area visibile definita 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 verranno limitati alla regione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione
|
|
rectangle |
Un'area visibile definita da un angolo nord-est e da un angolo sud-ovest. |
circle |
Un cerchio definito da un punto centrale e un raggio. |
Suggerimento
Risultato del suggerimento di completamento automatico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di 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 all'attività, di solito si tratta del nome e dell'indirizzo dell'attività. L'app Questo testo potrebbe essere diverso dal valore Può essere disponibile in lingue miste se le richieste |
structuredFormat |
Un'analisi della previsione di Place nel testo principale contenente il nome del luogo e un testo secondario contenente ulteriori elementi distintivi (come una città o una regione). L'app |
types[] |
Elenco dei tipi applicabili a questo luogo dalla tabella A o dalla tabella B alla pagina https://developers.google.com/maps/documentation/places/web-service/place-types. Un tipo è una 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 luogo o 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 i punti in cui la richiesta di input corrisponde 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 in base zero del primo carattere Unicode della stringa (incluso). |
endOffset |
Offset in base zero dell'ultimo carattere Unicode (escluso). |
StructuredFormat
Contiene una suddivisione di un luogo o di una previsione di 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 che chiariscono la tua ambiguità (ad esempio 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 ulteriori elementi distintivi (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query. |
QueryPrediction
Risultati della previsione per una previsione di completamento automatico delle 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'app Può essere disponibile in lingue miste se le richieste |
structuredFormat |
Un'analisi della previsione della query in testo principale contenente la query e testo secondario contenente ulteriori elementi di disambiguazione (ad esempio una città o una regione). L'app |