Die Places API (New) enthält die folgenden APIs:
- Place Details (neu)
- Ortsfoto (neu)
- Nearby Search (neu)
- Textsuche (neu)
- Automatische Vervollständigung (neu)
In diesem Dokument erhalten Sie einen Überblick über diese neuen APIs.
„Place Details“ (Neu)
Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Mit einer Orts-ID können Sie Details zu einem bestimmten Gebäude oder POI anfordern, indem Sie eine Place Details (New)-Anfrage initiieren. Bei „Place Details (New)“-Anfragen werden umfassende Informationen zum angegebenen Ort zurückgegeben, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertung und Rezensionen.
Es gibt viele Möglichkeiten, eine Orts-ID zu erhalten. Sie können Folgendes angeben:
- Textsuche (neu)
- Nearby Search (neu)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
Ortsfoto (Neu)
Mit der Place Photo (New) API können Sie Ihrer Anwendung qualitativ hochwertige fotografische Inhalte hinzufügen. Sie erhalten Zugriff auf Millionen von Fotos, die in der Datenbank „Google Places“ gespeichert sind. Mit der Place Photo (New) API können Sie auf die Fotos zugreifen und das Bild an die für Ihre Anwendung optimale Größe anpassen.
Alle Anfragen an die Place Photo (New) API müssen einen Fotoressourcennamen enthalten, der das zurückzugebende Foto eindeutig identifiziert. Sie können den Namen der Fotoressource folgendermaßen abrufen:
Wenn Sie den Namen der Fotoressource in die Antwort auf eine „Place Details (New)“-, „Text Search (New)“- oder „Nearby Search (New)“-Anfrage aufnehmen möchten, fügen Sie das Feld photos
in die Feldmaske der Anfrage ein.
„Text Search (New)“ und „Nearby Search (New)“
Die Places API umfasst zwei Such-APIs:
-
Geben Sie eine Textzeichenfolge an, anhand derer nach einem Ort gesucht werden soll. Beispiel: „Scharfes vegetarisches Essen in Sydney, Australien“ oder „Fein Meeresfrüchterestaurants in der Nähe von Palo Alto, CA“.
Sie können die Suche verfeinern, indem Sie Details wie Preisniveaus, aktueller Öffnungsstatus, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch festlegen, dass die Ergebnisse nach einem bestimmten Standort gewichtet werden sollen, oder die Suche auf einen bestimmten Standort beschränken.
-
Hier können Sie eine Region für die Suche zusammen mit einer Liste von Ortstypen angeben. Geben Sie die Region als Kreis an, der durch die Breiten- und Längengradkoordinaten des Mittelpunkts und des Radius in Metern definiert ist.
Geben Sie einen oder mehrere Ortstypen an, die die Merkmale des Ortes definieren. Geben Sie beispielsweise "
pizza_restaurant
" und "shopping_mall
" an, um nach einer Pizzeria in einem Einkaufszentrum in der angegebenen Region zu suchen.
Der Hauptunterschied zwischen den beiden Suchen besteht darin, dass Sie mit „Text Search (New)“ einen beliebigen Suchstring angeben können, während „Nearby Search (New)“ einen bestimmten Bereich für die Suche erfordert.
Autocomplete (New) und Sitzungstokens
Autocomplete (New) ist ein Webdienst, mit dem Ortsvorschläge und Suchanfragen als Antwort auf eine HTTP-Anfrage zurückgegeben werden. Geben Sie in der Anfrage einen Textsuchstring und geografische Grenzen an, die den Suchbereich steuern.
Sitzungstokens sind vom Nutzer erstellte Strings, die Aufrufe der automatischen Vervollständigung (Neu) als Sitzungen erfassen. Bei „Autocomplete (New)“ werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzersuche mit automatischer Vervollständigung zu Abrechnungszwecken in einer separaten Sitzung zu gruppieren.
Neue Felder, Attribute und Optionen für Bedienungshilfen
Die Places API (New) enthält neue Felder, Attribute und Optionen für Bedienungshilfen, mit denen Nutzer mehr Informationen zu einem Ort erhalten. Diese Aspekte werden in den folgenden Abschnitten beschrieben.
Felder
Die Places API (New) enthält mehrere neue Felder:
Field | Beschreibung |
---|---|
regularSecondaryOpeningHours |
Beschreibt bestimmte Zeiten für bestimmte Vorgänge. Sekundäre Öffnungszeiten unterscheiden sich von den Hauptöffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise Drive-in- oder Lieferzeiten als sekundäre Öffnungszeiten angeben. |
paymentOptions |
Akzeptierte Zahlungsoptionen In einem Geschäft können mehrere Zahlungsoptionen akzeptiert werden. Wenn keine Daten zur Zahlungsoption verfügbar sind, wird das Feld für die Zahlungsoption deaktiviert. Zu den Optionen gehören:
|
parkingOptions |
Der Ort bietet Parkmöglichkeiten. Zu den Optionen gehören:
|
subDestinations |
Eindeutige Orte, die mit einem bestimmten Ort verbunden sind. Beispielsweise gelten Flughafenterminals als Unterziele eines Flughafens. |
fuelOptions |
Die neuesten Informationen zu den verfügbaren Kraftstoffoptionen an Tankstellen. Diese Informationen werden regelmäßig aktualisiert. Zu den Optionen gehören:
|
evChargeOptions |
Anzahl der Ladestationen für Elektrofahrzeuge an dieser Station. Einige Ladegeräte für Elektrofahrzeuge haben zwar mehrere Anschlüsse, mit jedem Ladegerät kann jedoch jeweils nur ein Fahrzeug geladen werden. Daher spiegelt dieses Feld die Anzahl der verfügbaren Ladegeräte für Elektrofahrzeuge zu einem bestimmten Zeitpunkt wider. |
shortFormattedAddress |
Eine kurze, visuell lesbare Adresse eines Ortes. |
primaryType |
Der primäre Typ des jeweiligen Ergebnisses. Ein Ort kann beispielsweise als cafe oder airport klassifiziert werden. Ein Ort kann nur einen einzigen primären Typ haben. Eine vollständige Liste der möglichen Werte finden Sie unter Unterstützte Typen. |
primaryTypeDisplayName |
Der Anzeigename des primären Typs, ggf. in der Sprache der Anfrage lokalisiert. Eine vollständige Liste der möglichen Werte finden Sie unter Unterstützte Typen. |
Attribute
Die Places API (New) enthält mehrere neue Attribute:
Attribut | Beschreibung |
---|---|
outdoorSeating |
Es gibt Sitzgelegenheiten im Freien. |
liveMusic |
Im Hotel wird Livemusik geboten. |
menuForChildren |
Der Ort hat eine Kinderkarte. |
servesCocktails |
In diesem Lokal werden Cocktails serviert. |
servesDessert |
Hier wird Dessert serviert. |
servesCoffee |
In diesem Café wird Kaffee serviert. |
goodForChildren |
Der Ort ist für Kinder geeignet. |
allowsDogs |
In diesem Ort sind Hunde erlaubt. |
restroom |
Es gibt eine Toilette. |
goodForGroups |
Ort bietet Platz für Gruppen. |
goodForWatchingSports |
Ort ist für Sportübertragungen geeignet. |
Optionen für Bedienungshilfen
Die Places API (New) enthält die folgenden Optionsfelder für Bedienungshilfen:
Field | Beschreibung |
---|---|
wheelchairAccessibleParking |
Der Ort bietet rollstuhlgerechte Parkplätze. |
wheelchairAccessibleEntrance |
Der Ort hat einen rollstuhlgerechten Eingang. |
wheelchairAccessibleRestroom |
Der Ort hat ein rollstuhlgerechtes WC. |
wheelchairAccessibleSeating |
Es gibt rollstuhlgerechte Sitzgelegenheiten. |
Zu den neuen Places APIs migrieren
Wenn Sie Places API-Kunde sind und Ihre Anwendung auf die neuen APIs migrieren möchten, finden Sie in der folgenden Migrationsdokumentation weitere Informationen: