Das Antwortformat der neuen APIs Place Details, Nearby Search und Text Search unterscheidet sich vom Format der vorhandenen APIs. Der Hauptunterschied besteht im Format des Place-Objekts, das von den einzelnen Methoden zurückgegeben wird, wie unter Änderungen am Antwortobjekt „Ort“ beschrieben.
Außerdem haben sich die Felder der obersten Ebene des Antwortobjekts für jede API geändert. Weitere Informationen:
- Änderungen an Text Search-Antworten
- Änderungen an der Nearby Search-Antwort
- Änderungen bei der „Place Details“-Antwort
Änderungen am „Place“-Antwortobjekt
In dieser Tabelle sind die Änderungen am neuen Place-Objekt in der Antwort für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ im Vergleich zum vorhandenen Place-Objekt aufgeführt.
Das neue Antwortobjekt verwendet Camel Case für Feldnamen, enthält neue Felder und einige der vorhandenen Felder wurden umbenannt.
| Feld | Vorhandenes Ortsobjekt | Neues Ortsobjekt | Hinweise |
|---|---|---|---|
| Adresskomponente | address_components |
addressComponents |
|
| Adresse im Microformat für Orte | adr_address |
adrFormatAddress |
|
| Status des Unternehmens | business_status |
businessStatus |
|
| Öffnungszeiten für die nächste Woche | current_opening_hours |
currentOpeningHours |
|
| Redaktionelle Zusammenfassung | editorial_summary |
editorialSummary |
|
| Formatierte Adresse | formatted_address |
formattedAddress |
|
| Landesweite Telefonnummer | formatted_phone_number |
nationalPhoneNumber |
|
| Standort | geometry.location |
location |
|
| Darstellungsbereich | geometry.viewport |
viewport |
|
| Quellenangaben für Orte | html_attributions |
attributions |
Feld der obersten Ebene der Antwort in den vorhandenen APIs |
| Symbol-URL | icon |
Entfernt. iconMaskBaseUri und
iconBackgroundColor. Weitere Informationen finden Sie unter Ortssymbole. |
|
| Symbolhintergrundfarbe | icon_background_color |
iconBackgroundColor |
|
| Symbolmasken-URL | icon_mask_base_uri |
iconMaskBaseUri |
|
| Internationale Telefonnummer | international_phone_number |
internationalPhoneNumber |
|
| Ortsname in Textform | name |
displayName |
Name des Textortes ist jetzt als displayName.text zugänglich und
language als displayName.languageCode |
| Öffnungszeiten | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
Das Format von photos hat sich in der neuen
Place-Objekt. Weitere Informationen finden Sie unter
Zu Fotoreferenzen wechseln |
| Orts-ID | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| Preisniveau | price_level |
priceLevel |
|
| Bewertung | rating |
rating |
|
| Rezensionen | reviews |
reviews |
|
| Sekundäre Öffnungszeiten für die nächste Woche ab heute, mit Ausnahmen und allen anderen Daten | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Ortstypen | types |
types |
|
| Google Maps-URL des Orts | url |
googleMapsUri |
|
| Anzahl der Nutzerbewertungen | user_ratings_total |
userRatingCount |
|
| UTC-Versatz | utc_offset |
utcOffsetMinutes |
|
| Kurzform der Adresse, einschließlich Straßenname und Ort | vicinity |
shortFormattedAddress |
|
| Website des Orts | website |
websiteUri |
|
| Informationen zur Barrierefreiheit | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance findet jetzt hier statt:
accessibilityOptions.wheelchairAccessibleEntrance |
| Places-Attribute | 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 |
|
| Ressourcenname | name-Feld im Format places/PLACE_ID |
In der vorhandenen API enthielt das Feld name den Parameter
Ortsname als Textzeichenfolge. In der neuen API befinden sich diese Informationen
displayName |
|
| Primärer Ortstyp | primaryTypeName |
Neu | |
| Primären Typ als Textstring einfügen | primaryTypeDisplayName |
Neu | |
| Regelmäßige wöchentliche sekundäre Öffnungszeiten mit Ausnahmen und allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Zahlungsoptionen, die vom Standort akzeptiert werden | paymentOptions |
Neu | |
| Parkmöglichkeiten angeben | parkingOptions |
Neu | |
| Liste der mit dem Ort verbundenen Unterziele | subDestinations |
Neu | |
| Neueste Informationen zu Kraftstoffoptionen an Tankstellen | fuelOptions |
Neu | |
| Informationen zu Ladestationen für Elektrofahrzeuge an einem Ort | evChargeOptions |
Neu | |
| Places-Attribute | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Neu |
Änderungen an der Text Search-Antwort
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für die vorhandene Textsuche und des Antwortobjekts für die neue Textsuche aufgeführt. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort
ist das Array places.
| Feld | Textsuche (vorhanden) | Text Search (New) | Hinweise |
|---|---|---|---|
| Ortsattributionen | html_attributions |
Werden in das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Array von Orten | results-Array des vorhandenen Orts-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | status |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Fehlermeldungen | error_message |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen an „Nearby Search“-Antworten
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene der response
Objekt
für die vorhandene Nearby Search und die Antwort
Objekt
für „Nearby Search (New)“. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Nearby Search (Existing) | Nearby Search (New) | Hinweise |
|---|---|---|---|
| Ortsattributionen | html_attributions |
Verschoben in das neue Ort-Objekt für jeden Ort als place.attributions |
|
| Array von Orten | results-Array des vorhandenen Place-Objekts |
places-Array des neuen
Objekt Place |
|
| Status der Anfrage | status |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Fehlermeldungen | error_message |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen bei der Place Details-Antwort
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene der response
Objekt
für die vorhandenen Ortsdetails über eine Place Details-Anfrage und die response
Objekt
für „Place Details (New)“. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Ortsdetails (vorhanden) | Place Details (New) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
An den neuen Ort verschoben
Objekt als attributions |
|
| Ortsdetails | result mit dem vorhandenen Place-Objekt |
Das neue Ortsobjekt | |
| Status der Anfrage | status |
In die Standard-HTTP-Antwort (HTTP-Antwortcode und -Nachricht) verschoben | |
| Alle Infonachrichten | info_messages |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt |