Il formato della risposta per le nuove API
Place Details,
Nearby Search,
e
Text Search
è cambiato rispetto a quello delle API esistenti. La differenza principale consiste nel formato dell'oggetto Place
restituito da ciascun metodo, come descritto in Modifiche all'oggetto Place di risposta.
Inoltre, sono stati modificati anche i campi di primo livello dell'oggetto risposta per ogni API. Consulta:
- Modifiche alla risposta di Ricerca testuale
- Modifiche alle risposte di Ricerca nelle vicinanze
- Modifiche alla risposta Place Details
Modifiche all'oggetto Place di risposta
Questa tabella mostra le modifiche al nuovo oggetto Place
nella risposta per Dettagli luogo (Nuovo), Ricerca nelle vicinanze (Nuova) e Ricerca testuale (Nuova) rispetto all' oggetto Place
esistente.
Il nuovo oggetto risposta utilizza le maiuscole e le minuscole per i nomi dei campi, contiene nuovi campi e rinomina alcuni campi esistenti.
Tecnico | Oggetto Place esistente | Nuovo oggetto Place | Note |
---|---|---|---|
Componente dell'indirizzo | address_components |
addressComponents |
|
Indirizzo bulksheet 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 . Per ulteriori informazioni, consulta la sezione Icone dei luoghi. |
|
Colore sfondo icona | icon_background_color |
iconBackgroundColor |
|
URL maschera dell'icona | icon_mask_base_uri |
iconMaskBaseUri |
|
Numero di telefono internazionale | international_phone_number |
internationalPhoneNumber |
|
Testo nome del luogo | name |
displayName |
Il nome del luogo di 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 maggiori informazioni, consulta
Passare ai riferimenti delle foto. |
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 eccezioni e tutti gli altri dati | secondary_opening_hours |
currentSecondaryOpeningHours |
|
Tipi di luogo | types |
types |
|
URL di Google Maps del luogo | url |
googleMapsUri |
|
Numero di valutazioni degli utenti | user_ratings_total |
userRatingCount |
|
Differenza UTC | utc_offset |
utcOffsetMinutes |
|
Indirizzo breve che include il nome della via e la città | vicinity |
shortFormattedAddress |
|
Sito web dell'attività | website |
websiteUri |
|
Informazioni sull'accessibilità in sedia a rotelle | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance è ora a
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 della risorsa | Campo name nel modulo places/PLACE_ID |
Nell'API esistente, il campo name conteneva il nome del luogo sotto forma di stringa di testo. Nella nuova API, queste informazioni si trovano in
displayName . |
|
Tipo principale luogo | primaryTypeName |
Novità | |
Posiziona il tipo primario come stringa di testo | primaryTypeDisplayName |
Novità | |
Orario di apertura secondaria settimanale regolare, con eccezioni e tutti gli altri dati | regularSecondaryOpeningHours |
Novità | |
Opzioni di pagamento accettate dal luogo | paymentOptions |
Novità | |
Opzioni per il parcheggio del luogo | parkingOptions |
Novità | |
Elenco di destinazioni secondarie correlate a questo luogo | subDestinations |
Novità | |
Informazioni più recenti sulle opzioni di carburante in una stazione di servizio | fuelOptions |
Novità | |
Informazioni sulla ricarica EV di un luogo | evChargeOptions |
Novità | |
Attributi dei luoghi | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Novità |
Modifiche alla risposta della Ricerca testuale
La seguente tabella mostra le modifiche ai campi di primo livello dell'oggetto risposta per la ricerca testuale esistente e all'oggetto risposta per la ricerca testuale (nuova). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places
.
Tecnico | Ricerca testuale (esistente) | Ricerca testuale (novità) | Note |
---|---|---|---|
Attribuzioni dei luoghi | html_attributions |
Spostato nel nuovo 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 |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) | |
Eventuali messaggi di errore | error_message |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) | |
Eventuali messaggi informativi | info_messages |
Rimosso | |
Token pagina | next_page_token |
Rimosso |
Modifiche alla risposta di Ricerca nelle vicinanze
La seguente tabella mostra le modifiche ai campi di primo livello dell'oggetto risposta per Nearby Search esistente e l'oggetto risposta per Nearby Search (nuovo). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places
.
Tecnico | Ricerca nelle vicinanze (esistente) | Ricerca nelle vicinanze (novità) | Note |
---|---|---|---|
Attribuzioni dei luoghi | html_attributions |
Spostato nel nuovo 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 |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) | |
Eventuali messaggi di errore | error_message |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) | |
Eventuali messaggi informativi | info_messages |
Rimosso | |
Token pagina | next_page_token |
Rimosso |
Modifiche alla risposta Place Details
La seguente tabella mostra le modifiche ai campi di primo livello dell'oggetto risposta per i Dettagli luogo esistenti e dell'oggetto risposta per Dettagli luogo (Nuovo). Per la nuova API, l'unico campo di primo livello nella risposta è l'array places
.
Tecnico | Dettagli luogo (esistenti) | Dettagli luogo (novità) | Note |
---|---|---|---|
Attribuzioni dei luoghi | html_attributions |
Spostato nel nuovo oggetto Place come attributions |
|
Dettagli luogo | result contenente l'oggetto Place esistente |
Il nuovo oggetto Place | |
Stato della richiesta | status |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) | |
Eventuali messaggi informativi | info_messages |
Spostata nella risposta HTTP standard (codice di risposta HTTP e messaggio) |