Dettagli luogo (nuovo)

Seleziona la piattaforma: Android iOS JavaScript Web Service

Una volta ottenuto un ID luogo, puoi richiedere ulteriori dettagli su un determinato esercizio o punto d'interesse avviando una richiesta Place Details (New). Una richiesta Place Details (nuova) restituisce informazioni più complete sul luogo indicato, ad esempio l'indirizzo completo, il numero di telefono, la valutazione degli utenti e le recensioni.

Esistono molti modi per ottenere un ID luogo. Puoi utilizzare:

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

Prova!

Richieste Place Details (nuove)

Una richiesta di dettagli sul luogo è una richiesta HTTP GET nel seguente formato:

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

Passa tutti i parametri come parametri URL o nelle intestazioni come parte della richiesta GET. Ad esempio:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

In alternativa, in un comando cURL:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Risposte a Place Details (Nuovo)

Place Details (New) restituisce un oggetto JSON come risposta. Nella risposta:

  • La risposta è rappresentata da un oggetto Place. L'oggetto Place contiene informazioni dettagliate sul luogo.
  • La FieldMask passata nella richiesta specifica l'elenco dei campi restituiti nell'oggetto Place.

L'oggetto JSON completo è nel formato:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Parametri obbligatori

  • 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 il parametro URL $fields o fields oppure l'intestazione HTTP X-Goog-FieldMask. Nella risposta non è presente un elenco predefinito dei campi restituiti. Se ometti la maschera di campo, il metodo restituisce un errore.

    La mascheratura dei campi è una buona prassi di progettazione per assicurarti di non richiedere dati non necessari, il che consente di evitare tempi di elaborazione e costi di fatturazione non necessari.

    Specifica un elenco separato da virgole di tipi di dati dei luoghi da restituire. Ad esempio, per recuperare il nome visualizzato e l'indirizzo del luogo.

    X-Goog-FieldMask: displayName,formattedAddress

    Utilizza * per recuperare tutti i campi.

    X-Goog-FieldMask: *

    Specifica uno o più dei seguenti campi:

    • I seguenti campi attivano lo SKU Dettagli dei luoghi (solo ID):

      attributions, id, name*, photos

      * Il campo name contiene il nome della risorsa del luogo nel formato: places/PLACE_ID. Usa displayName per accedere al nome del luogo in formato testo.

    • I seguenti campi attivano lo SKU Dettagli sui luoghi (solo posizione):

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • I seguenti campi attivano lo SKU di Places Details (di base):

      accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

      * Il campo googleMapsLinks è nella fase di anteprima pre-GA e non è previsto alcun addebito, il che significa che la fatturazione è pari a 0 $per l'utilizzo durante l'anteprima.

    • I seguenti campi attivano lo SKU Dettagli sui luoghi (avanzato):

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • I seguenti campi attivano lo SKU Dettagli dei luoghi (opzione preferita):

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, routingSummaries,* servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

      * Solo Ricerca di testi e Ricerca nelle vicinanze

  • placeId

    Un identificatore di testo che identifica in modo univoco un luogo, restituito da una ricerca di testo (nuova) o da una ricerca nelle vicinanze (nuova). Per saperne di più sugli ID luogo, consulta la panoramica degli ID luogo.

    La stringa places/PLACE_ID è chiamata anche nome della risorsa del luogo. Nella risposta di una richiesta di dettagli dei luoghi (novità), di ricerca nelle vicinanze (novità) e di ricerca di testo (novità), questa stringa è contenuta nel campo name della risposta. L'ID luogo indipendente è contenuto nel campo id della risposta.

Parametri facoltativi

  • languageCode

    La lingua in cui restituire i risultati.

    • Consulta l'elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivo.
    • Se non viene fornito languageCode, l'API imposta en come valore predefinito. Se specifichi un codice lingua non valido, l'API restituisce un errore INVALID_ARGUMENT.
    • L'API fa del suo meglio per fornire un indirizzo stradale leggibile sia per l'utente sia per i residenti. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitterati in uno script leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti degli indirizzi vengono restituiti nella stessa lingua, che viene scelta dal primo componente.
    • Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più simile.
    • La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, ad esempio le abbreviazioni per i tipi di strade o i sinonimi che possono essere validi in una lingua, ma non in un'altra.

  • regionCode

    Il codice regione utilizzato per formattare la risposta, specificato come valore di un codice CLDR a due caratteri. Non è presente alcun valore predefinito.

    Se il nome del paese del campo formattedAddress nella risposta corrisponde a regionCode, il codice paese viene omesso da formattedAddress. Questo parametro non ha effetto su adrFormatAddress, che include sempre il nome del paese, oppure su shortFormattedAddress, che non lo include mai.

    La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune eccezioni significative. 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"). Il parametro può influire sui risultati in base alla legge vigente.

  • sessionToken

    I token di sessione sono stringhe generate dagli utenti che monitorano le chiamate di Completamento automatico (Nuova) come "sessioni". Autocomplete (Nuovo) utilizza i token di sessione per raggruppare le fasi di query e posizionare la selezione di una ricerca di completamento automatico di un utente in una sessione distinta ai fini della fatturazione. I token di sessione vengono passati alle chiamate Place Details (New) che seguono le chiamate Autocomplete (New). Per ulteriori informazioni, consulta Token di sessione.

Esempio di dettagli del luogo

L'esempio seguente richiede i dettagli di un luogo tramite placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Tieni presente che l'intestazione X-Goog-FieldMask specifica che la risposta contiene i seguenti campi di dati: id,displayName. La risposta è quindi nel seguente formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Aggiungi altri tipi di dati alla maschera del campo per restituire informazioni aggiuntive. Ad esempio, aggiungi formattedAddress,plusCode per includere l'indirizzo e il plus code nella risposta:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

La risposta ora è nel seguente formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Prova

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

Per effettuare una richiesta:

  1. Seleziona l'icona dell'API Espandi Explorer API. sul lato destro della pagina.
  2. Se vuoi, imposta il parametro name su: 
    places/PLACE_ID
  3. Se vuoi, espandi Mostra parametri standard e imposta il parametro fields sulla maschera di campo.
  4. Seleziona il pulsante Esegui. Nel popup, scegli l'account che vuoi utilizzare per effettuare la richiesta.

  5. Nel riquadro Explorer API, seleziona l'icona Espandi, Espandi Explorer API., per espandere la finestra di Explorer API.