Questa pagina è stata tradotta dall'API Cloud Translation.

Completamento automatico (novità)

Seleziona la piattaforma: Android iOS JavaScript Web Service

Il servizio Autocompletamento (nuovo) è un servizio web che restituisce le previsioni relative ai luoghi e alle query in risposta a una richiesta HTTP. Nella richiesta, specifica una stringa di ricerca di testo e i limiti geografici che controllano l'area di ricerca.

Il servizio di completamento automatico (nuovo) può trovare corrispondenze per parole intere e sottostringhe dell'input, risolvendo i nomi di luoghi, indirizzi e codici plus. Le applicazioni possono quindi inviare query man mano che l'utente digita per fornire previsioni di query e luoghi in tempo reale.

La risposta dell'API Autocomplete (nuova) può contenere due tipi di previsioni:

Predizioni dei luoghi: luoghi, come attività, indirizzi e punti d'interesse, in base alla stringa di testo inserita e all'area di ricerca specificata. Le previsioni dei luoghi vengono restituite per impostazione predefinita.
Predizioni di query: stringhe di query corrispondenti alla stringa di testo inserita e all'area di ricerca. Le previsioni delle query non vengono restituite per impostazione predefinita. Utilizza il parametro di richiesta includeQueryPredictions per aggiungere le previsioni delle query alla risposta.

Ad esempio, chiami l'API utilizzando come input una stringa che contiene un input parziale dell'utente, "Sicilian piz", con l'area di ricerca limitata a San Francisco, CA. La risposta contiene quindi un elenco di previsioni di luoghi corrispondenti alla stringa di ricerca e all'area di ricerca, ad esempio il ristorante denominato "Sicilian Pizza Kitchen", insieme ai dettagli del luogo.

Le predizioni dei luoghi restituite sono progettate per essere presentate all'utente per aiutarlo a selezionare il luogo desiderato. Puoi effettuare una richiesta Place Details (New) per ottenere ulteriori informazioni su qualsiasi previsione di luogo restituita.

La risposta può anche contenere un elenco di previsioni di query che corrispondono alla stringa di ricerca e all'area di ricerca, ad esempio "Pizza e pasta siciliana". Ogni previsione di query nella risposta include il campo text contenente una stringa di ricerca di testo consigliata. Utilizza questa stringa come input per la ricerca di testo (nuova) per eseguire una ricerca più dettagliata.

L'API Explorer ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le opzioni dell'API:

Prova!

Richieste di completamento automatico (nuove)

Una richiesta di completamento automatico (Nuova) è una richiesta POST HTTP a un URL nel modulo:

https://places.googleapis.com/v1/places:autocomplete

Passa tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta POST. Ad esempio:

curl -X POST -d '{
  "input": "pizza",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

Informazioni sulla risposta

Il completamento automatico (nuovo) restituisce un oggetto JSON come risposta. Nella risposta:

L'array suggestions contiene tutti i luoghi e le query previsti in ordine in base alla loro pertinenza percepita. Ogni luogo è rappresentato da un campo placePrediction e ogni query è rappresentata da un campo queryPrediction.
Un campo placePrediction contiene informazioni dettagliate sulla previsione di un singolo luogo, tra cui l'ID luogo e la descrizione testuale.
Un campo queryPrediction contiene informazioni dettagliate su una singola previsione della query.

Nota: il completamento automatico (nuovo) restituisce cinque previsioni totali, come placePredictions, queryPredictions o una combinazione di entrambi, a seconda della richiesta. Ad esempio, se la richiesta non imposta includeQueryPredictions, il corpo della risposta include fino a cinque placePredictions. Se la richiesta imposta includeQueryPredictions, il corpo della risposta include fino a cinque previsioni in una combinazione di placePredictions e queryPredictions.

L'oggetto JSON completo è nel formato:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }]
        },
      ...
    },
    {
      "queryPrediction": {
        "text": {
          "text": "Amoeba Music",
          "matches": [
            {
              "endOffset": 6
            }]
        },
        ...
    }
  ...]
}

