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 alla risposta della ricerca di testo
- Modifiche alla risposta di Ricerca nelle vicinanze
- Modifiche alla risposta di Place Details
Modifiche all'oggetto Place della risposta
Questa tabella mostra le modifiche all'oggetto
Place nuovo
nella risposta per i dettagli dei luoghi (novità), la ricerca nelle vicinanze (novità) e la ricerca di testo (novità) rispetto all'oggetto
Place esistente.
Il nuovo oggetto di risposta utilizza la notazione camel per i nomi dei campi, contiene nuovi campi e rinomina alcuni dei campi esistenti.
| Campo | Oggetto Luogo esistente | Oggetto Nuovo luogo | Note |
|---|---|---|---|
| Componente dell'indirizzo | address_components |
addressComponents |
|
| Indirizzo del microformato del luogo | adr_address |
adrFormatAddress |
|
| Stato dell'attività | business_status |
businessStatus |
|
| Orari 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. Per maggiori informazioni, consulta la sezione Icone dei luoghi. |
|
| 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 |
|
| Nome del luogo del testo | name |
displayName |
Il nome del luogo del testo è ora accessibile come displayName.text e
language come 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 da UTC | utc_offset |
utcOffsetMinutes |
|
| Forma abbreviata dell'indirizzo, inclusi 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 dei luoghi | 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 si trovano in
displayName. |
|
| Tipo di luogo principale | primaryTypeName |
Nuovo | |
| Inserisci il tipo principale come stringa di testo | primaryTypeDisplayName |
Nuovo | |
| Orari di apertura secondari settimanali regolari, con eccezioni e tutti gli altri 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 | |
| Informazioni sulla ricarica EV per un luogo | evChargeOptions |
Nuovo | |
| Attributi dei luoghi | 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 dell'oggetto response per la ricerca di testo esistente e dell'oggetto response per la ricerca di testo (nuova). 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 |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) | |
| Eventuali messaggi di errore | error_message |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) | |
| Eventuali messaggi informativi | info_messages |
Rimosso | |
| Token pagina | next_page_token |
Rimosso |
Modifiche alla risposta di Nearby Search
La tabella seguente mostra le modifiche ai campi di primo livello dell'oggetto risposta per la Ricerca nelle vicinanze esistente e l'oggetto risposta per la Ricerca nelle vicinanze (nuova). 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 |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) | |
| Eventuali messaggi di errore | error_message |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) | |
| Eventuali messaggi informativi | 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 dell'oggetto risposta per i dettagli dei luoghi esistenti e dell'oggetto risposta per i dettagli dei luoghi (nuovo). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places.
| Campo | Dettagli del luogo (esistenti) | Dettagli dei luoghi (novità) | Note |
|---|---|---|---|
| Attribuzioni dei luoghi | html_attributions |
Trasferito nell'oggetto Place
come attributions |
|
| Dettagli del luogo | result contenente l'oggetto Luogo esistente |
Il nuovo oggetto Place | |
| Stato della richiesta | status |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) | |
| Eventuali messaggi informativi | info_messages |
È stata utilizzata la risposta HTTP standard (codice e messaggio di risposta HTTP) |