Einführung
Das Antwortformat für die APIs Place Details (New), Nearby Search (New) und Text Search (New) hat sich im Vergleich zu den 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 der Textsuche
- Änderungen bei Antworten auf Nearby Search
- Änderungen bei „Place Details“-Antworten
Ä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 |
|
| Adressmikroformat für Orte | 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 Ortes 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 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ßennamen 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 | Feld name im Formular 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 platzieren | primaryTypeDisplayName |
Neu | |
| Regelmäßige wöchentliche sekundäre Öffnungszeiten mit Ausnahmen und allen anderen Daten | regularSecondaryOpeningHours |
Neu | |
| Vom Ort akzeptierte Zahlungsoptionen | paymentOptions |
Neu | |
| Parkmöglichkeiten angeben | parkingOptions |
Neu | |
| Liste der mit dem Ort verknüpften untergeordneten Ziele | subDestinations |
Neu | |
| Aktuelle Informationen zu Kraftstoffoptionen an einer Tankstelle | fuelOptions |
Neu | |
| Informationen zu Ladestationen für Elektrofahrzeuge an einem 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 |
In das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | 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 Antwortobjekts für Nearby Search (Legacy) und des Antwortobjekts 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 |
In das neue Place-Objekt für jeden Ort als place.attributions verschoben |
|
| Array von Orten | results-Array des alten Place-Objekts |
places-Array des neuen Place-Objekts |
|
| Status der Anfrage | 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 Legacy-Objekt Place |
Das neue Place-Objekt | |
| Status der Anfrage | 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) |