Parametri obbligatori

input

La stringa di testo in cui cercare. Specifica parole e sottostringhe complete, nomi di luoghi, indirizzi e plus code. Il servizio Autocompletamento (nuovo) restituisce le corrispondenze candidate in base a questa stringa e ordina i risultati in base alla loro pertinenza percepita.

Parametri facoltativi

FieldMask

Specifica l'elenco dei campi da restituire nella risposta creando una maschera di campo della risposta. Passa la maschera del campo di risposta al metodo utilizzando l'intestazione HTTP X-Goog-FieldMask.

Specifica un elenco separato da virgole di campi di suggerimenti da restituire. Ad esempio, per recuperare suggestions.placePrediction.place e suggestions.placePrediction.text del suggerimento.
```
  X-Goog-FieldMask: places.displayName,places.formattedAddress
```
Nota: gli spazi non sono consentiti nell'elenco dei campi.

Utilizza * per recuperare tutti i campi.
```
  X-Goog-FieldMask: *
```
Il carattere jolly "*" seleziona tutti i campi.
includedPrimaryTypes

Un luogo può avere un unico tipo principale tra quelli elencati nella Tabella A o nella Tabella B. Ad esempio, il tipo principale potrebbe essere "mexican_restaurant" o "steak_house".

Per impostazione predefinita, l'API restituisce tutti i luoghi in base al parametro input, indipendentemente dall'eventuale valore del tipo principale associato al luogo. Limita i risultati in modo che siano di un determinato tipo o tipo primario passando il parametro includedPrimaryTypes.

Utilizza questo parametro per specificare fino a cinque valori di tipo da Tabella A o Tabella B. Un luogo deve corrispondere a uno dei valori di tipo principale specificati per essere incluso nella risposta.

Questo parametro può includere anche (regions) o (cities). La raccolta di tipi (regions) applica filtri per aree o divisioni, come quartieri e codici postali. La raccolta di tipo (cities) filtra i luoghi identificati da Google come città.

La richiesta viene rifiutata con un errore INVALID_REQUEST se:
- Sono stati specificati più di cinque tipi.
- Qualsiasi tipo è specificato in aggiunta a (cities) o (regions).
- Vengono specificati tipi non riconosciuti.
Nota: il parametro includedPrimaryTypes funziona solo sul tipo principale del luogo, non su tutti i tipi associati al luogo. Sebbene ogni luogo abbia un tipo principale, non tutti i tipi principali sono supportati dall'API Places (nuova). I tipi supportati includono quelli elencati nella Tabella A o nella Tabella B.
includePureServiceAreaBusinesses

Se impostato su true, la risposta include le attività che visitano o consegnano direttamente ai clienti, ma che non hanno una sede fisica. Se impostato su false, l'API restituisce solo le attività con una sede fisica.
includeQueryPredictions

Se true, la risposta include previsioni sia sul luogo sia sulla query. Il valore predefinito è false, il che significa che la risposta include solo le previsioni dei luoghi.
includedRegionCodes

Includi solo i risultati dell'elenco di regioni specificate, specificate come un array di un massimo di 15 ccTLD ("dominio di primo livello") a due caratteri. Se omesso, non vengono applicate limitazioni alla risposta. Ad esempio, per limitare le regioni a Germania e Francia:
```
    "includedRegionCodes": ["de", "fr"]
```
Se specifichi sia locationRestriction che includedRegionCodes, i risultati si trovano nell'area di intersezione delle due impostazioni.
inputOffset

Lo spostamento del carattere Unicode a partire da zero che indica la posizione del cursore in input. La posizione del cursore può influire sulle previsioni restituite. Se è vuoto, viene utilizzata la lunghezza predefinita di input.

Nota: nella versione iniziale dell'anteprima privata, questa proprietà si chiamava predictionTermOffset.
languageCode

