Einführung
Das Antwortformat für
Place Details (New),
Nearby Search (New),
und
Text Search (New)
APIs hat sich im Vergleich zu den Legacy-APIs geändert. Der Hauptunterschied liegt im
Format des Place Objekts, das von jeder Methode zurückgegeben wird, wie unter
Änderungen am Antwortobjekt „Place“ beschrieben.
Außerdem haben sich die Felder der obersten Ebene des Antwortobjekts für jede API geändert. Weitere Informationen:
- Änderungen an der Antwort von „Text Search“
- Änderungen an der Antwort von „Nearby Search“
- Änderungen an der Antwort von „Place Details“
Änderungen am Antwortobjekt „Place“
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 Legacy
Place Objekt aufgeführt.
Das neue Antwortobjekt verwendet Camel-Case für Feldnamen, enthält neue Felder und benennt einige der Legacy-Felder um.
| Feld | Places API (Legacy)-Objekt | Places API (New)-Objekt | Hinweise |
|---|---|---|---|
| Adresskomponente | address_components |
addressComponents |
|
| Adresse im Mikroformat des Orts | adr_address |
adrFormatAddress |
|
| Unternehmensstatus | business_status |
businessStatus |
|
| Öffnungszeiten für nächste Woche | current_opening_hours |
currentOpeningHours |
|
| Redaktionelle Zusammenfassung | editorial_summary |
editorialSummary |
|
| Formatierte Adresse | formatted_address |
formattedAddress |
|
| Nationale 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 Legacy-APIs |
| Symbol-URL | icon |
Entfernt. Verwenden Sie 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 |
|
| Name des Orts im Text | name |
displayName |
Der Name des Orts im Text ist jetzt als displayName.text und
language als displayName.languageCode verfügbar. |
| Öffnungszeiten | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
Das Format von photos hat sich im neuen
Place Objekt geändert. Weitere Informationen finden Sie unter
Änderung an Fotoreferenzen. |
| 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 mit Straßenname und Ort | vicinity |
shortFormattedAddress |
|
| Website des Orts | website |
websiteUri |
|
| Informationen zur Rollstuhlgerechtigkeit | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance befindet sich jetzt unter
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 | Feld name im Format places/PLACE_ID |
In der Legacy-API enthielt das Feld name den Ortsnamen als Textstring. In der neuen API befinden sich diese Informationen unter
displayName. |
|
| Primärer Ortstyp | primaryTypeName |
Neu | |
| Primärer Ortstyp als Textstring | primaryTypeDisplayName |
Neu | |
| Regelmäßige sekundäre Öffnungszeiten pro Woche, mit Ausnahmen und allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Zahlungsoptionen, die der Ort akzeptiert | paymentOptions |
Neu | |
| Parkmöglichkeiten des Orts | parkingOptions |
Neu | |
| Liste der Unterziele, die mit dem Ort verknüpft sind | subDestinations |
Neu | |
| Aktuellste Informationen zu Kraftstoffoptionen an einer Tankstelle | fuelOptions |
Neu | |
| Informationen zu Ladestationen für Elektrofahrzeuge für einen Ort | evChargeOptions |
Neu | |
| Ortsattribute | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Neu |
Änderungen an der Antwort von „Text Search“
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des
Antwortobjekts
für „Text Search (Legacy)“ und des
Antwortobjekts
für „Text Search (New)“ aufgeführt. Für die neue API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Text Search (Legacy) | Text Search (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
Für jeden Ort in das neue Place-Objekt verschoben als place.attributions |
|
| Array von Orten | results array des Legacy-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) | |
| Alle Informationsnachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen an der Antwort von „Nearby Search“
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des Antwortobjekts
für „Nearby Search (Legacy)“ und des Antwortobjekts
für „Nearby Search (New)“ aufgeführt. Für die neue API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Nearby Search (Legacy) | Nearby Search (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
Für jeden Ort in das neue Place
Objekt verschoben als place.attributions |
|
| Array von Orten | results array des Legacy-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) | |
| Alle Informationsnachrichten | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen an der Antwort von „Place Details (New)“
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des Antwort
objekts
für „Place Details (Legacy)“ und des Antwort
objekts
für „Place Details (New)“ aufgeführt. Für die neue API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Place Details (Legacy) | Place Details (New) | Hinweise |
|---|---|---|---|
| Ortsangaben | html_attributions |
In das neue Place
Objekt verschoben als attributions |
|
| Place Details (New) | result mit dem Legacy-Place-Objekt |
Das neue Place-Objekt | |
| Status der Anfrage | status |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) | |
| Alle Informationsnachrichten | info_messages |
In die Standard-HTTP-Antwort verschoben (HTTP-Antwortcode und -Nachricht) |