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 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 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 | 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 |
|
| Ortsattributionen | html_attributions |
attributions |
Feld der obersten Ebene der Antwort in den vorhandenen 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 |
|
| Differenz zu UTC | 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. |
| Ortsattribute | 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 allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Zahlungsoptionen, die vom 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 | |
| Ortsattribute | 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 vorhandene Textsuche und des Antwortobjekts für die neue Textsuche aufgeführt. Bei der neuen API ist das places-Array das einzige übergeordnete Feld in der Antwort.
| Feld | Text Search (Existing) | Text Search (New) | Hinweise |
|---|---|---|---|
| Ortsattributionen | html_attributions |
Für jeden Ort wurde das neue Ortsobjekt als place.attributions verschoben. |
|
| Array von Orten | results-Array des vorhandenen Orts-Objekts |
places-Array des neuen Orts-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 des Antwortobjekts für die vorhandene Nearby Search und des Antwortobjekts für Nearby Search (New) aufgeführt. 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 Orts-Objekts |
places-Array des neuen Orts-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 „Place Details“-Antworten
In der folgenden Tabelle sind die Änderungen an den übergeordneten Feldern des Antwortobjekts für die vorhandenen „Ortsdetails“ und des Antwortobjekts für „Ortsdetails (neu)“ aufgeführt. Bei der neuen API ist das places-Array das einzige Feld der obersten Ebene in der Antwort.
| Feld | Place Details (Existing) | Place Details (New) | Hinweise |
|---|---|---|---|
| Ortsattributionen | html_attributions |
Verschoben in das neue Ort-Objekt als attributions |
|
| Ortsdetails | result mit dem vorhandenen Ortsobjekt |
Das neue Ortsobjekt | |
| Status der Anfrage | status |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt | |
| Alle Infonachrichten | info_messages |
Zur standardmäßigen HTTP-Antwort (HTTP-Antwortcode und -Nachricht) gewechselt |