La lingua preferita in cui restituire i risultati. I risultati potrebbero essere in lingue miste se la lingua utilizzata in input è diversa dal valore specificato da languageCode o se il luogo restituito non ha una traduzione dalla lingua locale a languageCode.
- Devi utilizzare i codici lingua IETF BCP-47 per specificare la lingua preferita.
- Se languageCode non viene fornito, l'API utilizza il valore specificato nell'Accept-Language. Se non viene specificato nessuno, il valore predefinito è en. Se specifichi un codice lingua non valido, l'API restituisce un INVALID_ARGUMENT errore.
- La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Ciò influisce anche sulla capacità dell'API di correggere gli errori ortografici.
- L'API tenta di fornire un indirizzo stradale che sia leggibile sia per l'utente sia per la popolazione locale, rispecchiando allo stesso tempo l'input dell'utente. Le previsioni dei luoghi vengono formattate in modo diverso a seconda dell'input dell'utente in ogni richiesta.
  - I termini corrispondenti nel parametro input vengono scelti per primi, utilizzando i nomi in linea con la preferenza di lingua indicata dal parametro languageCode, se disponibile, altrimenti utilizzando i nomi che corrispondono meglio all'input dell'utente.
  - Gli indirizzi sono formattati nella lingua locale, in uno script leggibile dall'utente quando possibile, solo dopo che i termini corrispondenti sono stati scelti in modo che corrispondano a quelli nel parametro input.
  - Tutti gli altri indirizzi vengono restituiti nella lingua preferita, dopo che sono stati scelti i termini corrispondenti per i termini nel parametro input. Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più simile.
locationBias o locationRestriction

Puoi specificare locationBias o locationRestriction, ma non entrambi, per definire l'area di ricerca. Considera locationRestriction come la regione in cui devono trovarsi i risultati e locationBias come la regione in cui devono trovarsi i risultati, ma che può essere al di fuori dell'area.

Nota: se ometti sia locationBias sia locationRestriction, l'API utilizza la differenziazione degli IP per impostazione predefinita. Con la distorsione IP, l'API utilizza l'indirizzo IP del dispositivo per distorcere i risultati.
- locationBias
  
  Specifica un'area in cui cercare. Questa località funge da bias, il che significa che possono essere restituiti risultati relativi alla località specificata, inclusi quelli al di fuori dell'area specificata.
- locationRestriction
  
  Specifica un'area in cui cercare. I risultati al di fuori dell'area specificata non vengono restituiti.
Specifica la regione locationBias o locationRestriction come area visibile rettangolare o come cerchio.
- Un cerchio è definito dal punto centrale e dal raggio in metri. Il raggio deve essere compreso tra 0,0 e 50.000,0 inclusi. Il valore predefinito è 0,0. Per locationRestriction, devi impostare il raggio su un valore maggiore di 0,0. In caso contrario, la richiesta non restituisce risultati.
  
  Ad esempio:
```
"locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}
```
- Un rettangolo è un'area visibile di latitudine e longitudine, rappresentata da due punti alti e low opposti diagonalmente. Un viewport è considerato una regione chiusa, il che significa che include il suo confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre quelli di longitudine devono essere compresi tra -180 e 180 gradi inclusi:
  - Se low = high, l'area visibile è composta da quel singolo punto.
  - Se low.longitude > high.longitude, l'intervallo di longitudine viene invertito (l'area visibile supera la linea di longitudine di 180 gradi).
  - Se low.longitude = -180 gradi e high.longitude = 180 gradi, l'area visibile include tutte le longitudini.
  - Se low.longitude = 180 gradi e high.longitude = -180 gradi, l'intervallo di longitudine è vuoto.
  Sia low che high devono essere compilati e la casella rappresentata non può essere vuota. Un viewport vuoto genera un errore.
  
  Ad esempio, questa area visibile racchiude completamente New York City:
```
"locationBias": {
  "rectangle": {
    "low": {
      "latitude": 40.477398,
      "longitude": -74.259087
    },
    "high": {
      "latitude": 40.91618,
      "longitude": -73.70018
    }
  }
}
```
origine

