Dettagli luogo (nuovo)

Seleziona la piattaforma: Android iOS JavaScript Web Service

Puoi richiedere ulteriori dettagli su un determinato esercizio o punto di interesse utilizzando il relativo ID luogo e inviando una richiesta di Dettagli luogo (nuova). Dettagli sul luogo (novità) restituisce informazioni più complete sul luogo indicato, ad esempio indirizzo completo, numero di telefono, valutazione e recensioni degli utenti.

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

• Ricerca di testo (novità)
• Ricerca nelle vicinanze (novità)
• Completamento automatico (novità)

Nota: Dettagli dei luoghi (novità) è disponibile nell'SDK Places per Android 3.3.0 e versioni successive. Per ulteriori informazioni, vedi Scegliere la versione dell'SDK. Per ulteriori informazioni sull'utilizzo delle API Kotlin aggiunte nella versione 4.0.0, consulta la Panoramica di riferimento.

Richieste Place Details (nuove)

Puoi richiedere i dettagli dei luoghi chiamando PlacesClient.fetchPlace() e passando un FetchPlaceRequest oggetto contenente un ID luogo e un elenco di campi, nonché eventuali parametri facoltativi:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

Nota: per ulteriori informazioni sull'inizializzazione di PlacesClient, consulta Inizializzare il client dell'API Places.

Puoi utilizzare un CancellationToken per tentare di annullare una richiesta a una delle classi di richiesta (ad esempio FetchPlaceRequest). L'annullamento viene eseguito secondo il criterio del "best effort". Una volta inviata una richiesta di annullamento, non verrà restituita alcuna risposta. L'emissione di un token di annullamento NON garantisce che una determinata richiesta verrà annullata e ti potrebbe essere addebitato l'importo della richiesta anche se non viene restituita alcuna risposta.

Risposte a Place Details (Nuovo)

La richiesta Place Details (Nuova) restituisce i dati sotto forma di oggetto Place che include solo i campi richiesti utilizzando l'elenco di campi. I risultati dei dati dei luoghi non possono essere vuoti, pertanto vengono restituiti solo i risultati dei luoghi con dati (ad esempio, se un luogo richiesto non ha foto, il campo delle foto non sarà presente nel risultato).

Per accedere ai campi di dati, chiama il corrispondente metodo. Ad esempio, per accedere al nome del luogo, chiama getName().

Parametri obbligatori

I parametri obbligatori per FetchPlaceRequest sono:

• ID luogo

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

• Elenco di campi

  Quando richiedi un luogo, devi specificare i dati del luogo da restituire. Per farlo, passa un elenco di valori Place.Field che specificano i dati da restituire. Non è presente un elenco predefinito dei campi restituiti nella risposta.

  Gli elenchi di campi sono 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.Questo elenco è un aspetto importante da considerare perché influisce sul costo di ogni richiesta. Per ulteriori informazioni, consulta Utilizzo e fatturazione.

  Specifica uno o più dei seguenti campi:

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

    Place.Field.DISPLAY_NAME, Place.Field.ID, Place.Field.PHOTO_METADATAS, Place.Field.RESOURCE_NAME
    
    Note:

    • Il campo Place.Field.NAME è stato ritirato nella versione 4.0 di Places SDK for Android. Utilizza invece Place.Field.DISPLAY_NAME.
    • Il campo RESOURCE_NAME contiene il nome della risorsa luogo nel formato: places/PLACE_ID. Usa DISPLAY_NAME per accedere al nome del luogo in formato di testo.

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

    Place.Field.ADDRESS_COMPONENTS, ADR_FORMAT_ADDRESS, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION, Place.Field.PLUS_CODE, Place.Field.SHORT_FORMATTED_ADDRESS, Place.Field.TYPES, Place.Field.VIEWPORT
    
    Nota: i campi Place.Field.ADDRESS e Place.Field.LAT_LNG sono stati ritirati nella versione 4.0 di Places SDK for Android. Utilizza Place.Field.FORMATTED_ADDRESS e Place.Field.LOCATION, rispettivamente.

  • I seguenti campi attivano lo SKU Place Details (Basic):

    Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.BUSINESS_STATUS, Place.Field.GOOGLE_MAPS_URI, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.PRIMARY_TYPE, Place.Field.PRIMARY_TYPE_DISPLAY_NAME, Place.Field.SUB_DESTINATIONS, Place.Field.UTC_OFFSET
    
    Nota: i campi Place.Field.ICON_URL e Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE sono stati ritirati nella versione 4.0 di Places SDK for Android. Utilizza invece Place.Field.ICON_MASK_URL e Place.Field.ACCESSIBILITY_OPTIONS. Place.Field.ACCESSIBILITY_OPTIONS è disponibile solo per dettagli sui luoghi (nuovo).

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

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.NATIONAL_PHONE_NUMBER Place.Field.OPENING_HOURS, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.USER_RATING_COUNT Place.Field.WEBSITE_URI
    
    Nota: i campi Place.Field.PHONE_NUMBER e Place.Field.USER_RATINGS_TOTAL sono stati ritirati nella versione 4.0 di Places SDK for Android. Utilizza Place.Field.INTERNATIONAL_PHONE_NUMBER e Place.USER_RATING_COUNT, rispettivamente.

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

    Place.Field.ALLOWS_DOGS, Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.EV_CHARGE_OPTIONS, Place.Field.FUEL_OPTIONS, Place.Field.GOOD_FOR_CHILDREN, Place.Field.GOOD_FOR_GROUPS, Place.Field.GOOD_FOR_WATCHING_SPORTS, Place.Field.LIVE_MUSIC, Place.Field.MENU_FOR_CHILDREN, Place.Field.OUTDOOR_SEATING, Place.Field.PARKING_OPTIONS, Place.Field.PAYMENT_OPTIONS, Place.Field.RESERVABLE, Place.Field.RESTROOM, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_COCKTAILS, Place.Field.SERVES_COFFEE, Place.Field.SERVES_DESSERT, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT
  Nota: la versione 4.0 di Places SDK for Android ha introdotto il ritiro di diversi campi di dati dei luoghi e l'aggiunta di nuovi campi. Per ulteriori informazioni, consulta Eseguire la migrazione ai nuovi campi di dati dei luoghi in Places SDK for Android 4.0 .

Parametri facoltativi

I parametri facoltativi per FetchPlaceRequest sono:

• Codice regione

  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 Place.Field.FORMATTED_ADDRESS nella risposta corrisponde a regionCode, il codice paese viene omesso da Place.Field.FORMATTED_ADDRESS.

  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.

  Per impostare il parametro del codice regione, chiama il metodo setRegionCode() durante la creazione dell'oggetto FetchPlaceRequest.

• Token di sessione

  I token di sessione sono stringhe generate dagli utenti che monitorano le chiamate di completamento automatico (nuove) come "sessioni". La funzionalità di completamento automatico (nuova) utilizza i token di sessione per agrupare le fasi di query e selezione dei luoghi di una ricerca di completamento automatico dell'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.

  Per impostare il parametro token sessione, chiama il metodo setSessionToken() durante la creazione dell'oggetto FetchPlaceRequest.

Esempio di dettagli del luogo

L'esempio seguente richiede i campi ID, DISPLAY_NAME e FORMATTED_ADDRESS per l'Empire State Building a New York.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);