Das Antwortformat für die neue
Place Details,
Nearby Search,
und
Textsuche
Das Format der vorhandenen APIs hat sich geändert. Der Hauptunterschied besteht darin,
das Format des Place-Objekts, das von der jeweiligen Methode zurückgegeben wird, wie unter
Änderungen am Place-Antwortobjekt
Darüber hinaus enthalten die Felder der obersten Ebene des Antwortobjekts ebenfalls für jede API 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 an der neuen
Place-Objekt
in der Antwort für „Place Details (New)“
Nearby Search (New) und
„Text Search (New)“ im Vergleich zur bestehenden
Place-Objekt.
Das neue Antwortobjekt verwendet Feldnamen in der Camel-Case-Schreibweise für Feldnamen, enthält neue Felder, und benennt einige der vorhandenen Felder um.
| Feld | 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. iconMaskBaseUri und
iconBackgroundColor. Weitere Informationen finden Sie unter
Ortssymbole für
erhalten Sie weitere Informationen. |
|
| 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, mit Ausnahmen und alle 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 | Feld „name“ 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 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
Antwortobjekt
für die vorhandene „Text Search“- und die
Antwortobjekt
für „Text Search (New)“. 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 |
|---|---|---|---|
| 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 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)“. Für die neue API ist das einzige Feld der obersten Ebene im
Antwort ist das Array places.
| Feld | Nearby Search (vorhanden) | Nearby Search (New) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
An den neuen Ort verschoben
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 |
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 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)“. Für die neue API ist das einzige Feld der obersten Ebene im
Antwort ist das Array places.
| Feld | Ortsdetails (vorhanden) | „Place Details“ (Neu) | Hinweise |
|---|---|---|---|
| Quellenangaben für Orte | html_attributions |
An den neuen Ort verschoben
Objekt als attributions |
|
| Ortsdetails | 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) |