Il punto di partenza da cui calcolare la distanza in linea retta alla destinazione (restituito come distanceMeters). Se questo valore viene omesso, la distanza in linea retta non verrà restituita. Devono essere specificate come coordinate di latitudine e longitudine:
```
"origin": {
    "latitude": 40.477398,
    "longitude": -74.259087
}
```
regionCode

Il codice regione utilizzato per formattare la risposta, specificato come valore a due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni notevoli. Ad esempio, il TLD di primo livello del Regno Unito è "uk" (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").

Se specifichi un codice regione non valido, l'API restituisce un errore INVALID_ARGUMENT. Il parametro può influire sui risultati in base alla legge vigente.
sessionToken

I token di sessione sono stringhe generate dall'utente che tracciano le chiamate di completamento automatico (nuove) come "sessioni". Autocomplete (Nuovo) utilizza i token di sessione per raggruppare le fasi di query e selezione della ricerca di completamento automatico di un utente in una sessione distinta ai fini della fatturazione. Per maggiori informazioni, consulta Token di sessione.

Esempi di completamento automatico (nuovi)

Limitare la ricerca a un'area utilizzando locationRestriction

Per impostazione predefinita, l'API utilizza la distorsione IP per controllare l'area di ricerca. Con la differenziazione per IP, l'API utilizza l'indirizzo IP del dispositivo per differenziazione dei risultati. Se vuoi, puoi utilizzarelocationRestriction o locationBias, ma non entrambi, per specificare un'area di ricerca.

locationRestriction specifica l'area in cui eseguire la ricerca. I risultati al di fuori dell'area specificata non vengono restituiti. Nell'esempio seguente, utilizzi locationRestriction per limitare la richiesta a un cerchio di raggio di 5000 metri centrato su San Francisco:

curl -X POST -d '{
  "input": "Art museum",
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

Tutti i risultati all'interno delle aree specificate sono contenuti nell'array suggestions:

  {
    "suggestions": [
      {
        "placePrediction": {
          "place": "places/ChIJkQQVTZqAhYARHxPt2iJkm1Q",
          "placeId": "ChIJkQQVTZqAhYARHxPt2iJkm1Q",
          "text": {
            "text": "Asian Art Museum, Larkin Street, San Francisco, CA, USA",
            "matches": [
              {
                "startOffset": 6,
                "endOffset": 16
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "Asian Art Museum",
              "matches": [
                {
                  "startOffset": 6,
                  "endOffset": 16
                }
              ]
            },
            "secondaryText": {
              "text": "Larkin Street, San Francisco, CA, USA"
            }
          },
          "types": [
            "establishment",
            "museum",
            "point_of_interest"
          ]
        }
      },
      {
        "placePrediction": {
          "place": "places/ChIJI7NivpmAhYARSuRPlbbn_2w",
          "placeId": "ChIJI7NivpmAhYARSuRPlbbn_2w",
          "text": {
            "text": "de Young Museum, Hagiwara Tea Garden Drive, San Francisco, CA, USA",
            "matches": [
              {
                "endOffset": 15
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "de Young Museum",
              "matches": [
                {
                  "endOffset": 15
                }
              ]
            },
            "secondaryText": {
              "text": "Hagiwara Tea Garden Drive, San Francisco, CA, USA"
            }
          },
          "types": [
            "establishment",
            "point_of_interest",
            "tourist_attraction",
            "museum"
          ]
        }
      },
      /.../
    ]
  }

Puoi anche utilizzare locationRestriction per limitare le ricerche a un area visibile rettangolare. L'esempio seguente limita la richiesta al centro di San Francisco:

  curl -X POST -d '{
    "input": "Art museum",
    "locationRestriction": {
      "rectangle": {
        "low": {
          "latitude": 37.7751,
          "longitude": -122.4219
        },
        "high": {
          "latitude": 37.7955,
          "longitude": -122.3937
        }
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  https://places.googleapis.com/v1/places:autocomplete

I risultati sono contenuti nell'array suggestions:

  {
    "suggestions": [
      {
        "placePrediction": {
          "place": "places/ChIJkQQVTZqAhYARHxPt2iJkm1Q",
          "placeId": "ChIJkQQVTZqAhYARHxPt2iJkm1Q",
          "text": {
            "text": "Asian Art Museum, Larkin Street, San Francisco, CA, USA",
            "matches": [
              {
                "startOffset": 6,
                "endOffset": 16
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "Asian Art Museum",
              "matches": [
                {
                  "startOffset": 6,
                  "endOffset": 16
                }
              ]
            },
            "secondaryText": {
              "text": "Larkin Street, San Francisco, CA, USA"
            }
          },
          "types": [
            "point_of_interest",
            "museum",
            "establishment"
          ]
        }
      },
      {
        "placePrediction": {
          "place": "places/ChIJyQNK-4SAhYARO2DZaJleWRc",
          "placeId": "ChIJyQNK-4SAhYARO2DZaJleWRc",
          "text": {
            "text": "International Art Museum of America, Market Street, San Francisco, CA, USA",
            "matches": [
              {
                "startOffset": 14,
                "endOffset": 24
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "International Art Museum of America",
              "matches": [
                {
                  "startOffset": 14,
                  "endOffset": 24
                }
              ]
            },
            "secondaryText": {
              "text": "Market Street, San Francisco, CA, USA"
            }
          },
          "types": [
            "museum",
            "point_of_interest",
            "tourist_attraction",
            "art_gallery",
            "establishment"
          ]
        }
      }
    ]
  }

Inclinare la ricerca verso un'area utilizzando locationBias

Con locationBias, la posizione funge da bias, il che significa che è possibile restituire risultati relativi alla località specificata, inclusi quelli al di fuori dell'area specificata. Nel seguente esempio, dai un'impronta alla richiesta per il centro di San Francisco:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

I risultati ora contengono molti altri elementi, inclusi i risultati al di fuori del raggio di 5000 metri:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Haight Street, San Francisco, CA, USA"
          }
        },
        "types": [
          "electronics_store",
          "point_of_interest",
          "store",
          "establishment",
          "home_goods_store"
        ]
      }
    },
    {
      "placePrediction": {
        "place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw",
        "placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw",
        "text": {
          "text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Telegraph Avenue, Berkeley, CA, USA"
          }
        },
        "types": [
          "electronics_store",
          "point_of_interest",
          "establishment",
          "home_goods_store",
          "store"
        ]
      }
    },
    ...
  ]
}

