Method: places.get

Visualizza i dettagli di un luogo in base al nome della risorsa, che è una stringa nel formato places/{placeId}.

Richiesta HTTP

GET https://places.googleapis.com/v1/{name=places/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

obbligatorio. Il nome della risorsa di un luogo, nel formato places/{placeId}.

Parametri di ricerca

Parametri
languageCode

string

Campo facoltativo. I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile.

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

regionCode

string

Campo facoltativo. Il codice paese/regione Unicode (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, come il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Per ulteriori informazioni, vedi 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.

sessionToken

string

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 sessionToken viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito un token di sessione (ogni richiesta viene fatturata separatamente).

Consigliamo le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate a Place Autocomplete.
  • Genera un nuovo token per ogni sessione. Si consiglia di utilizzare un UUID versione 4.
  • Assicurati che le credenziali utilizzate per tutte le richieste di Place Autocomplete, Place Details e Address Validation all'interno di una sessione appartengano allo stesso progetto della console Cloud.
  • Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più sessioni, ogni richiesta verrà fatturata singolarmente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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