Das Antwortformat für die neuen APIs Place Details, Nearby Search und Text Search hat sich gegenüber dem Format der vorhandenen APIs geändert. Der Hauptunterschied besteht im Format des Place-Objekts, das von jeder Methode zurückgegeben wird, wie unter Änderungen am Place-Objekt der Antwort beschrieben.
Außerdem wurden die Felder der obersten Ebene des Antwortobjekts für jede API geändert. Weitere Informationen:
- Änderungen an Text Search-Antworten
- Änderungen bei der Nearby Search-Antwort
- Änderungen bei der „Place Details“-Antwort
Änderungen am Place-Objekt der Antwort
In dieser Tabelle sehen Sie 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.
Das neue Antwortobjekt verwendet die Camel-Case-Schreibweise für Feldnamen, enthält neue Felder und benennt einige der vorhandenen Felder um.
| Field | Vorhandenes „Place“-Objekt | Neues Place-Objekt | Hinweise |
|---|---|---|---|
| Adresskomponente | address_components |
addressComponents |
|
| Mikroformat-Adresse für Ort | adr_address |
adrFormatAddress |
|
| Status des Unternehmens | business_status |
businessStatus |
|
| Öffnungszeiten für 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 |
Oberstes Feld der Antwort in den vorhandenen APIs |
| Symbol-URL | icon |
Entfernt. Verwenden Sie iconMaskBaseUri und iconBackgroundColor. Weitere Informationen finden Sie unter Ortssymbole. |
|
| Symbolhintergrundfarbe | icon_background_color |
iconBackgroundColor |
|
| URL für Symbolmaske | icon_mask_base_uri |
iconMaskBaseUri |
|
| Internationale Telefonnummer | international_phone_number |
internationalPhoneNumber |
|
| Text für Ortsname | name |
displayName |
Text-Ortsname ist jetzt als 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 findest du unter Zu Fotoreferenzen ändern. |
| 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 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 |
|
| Zeitverschiebung zu UTC | utc_offset |
utcOffsetMinutes |
|
| Kurzform der Adresse, einschließlich Straßenname und Ort | vicinity |
shortFormattedAddress |
|
| Website des Unternehmens | website |
websiteUri |
|
| Informationen zur Barrierefreiheit | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance findet jetzt zu
accessibilityOptions.wheelchairAccessibleEntrance statt |
| 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 | Feld „name“ im Formular „places/PLACE_ID“ |
In der vorhandenen API enthielt das Feld name den Ortsnamen als Textstring. In der neuen API befinden sich diese Informationen in displayName. |
|
| Primärer Ortstyp | primaryTypeName |
Neu | |
| Primären Typ als Textstring platzieren | primaryTypeDisplayName |
Neu | |
| Reguläre wöchentliche sekundäre Öffnungszeiten, mit Ausnahmen und allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Vom Händler akzeptierte Zahlungsoptionen | paymentOptions |
Neu | |
| Optionen für Parkplätze | parkingOptions |
Neu | |
| Liste der Unterziele des Orts | subDestinations |
Neu | |
| Aktuelle Informationen zu Tankstellen | fuelOptions |
Neu | |
| Informationen zu Ladestationen für Elektrofahrzeuge | evChargeOptions |
Neu | |
| Places-Attribute | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Neu |
Änderungen an Text Search-Antworten
In der folgenden Tabelle sehen Sie die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für die vorhandene Textsuche und des Antwortobjekts für „Text Search (New)“. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das Array places.
| Field | Text Search (vorhanden) | Text Search (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
In das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Mehrere Orte | results-Array des vorhandenen Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | status |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Fehlermeldungen | error_message |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Nearby Search-Antwortänderungen
In der folgenden Tabelle sehen Sie die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für das vorhandene „Nearby Search“-Objekt und des Antwortobjekts für „Nearby Search (New)“. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das Array places.
| Field | Nearby Search (vorhanden) | Nearby Search (neu) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
In das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Mehrere Orte | results-Array des vorhandenen Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | status |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Fehlermeldungen | error_message |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen der „Place Details“-Antwort
In der folgenden Tabelle sehen Sie die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für die vorhandenen „Place Details“-Anfragen und des Antwortobjekts für „Place Details (New)“. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das Array places.
| Field | „Place Details“ (vorhanden) | Place Details (neu) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
Als attributions in das neue Place-Objekt verschoben |
|
| Ortsdetails | result mit dem vorhandenen Place-Objekt |
Das neue Place-Objekt | |
| Status der Anfrage | status |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Infonachrichten | info_messages |
Zur Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) |