Einführung
Das Antwortformat für die APIs Place Details (New), Nearby Search (New) und Text Search (New) hat sich gegenüber dem Format der alten 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 Antworten auf die Textsuche
- Änderungen bei Antworten auf Nearby Search
- Änderungen an der Antwort „Ortsdetails“
Änderungen am Antwortobjekt „Place“
In dieser Tabelle werden die Änderungen am neuen
Place-Objekt in der Antwort für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ im Vergleich zum alten
Place-Objekt dargestellt.
Das neue Antwortobjekt verwendet Camel-Casing für Feldnamen, enthält neue Felder und benennt einige der alten Felder um.
| Feld | Places API (Legacy)-Objekt | Places API (New)-Objekt | Hinweise |
|---|---|---|---|
| Adresskomponente | address_components |
addressComponents |
|
| Adresse im Mikroformat platzieren | 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 |
|
| Attributionen von Orten | html_attributions |
attributions |
Feld der obersten Ebene der Antwort in den Legacy-APIs |
| Symbol-URL | icon |
Entfernt. Verwende iconMaskBaseUri und iconBackgroundColor. Weitere Informationen finden Sie unter Orts-Symbole. |
|
| Symbolhintergrundfarbe | icon_background_color |
iconBackgroundColor |
|
| URL für Symbolmaske | icon_mask_base_uri |
iconMaskBaseUri |
|
| Internationale Telefonnummer | international_phone_number |
internationalPhoneNumber |
|
| Name des Orts im Text | name |
displayName |
Der Text-Ortsname 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 bei 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 |
|
| Differenz zu UTC | 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 ist jetzt unter accessibilityOptions.wheelchairAccessibleEntrance verfügbar. |
| 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 alten 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 angeben | primaryTypeDisplayName |
Neu | |
| Regelmäßige wöchentliche sekundäre Öffnungszeiten mit Ausnahmen und allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Zahlungsoptionen, die an diesem Ort akzeptiert werden | paymentOptions |
Neu | |
| Parkmöglichkeiten angeben | parkingOptions |
Neu | |
| Liste der untergeordneten Ziele, die mit dem Ort verknüpft sind | subDestinations |
Neu | |
| Aktuelle 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 bei „Text Search“-Antworten
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. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Text Search (Legacy) | Text Search (New) | Hinweise |
|---|---|---|---|
| Attributionen von Orten | html_attributions |
Für jeden Ort als place.attributions in das neue Place-Objekt verschoben |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status des Antrags | status |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) | |
| Alle Fehlermeldungen | error_message |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) | |
| Alle Informationsmeldungen | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen bei „Nearby Search“-Antworten
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des response-Objekts für Nearby Search (Legacy) und des response-Objekts für Nearby Search (New) aufgeführt. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Nearby Search (Legacy) | Nearby Search (New) | Hinweise |
|---|---|---|---|
| Attributionen von Orten | html_attributions |
Für jeden Ort wurde ein neues Place-Objekt als place.attributions erstellt. |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status des Antrags | status |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) | |
| Alle Fehlermeldungen | error_message |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) | |
| Alle Informationsmeldungen | info_messages |
Entfernt | |
| Seitentoken | next_page_token |
Entfernt |
Änderungen bei „Place Details (New)“-Antworten
In der folgenden Tabelle sind die Änderungen an den Feldern der obersten Ebene des Antwortobjekts für Place Details (Legacy) und des Antwortobjekts für Place Details (New) aufgeführt. Bei der neuen API ist das einzige Feld der obersten Ebene in der Antwort das places-Array.
| Feld | Place Details (Legacy) | Place Details (Neu) | Hinweise |
|---|---|---|---|
| Attributionen von Orten | html_attributions |
In das neue Place-Objekt als attributions verschoben |
|
| Place Details (Neu) | result mit dem alten Place-Objekt |
Das neue Place-Objekt | |
| Status des Antrags | status |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) | |
| Alle Informationsmeldungen | info_messages |
Verschoben in die Standard-HTTP-Antwort (HTTP-Antwortcode und ‑Meldung) |