Einführung
Die Places API (New) umfasst die folgenden APIs:
- Place Details (New)
- Place Photos (New)
- Nearby Search (New)
- Text Search (New)
- Automatische Vervollständigung (neu)
Dieses Dokument enthält eine Übersicht über diese neuen APIs.
Place Details (New)
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 einer bestimmten Einrichtung oder einem bestimmten POI anfordern, indem Sie eine Place Details (New)-Anfrage stellen. Eine Place Details (New)-Anfrage gibt umfassende Informationen zum angegebenen Ort zurück, z. B. die vollständige Adresse, die Telefonnummer, die Nutzerbewertung und Rezensionen.
Es gibt viele Möglichkeiten, eine Orts-ID abzurufen. Sie können Folgendes angeben:
- Text Search (New)
- Nearby Search (New)
- Geocoding API
- Routes API
- Address Validation API
- Automatische Vervollständigung (neu)
Place Photos (New)
Mit Place Photos (New) können Sie Ihrer Anwendung hochwertige Fotos hinzufügen. Dazu haben Sie Zugriff auf Millionen von Fotos, die in der Google Places-Datenbank gespeichert sind. Mit der Place Photos (New) API können Sie auf die Fotos zugreifen und die Größe des Bildes auf die für Ihre Anwendung optimale Größe anpassen.
Alle Anfragen an die Place Photos (New) API müssen einen Namen für die Fotoressource enthalten, der das zurückzugebende Foto eindeutig identifiziert. Sie können den Namen der Fotoressource mit folgendem Befehl abrufen:
Wenn Sie den Namen der Fotoressource in die Antwort einer „Place Details (New)“-, „Text Search (New)“- oder „Nearby Search (New)“-Anfrage aufnehmen möchten, müssen Sie das Feld photos in die Feldmaske der Anfrage einfügen.
Text Search (New) und Nearby Search (New)
Die Places API (New) umfasst zwei Such-APIs:
-
Ermöglicht die Angabe eines Textstrings, nach dem ein Ort gesucht werden soll. Beispiele: „Scharfe vegetarische Gerichte in Sydney, Australien“ oder „Gute Meeresfrüchte-Restaurants in der Nähe von Palo Alto, Kalifornien“.
Sie können die Suche verfeinern, indem Sie Details wie Preisstufen, aktuelle Öffnungszeiten, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch festlegen, dass die Ergebnisse auf einen bestimmten Ort ausgerichtet oder die Suche auf einen bestimmten Ort beschränkt werden soll.
-
Sie können eine Region für die Suche und eine Liste von Ortstypen angeben. Geben Sie die Region als Kreis an, der durch die Breiten- und Längengradkoordinaten des Mittelpunkts und den Radius in Metern definiert ist.
Geben Sie einen oder mehrere Ortstypen an, die die Merkmale des Orts 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 Suchtypen besteht darin, dass Sie bei „Text Search (New)“ einen beliebigen Suchstring angeben können, während bei „Nearby Search (New)“ ein bestimmter Bereich für die Suche erforderlich ist.
Autocomplete (New) und Sitzungstokens
Autocomplete (New) ist ein Webdienst, der als Antwort auf eine HTTP-Anfrage Ortsvorschläge und Vervollständigungen für Suchanfragen zurückgibt. Geben Sie in der Anfrage einen Suchstring für die Textsuche und geografische Grenzen an, die den Suchbereich einschränken.
Sitzungstokens sind vom Nutzer generierte Strings, mit denen Autocomplete (New)-Aufrufe als Sitzungen erfasst werden. In Autocomplete (New) werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen.
Neue Felder, Attribute und Optionen für Bedienungshilfen
Die Places API (New) enthält neue Felder, Attribute und Optionen für die Barrierefreiheit, um Nutzern mehr Informationen zu einem Ort zu bieten. Diese Aspekte werden in den folgenden Abschnitten beschrieben.
Felder
Die Places API (New) enthält mehrere neue Felder:
| Feld | Beschreibung |
|---|---|
regularSecondaryOpeningHours |
Beschreibt bestimmte Zeiten für bestimmte Vorgänge. Die sekundären Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise Drive-in- oder Lieferzeiten als sekundäre Öffnungszeiten angeben. |
paymentOptions |
Zahlungsoptionen, die am Ort akzeptiert werden. An einem Ort können mehrere Zahlungsoptionen akzeptiert werden. Wenn keine Daten zur Zahlungsoption verfügbar sind, wird das Feld für die Zahlungsoption nicht festgelegt. Diese Optionen sind verfügbar:
|
parkingOptions |
Parkmöglichkeiten, die am Ort angeboten werden. Diese Optionen sind verfügbar:
|
subDestinations |
Einzigartige Orte, die mit einem bestimmten Ort in Verbindung stehen. Flughafenterminals gelten beispielsweise als Unterziele eines Flughafens. |
fuelOptions |
Die neuesten Informationen zu den an einer Tankstelle verfügbaren Kraftstoffoptionen. Diese Informationen werden regelmäßig aktualisiert. Diese Optionen sind verfügbar:
|
evChargeOptions |
Anzahl der Ladestationen für Elektrofahrzeuge an dieser Station. Einige Ladestationen für Elektrofahrzeuge haben mehrere Anschlüsse, aber jede Ladestation kann jeweils nur ein Fahrzeug laden. Daher gibt dieses Feld die Anzahl der verfügbaren Ladestationen für Elektrofahrzeuge zu einem bestimmten Zeitpunkt an. |
shortFormattedAddress |
Eine kurze, menschenlesbare Adresse für einen Ort. |
primaryType |
Der primäre Typ des angegebenen Ergebnisses. Ein Ort kann beispielsweise als cafe oder airport klassifiziert werden. Ein Ort kann nur einen 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, gegebenenfalls lokalisiert in die Sprache der Anfrage. Eine vollständige Liste der möglichen Werte finden Sie unter Unterstützte Typen. |
entrances |
Eingänge für das Ziel. Ein Eingang ist ein einzelnes Koordinatenpaar aus Breiten- und Längengrad, das die Position eines Ein- und Ausgangs für einen Ort definiert. |
navigationPoints |
Navigationspunkte für das Ziel. Ein Navigationspunkt ist ein Ort neben einer Straße, an dem die Navigation enden kann, einschließlich der unterstützten Mobilitätsformen und Verwendungen. |
Attribute
Die Places API (New) enthält mehrere neue Attribute:
| Attribut | Beschreibung |
|---|---|
outdoorSeating |
Das Unternehmen bietet Sitzgelegenheiten im Freien. |
liveMusic |
In diesem Unternehmen wird Livemusik geboten. |
menuForChildren |
Es gibt eine Speisekarte für Kinder. |
servesCocktails |
Hier werden Cocktails serviert. |
servesDessert |
Hier werden Desserts serviert. |
servesCoffee |
Hier wird Kaffee serviert. |
goodForChildren |
Der Ort ist für Kinder geeignet. |
allowsDogs |
Hunde sind erlaubt. |
restroom |
Es gibt eine Toilette. |
goodForGroups |
Der Ort ist für Gruppen geeignet. |
goodForWatchingSports |
Der Ort ist für Sportübertragungen geeignet. |
Optionen für Bedienungshilfen
Die Places API (New) enthält die folgenden Felder für Optionen zur Barrierefreiheit:
| Feld | Beschreibung |
|---|---|
wheelchairAccessibleParking |
Es gibt einen rollstuhlgerechten Parkplatz. |
wheelchairAccessibleEntrance |
Der Ort hat einen rollstuhlgerechten Eingang. |
wheelchairAccessibleRestroom |
Der Ort hat ein rollstuhlgerechtes WC. |
wheelchairAccessibleSeating |
Der Ort hat rollstuhlgerechte Sitzgelegenheiten. |
KI-basierte Zusammenfassungen
Die KI-basierten Zusammenfassungen der Places API (New) nutzen die Funktionen des Gemini-Modells, um Zusammenfassungen zu Orten und Gebieten zurückzugeben, die Nutzern bei der Entscheidung helfen können, wohin sie gehen möchten.
KI-gestützte Zusammenfassungen fassen Daten aus verschiedenen Quellen zusammen, damit Nutzer fundiertere Entscheidungen zu einem Ort treffen können. Wenn Sie beispielsweise ein neues Restaurant ausprobieren möchten, kann eine KI-basierte Zusammenfassung gängige Highlights der Speisekarte hervorheben, Ihnen einen Eindruck von der Atmosphäre vermitteln oder Themen aus Nutzerrezensionen zusammenfassen. Wenn Sie eine neue Stadt besuchen, kann eine KI-gestützte Zusammenfassung einen Überblick über nahe gelegene Sehenswürdigkeiten und Einrichtungen bieten.
KI-basierte Funktionen in der Places API (New)
KI-basierte Zusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt. Die folgenden KI-basierten Zusammenfassungen sind in Places API (New)-Antworten verfügbar:
- Zusammenfassungen für Orte: Kurze Übersichten zu einem bestimmten Ort.
- Rezensionsüberblicke, die eine Zusammenfassung der Rezensionen zu einem Ort enthalten.
- Gebietszusammenfassungen, die einen Überblick über beliebte Orte in der Nähe bieten. Dazu gehören Zusammenfassungen zu Stadtteilen und Ladestationen für Elektrofahrzeuge.
Google generiert diese Zusammenfassungen regelmäßig neu, damit sie auf den neuesten verfügbaren Informationen basieren. Wenn Sie eine Places API (New)-Anfrage stellen, werden in Ihrer App die neuesten Daten angezeigt.
Zur Places API (New) migrieren
Wenn Sie bereits die Places API (Legacy) verwenden und Ihre Anwendung auf die Places API (New) umstellen möchten, finden Sie in der folgenden Migrationsdokumentation weitere Informationen:
- Zu Place Details (New) migrieren
- Zu Nearby Search (New) migrieren
- Auf Text Search (New) migrieren
- Zu Place Photos (New) migrieren
- Auf Autocomplete (New) migrieren