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 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, 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, 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 ai fini della fatturazione. Deve essere una stringa base64 sicura per URL e nomi di 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 di 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 una sessione, il token non è più valido e la tua 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 Place Autocomplete.
  • Genera un nuovo token per ogni sessione. Si consiglia l'uso di un UUID versione 4.
  • Assicurati che le credenziali utilizzate per tutte le richieste Place Autocomplete, Place Details e Address Validation all'interno di una sessione appartengano allo stesso progetto Cloud Console.
  • Assicurati di trasmettere un token di sessione univoco per ogni nuova sessione. L'utilizzo dello stesso token per più sessioni comporterà l'addebito individuale di ogni richiesta.

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.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform