Das Antwortformat für die neuen APIs Place Details, Nearby Search und Text Search hat sich im Vergleich zum Format der vorhandenen APIs geändert. Der Hauptunterschied besteht im Format des Place-Objekts, das von den einzelnen Methoden zurückgegeben wird. Eine Beschreibung hierzu finden Sie unter Änderungen am Place-Antwortobjekt.
Außerdem wurden für jede API die Felder der obersten Ebene des Antwortobjekts geändert. Weitere Informationen:
- Änderungen der Text Search-Antwort
- Änderungen an der Nearby Search-Antwort
- Änderungen bei der „Place Details“-Antwort
Änderungen am „Place“-Antwortobjekt
In dieser Tabelle sehen Sie die Änderungen am neuen
Place-Objekt in der Antwort auf „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 platzieren | 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 |
|
| Quellenangaben für Orte | html_attributions |
attributions |
Oberstes Feld 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 |
|
| 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 und language als displayName.languageCode zugänglich |
| Öffnungszeiten | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
Das Format von photos im neuen Place-Objekt hat sich geändert. Weitere Informationen findest du 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 unter
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 Format „places/PLACE_ID“ |
In der vorhandenen API enthielt das Feld name den Ortsnamen als Textstring. In der neuen API befinden sich diese Informationen unter displayName. |
|
| Primärer Typ des Ortes | 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 | |
| Akzeptierte Zahlungsoptionen | paymentOptions |
Neu | |
| Parkplatzoptionen | parkingOptions |
Neu | |
| Liste der mit dem Ort verbundenen Unterziele | subDestinations |
Neu | |
| Neueste Informationen zu Kraftstoffoptionen an Tankstellen | fuelOptions |
Neu | |
| Informationen zum Aufladen von Elektrofahrzeugen für einen 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 sehen Sie die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für die vorhandene Methode „Text Search“ und das Antwortobjekt für „Text Search (New)“. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das Array places.
| Field | Textsuche (vorhanden) | Text Search (New) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
Werden in das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Array von Orten | results-Array des vorhandenen Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | status |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Fehlermeldungen | error_message |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Etwaige Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen der Nearby Search-Antwort
In der folgenden Tabelle sehen Sie die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für das vorhandene „Nearby Search“-Objekt und das Antwortobjekt 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 (New) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
Werden in das neue Place-Objekt
für jeden Ort als place.attributions verschoben |
|
| Array von Orten | results-Array des vorhandenen Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | status |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Fehlermeldungen | error_message |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Etwaige Infonachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen bei 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 | Ortsdetails (vorhanden) | „Place Details“ (Neu) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
Sie wurden als attributions in das neue Place-Objekt verschoben. |
|
| Ortsangaben | result mit dem vorhandenen Place-Objekt |
Das neue Place-Objekt | |
| Status der Anfrage | status |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Etwaige Infonachrichten | info_messages |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) |