Puoi anche utilizzare locationBias per limitare le ricerche a un area visibile rettangolare. L'esempio seguente limita la richiesta al centro di San Francisco:

  curl -X POST -d '{
    "input": "Amoeba",
    "locationBias": {
      "rectangle": {
        "low": {
          "latitude": 37.7751,
          "longitude": -122.4219
        },
        "high": {
          "latitude": 37.7955,
          "longitude": -122.3937
        }
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  https://places.googleapis.com/v1/places:autocomplete

Sebbene i risultati di ricerca all'interno dell'area visibile rettangolare vengano visualizzati nella risposta, alcuni risultati sono al di fuori dei confini definiti a causa di un bias. I risultati sono contenuti anche nell'array suggestions:

  {
    "suggestions": [
      {
        "placePrediction": {
          "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
          "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
          "text": {
            "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "Amoeba Music",
              "matches": [
                {
                  "endOffset": 6
                }
              ]
            },
            "secondaryText": {
              "text": "Haight Street, San Francisco, CA, USA"
            }
          },
          "types": [
            "point_of_interest",
            "store",
            "establishment"
          ]
        }
      },
      {
        "placePrediction": {
          "place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw",
          "placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw",
          "text": {
            "text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "Amoeba Music",
              "matches": [
                {
                  "endOffset": 6
                }
              ]
            },
            "secondaryText": {
              "text": "Telegraph Avenue, Berkeley, CA, USA"
            }
          },
          "types": [
            "point_of_interest",
            "store",
            "establishment"
          ]
        }
      },
      {
        "placePrediction": {
          "place": "places/ChIJRdmfADq_woARYaVhnfQSUTI",
          "placeId": "ChIJRdmfADq_woARYaVhnfQSUTI",
          "text": {
            "text": "Amoeba Music, Hollywood Boulevard, Los Angeles, CA, USA",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "structuredFormat": {
            "mainText": {
              "text": "Amoeba Music",
              "matches": [
                {
                  "endOffset": 6
                }
              ]
            },
            "secondaryText": {
              "text": "Hollywood Boulevard, Los Angeles, CA, USA"
            }
          },
          "types": [
            "point_of_interest",
            "store",
            "establishment"
          ]
        }
      },
    /.../
    ]
  }

Utilizzo di inclusiPrincipaleType

Utilizza il parametro includedPrimaryTypes per specificare fino a cinque valori di tipo della tabella A, tabella B, o solo (regions) o solo (cities). Un luogo deve corrispondere a uno dei valori di tipo principale specificati per essere incluso nella risposta.

Nell'esempio seguente, specifichi una stringa input di "Calcio" e utilizzi il parametro includedPrimaryTypes per limitare i risultati a stabilimenti di tipo "sporting_goods_store":

curl -X POST -d '{
  "input": "Soccer",
  "includedPrimaryTypes": ["sporting_goods_store"],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

Se ometti il parametro includedPrimaryTypes, i risultati possono includere attività di un tipo che non vuoi, ad esempio "athletic_field".

Richiedi previsioni delle query

Le previsioni delle query non vengono restituite per impostazione predefinita. Utilizza il parametro di richiesta includeQueryPredictions per aggiungere le previsioni delle query alla risposta. Ad esempio:

curl -X POST -d '{
  "input": "Amoeba",
  "includeQueryPredictions": true,
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

L'array suggestions ora contiene sia le previsioni dei luoghi sia quelle delle query come mostrato sopra in Informazioni sulla risposta. Ogni previsione di query include il campo text contenente una stringa di ricerca di testo consigliata. Puoi effettuare una richiesta di ricerca di testo (nuova) per ottenere ulteriori informazioni su qualsiasi previsione della query restituita.

Nota: le previsioni delle query non vengono restituite quando è impostato il parametro includedRegionCodes.

Usa origine

In questo esempio, includi nella richiesta origin sotto forma di coordinate di latitudine e longitudine. Quando includi origin, l'API include il campo distanceMeters nella risposta, che contiene la distanza in linea retta dal origin alla destinazione. Questo esempio imposta l'origine sul centro di San Francisco:

curl -X POST -d '{
  "input": "Amoeba",
  "origin": {
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

La risposta ora include distanceMeters:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Haight Street, San Francisco, CA, USA"
          }
        },
        "types": [
          "home_goods_store",
          "establishment",
          "point_of_interest",
          "store",
          "electronics_store"
        ],
        "distanceMeters": 3012
      }
    }
  ]
}

Prova

L'Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.

Seleziona l'icona dell'API sul lato destro della pagina.
Se vuoi, espandi Mostra parametri standard e imposta il parametro fields sulla maschera di campo.
Se vuoi, modifica il corpo della richiesta.
Seleziona il pulsante Esegui. Nel popup, scegli l'account che vuoi utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona di espansione, , per espandere la finestra di Explorer API.

Completamento automatico (novità)

Richieste di completamento automatico (nuove)

Informazioni sulla risposta

Parametri obbligatori

input

Parametri facoltativi

FieldMask

includedPrimaryTypes

includePureServiceAreaBusinesses

includeQueryPredictions

includedRegionCodes

inputOffset

languageCode

locationBias o locationRestriction

locationBias

locationRestriction

origine

regionCode

sessionToken

Esempi di completamento automatico (nuovi)

Limitare la ricerca a un'area utilizzando locationRestriction

Inclinare la ricerca verso un'area utilizzando locationBias

Utilizzo di inclusiPrincipaleType

Richiedi previsioni delle query

Usa origine

Prova