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 query

Parametri
languageCode

string

(Facoltativo) I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile.

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

string

(Facoltativo) Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Per ulteriori informazioni, visita la pagina https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Tieni presente che i codici regione a tre cifre non sono attualmente supportati.
sessionToken

string

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

Ti consigliamo di seguire le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate di completamento automatico dei luoghi.
  • 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 completamento automatico dei luoghi, dei dettagli dei luoghi e di convalida dell'indirizzo all'interno di una sessione appartengano allo stesso progetto Cloud Console.
  • 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.