Einführung
Das Antwortformat der APIs Place Details (New), Nearby Search (New) und Text Search (New) hat sich gegenüber den alten APIs geändert. 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 Nearby Search-Antworten
- Änderungen an der Antwort von „Place Details“
Änderungen am Antwortobjekt „Ort“
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 alten
Place-Objekt aufgeführt.
Das neue Antwortobjekt verwendet Camel Case für Feldnamen, enthält neue Felder und einige der bisherigen Felder wurden umbenannt.
| Feld | Places API (alte Version)-Objekt | Places API (New)-Objekt | Hinweise |
|---|---|---|---|
| Adresskomponente | address_components |
addressComponents |
|
| Adresse im Microformat | adr_address |
adrFormatAddress |
|
| Unternehmensstatus | 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 |
|
| Ortsangaben | html_attributions |
attributions |
Feld der obersten Ebene der Antwort in den alten APIs |
| Symbol-URL | icon |
Entfernt. Verwende iconMaskBaseUri und iconBackgroundColor. Weitere Informationen finden Sie unter Ortssymbole. |
|
| Symbolhintergrundfarbe | icon_background_color |
iconBackgroundColor |
|
| URL der Symbolmaske | icon_mask_base_uri |
iconMaskBaseUri |
|
| Internationale Telefonnummer | international_phone_number |
internationalPhoneNumber |
|
| Text für Ortsnamen | name |
displayName |
Der Ortsname im Text ist jetzt unter displayName.text und language als displayName.languageCode zugänglich. |
| Öffnungszeiten | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
Das Format von photos hat sich im neuen Place-Objekt geändert. 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-Zeitverschiebung | utc_offset |
utcOffsetMinutes |
|
| Kurzform der Adresse, einschließlich Straßenname und Ort | vicinity |
shortFormattedAddress |
|
| Website des Orts | website |
websiteUri |
|
| Informationen zur Barrierefreiheit für Rollstuhlfahrer | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance ist jetzt auf Platz accessibilityOptions.wheelchairAccessibleEntrance. |
| Attribute für Orte | 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 bisherigen API enthielt das Feld name den Ortsnamen als Textstring. In der neuen API finden Sie diese Informationen unter 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 alle anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Zahlungsoptionen, die am Standort akzeptiert werden | paymentOptions |
Neu | |
| Parkmöglichkeiten angeben | parkingOptions |
Neu | |
| Liste der untergeordneten Ziele, die sich auf den Ort beziehen | subDestinations |
Neu | |
| Aktuelle Informationen zu den Kraftstoffoptionen an einer Tankstelle | fuelOptions |
Neu | |
| Informationen zu Ladestationen für Elektrofahrzeuge an einem Ort | evChargeOptions |
Neu | |
| Attribute für Orte | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Neu |
Änderungen an Text Search-Antworten
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für die „Text Search (Legacy)“ und des Antwortobjekts für die „Text Search (New)“ aufgeführt. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Text Search (Legacy) | Text Search (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
Verschoben in das neue Ort-Objekt für jeden Ort als place.attributions |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Ortsobjekts |
|
| 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 Infomeldungen | 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 des Antwortobjekts für die Nearby Search (alte Version) und des Antwortobjekts für die Nearby Search (neue Version) aufgeführt. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Nearby Search (Legacy) | Nearby Search (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
Verschoben in das neue Ort-Objekt für jeden Ort als place.attributions |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Ortsobjekts |
|
| 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 Infomeldungen | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen an „Place Details (New)“-Antworten
In der folgenden Tabelle sind die Änderungen an den übergeordneten Feldern des Antwortobjekts für „Place Details (Legacy)“ und des Antwortobjekts für „Place Details (New)“ aufgeführt. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Place Details (Legacy) | Place Details (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
In das neue Ort-Objekt als attributions verschoben |
|
| Place Details (New) | result mit dem alten Ortsobjekt |
Das neue Ortsobjekt | |
| Status der Anfrage | status |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Infomeldungen | info_messages |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt |