Esegui la migrazione della risposta dell'API Places

Il formato di risposta per le nuove API Dettagli dei luoghi, Nearby Search e Ricerca di testo è cambiato rispetto a quello delle API esistenti. La differenza principale sta nel formato dell'oggetto Place restituito da ciascun metodo, come descritto in Modifiche all'oggetto Place della risposta.

Inoltre, anche i campi di primo livello dell'oggetto risposta sono stati modificati per ogni API. Vedi:

Modifiche all'oggetto Place della risposta

Questa tabella mostra le modifiche alla nuova Oggetto Place nella risposta per Place Details (Novità), Ricerca nelle vicinanze (novità) e Ricerca testuale (nuova) rispetto a quella esistente oggetto Place.

Il nuovo oggetto risposta utilizza camel-casing per i nomi dei campi, contiene nuovi campi e rinomina alcuni dei campi esistenti.

Campo Oggetto Place esistente Nuovo oggetto Place Note
Componente dell'indirizzo address_components addressComponents
Indirizzo del microformato del luogo adr_address adrFormatAddress
Stato dell'attività business_status businessStatus
Orario di apertura della prossima settimana current_opening_hours currentOpeningHours
Riepilogo editoriale editorial_summary editorialSummary
Indirizzo formattato formatted_address formattedAddress
Numero di telefono nazionale formatted_phone_number nationalPhoneNumber
Località geometry.location location
Area visibile geometry.viewport viewport
Attribuzioni dei luoghi html_attributions attributions Campo di primo livello della risposta nelle API esistenti
URL icona icon Rimosso. Utilizza iconMaskBaseUri e iconBackgroundColor. Consulta Icone dei luoghi per ulteriori informazioni.
Colore sfondo icona icon_background_color iconBackgroundColor
URL della maschera dell'icona icon_mask_base_uri iconMaskBaseUri
Numero di telefono internazionale international_phone_number internationalPhoneNumber
Testo del nome del luogo name displayName Il testo del nome del luogo è ora accessibile come displayName.text e language sotto forma di displayName.languageCode
Orari di apertura opening_hours regularOpeningHours
Foto photos photos Il formato di photos è cambiato nel nuovo Oggetto Place. Per ulteriori informazioni, consulta Passare ai riferimenti fotografici.
ID luogo place_id id
Plus Code plus_code plusCode
Livello dei prezzi price_level priceLevel
Classificazione rating rating
Recensioni reviews reviews
Orari di apertura secondari per la prossima settimana a partire da oggi, con le eccezioni e tutti gli altri dati secondary_opening_hours currentSecondaryOpeningHours
Tipi di luoghi types types
URL di Google Maps del luogo url googleMapsUri
Numero di valutazioni degli utenti user_ratings_total userRatingCount
Differenza UTC utc_offset utcOffsetMinutes
Formato breve dell'indirizzo che include il nome della via e la città vicinity shortFormattedAddress
Sito web del luogo website websiteUri
Informazioni sull'accessibilità in sedia a rotelle wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance ora si trova su accessibilityOptions.wheelchairAccessibleEntrance
Attributi di Places takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
Nome risorsa Campo name nel modulo places/PLACE_ID Nell'API esistente, il campo name conteneva il nome del luogo come stringa di testo. Nella nuova API, queste informazioni sono displayName.
Tipo di luogo principale primaryTypeName Nuovo
Inserisci il tipo principale come stringa di testo primaryTypeDisplayName Nuovo
Normale orario di apertura settimanale secondario, con eccezioni e tutte le altre dati regularSecondaryOpeningHours Nuovo
Opzioni di pagamento accettate dal luogo paymentOptions Nuovo
Opzioni di parcheggio del luogo parkingOptions Nuovo
Elenco di sottodestinazioni correlate al luogo subDestinations Nuovo
Informazioni più recenti sulle opzioni di carburante in una stazione di servizio fuelOptions Nuovo
Ricarica EV Informazioni per un luogo evChargeOptions Nuovo
Attributi di Places outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Nuovo

Modifiche alla risposta della ricerca di testo

La tabella seguente mostra le modifiche ai campi di primo livello della oggetto response per la ricerca testuale esistente e oggetto risposta per Ricerca testuale (Novità). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places.

Campo Ricerca di testo (esistente) Ricerca di testo (novità) Note
Attribuzioni dei luoghi html_attributions Trasferito nell'oggetto Place per ogni luogo come place.attributions
Array di luoghi Array results dell'oggetto Place esistente Array places del nuovo oggetto Place
Stato della richiesta status Spostato nella risposta HTTP standard (messaggio e codice di risposta HTTP)
Eventuali messaggi di errore error_message Spostato nella risposta HTTP standard (messaggio e codice di risposta HTTP)
Qualsiasi messaggio informativo info_messages Rimosso
Token pagina next_page_token Rimosso

Modifiche alle risposte di Nearby Search

La tabella seguente mostra le modifiche ai campi di primo livello della risposta oggetto per la Ricerca nelle vicinanze esistente e la risposta Oggetto per Ricerca nelle vicinanze (novità). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places.

Campo Ricerca nelle vicinanze (esistente) Ricerca nelle vicinanze (novità) Note
Attribuzioni dei luoghi html_attributions Trasferito nell'oggetto Place per ogni luogo come place.attributions
Array di luoghi Array results dell'oggetto Place esistente Array places del nuovo oggetto Place
Stato della richiesta status Spostato nella risposta HTTP standard (messaggio e codice di risposta HTTP)
Eventuali messaggi di errore error_message Spostato nella risposta HTTP standard (messaggio e codice di risposta HTTP)
Qualsiasi messaggio informativo info_messages Rimosso
Token pagina next_page_token Rimosso

Modifiche alla risposta dei dettagli del luogo

La tabella seguente mostra le modifiche ai campi di primo livello della risposta oggetto per i Place Details esistenti e la risposta Oggetto per Place Details (Nuovo). Per la nuova API, l'unico campo di primo livello nella è l'array places.

Campo Dettagli luogo (esistenti) Dettagli luogo (novità) Note
Attribuzioni dei luoghi html_attributions Si è trasferito nel nuovo luogo oggetto come attributions
Dettagli del luogo result contenente l'oggetto Luogo esistente Il nuovo oggetto Place
Stato della richiesta status Spostato nella risposta HTTP standard (messaggio e codice di risposta HTTP)
Eventuali messaggi informativi info_messages È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP)