Places API (New)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

Die Places API (New) umfasst die folgenden APIs:

Dieses Dokument enthält eine Übersicht über diese neuen APIs.

Place Details (Neu)

Eine Orts-ID identifiziert einen Ort in der Google Places-Datenbank und in Google Maps eindeutig. 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. Bei einer Place Details (New)-Anfrage 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:

Place Photos (New)

Mit Place Photos (New) können Sie Ihrer Anwendung qualitativ hochwertige Fotos hinzufügen, indem Sie auf die Millionen von Fotos in der Google Places-Datenbank zugreifen. Mit der Place Photos (New) API können Sie auf die Fotos zugreifen und die Bilder auf die für Ihre Anwendung optimale Größe skalieren.

Alle Anfragen an die Place Photos (New) API müssen einen Fotonamen enthalten, der das zurückzugebende Foto eindeutig identifiziert. Sie können den Namen der Fotoressource mit dem folgenden Befehl abrufen:

Wenn Sie den Fotonamen 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:

  • Text Search (Neu)

    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 Preisklassen, aktuelle Öffnungszeiten, Bewertungen oder bestimmte Arten von Orten angeben. Sie können die Ergebnisse auch auf einen bestimmten Ort ausrichten oder die Suche auf einen bestimmten Ort beschränken.

  • Nearby Search (New)

    Hiermit können Sie eine Region für die Suche sowie 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 wird.

    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 der Textsuche (New) einen beliebigen Suchstring angeben können, während bei der Nearby Search (New) ein bestimmter Bereich für die Suche erforderlich ist.

Autocomplete (neu) und Sitzungstokens

Autocomplete (New) ist ein Webdienst, der Orts- und Suchvorschläge als Reaktion auf eine HTTP-Anfrage zurückgibt. Geben Sie in der Anfrage einen Textsuchstring und geografische Grenzen an, um den Suchbereich zu steuern.

Sitzungstokens sind nutzergenerierte Strings, mit denen Autocomplete (New)-Aufrufe als Sitzungen erfasst werden. Bei 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 Bedienungshilfen

Die Places API (New) enthält neue Felder, Attribute und Barrierefreiheitsoptionen, um Nutzern mehr Informationen zu einem Ort zu liefern. 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. Sekundäre Ö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 zu Zahlungsoptionen verfügbar sind, wird das Feld für die Zahlungsoption nicht festgelegt. Folgende Optionen sind verfügbar:
  • Kreditkarte
  • Debitkarte
  • Nur Barzahlung
  • NFC-Zahlung
parkingOptions Parkmöglichkeiten, die von der Unterkunft angeboten werden. Folgende Optionen sind verfügbar:
  • Kostenlose Parkplätze
  • Gebührenpflichtige Parkplätze
  • Kostenlose Parkplätze an der Straße
  • Einparkservice
  • Kostenloses Parkhaus
  • Gebührenpflichtiges Parkhaus
subDestinations Einzigartige Orte, die mit einem bestimmten Ort in Verbindung stehen. Flughafenterminals gelten beispielsweise als untergeordnete Ziele eines Flughafens.
fuelOptions Die neuesten Informationen zu den an einer Tankstelle verfügbaren Kraftstoffoptionen. Diese Informationen werden regelmäßig aktualisiert. Folgende Optionen sind verfügbar:
  • Diesel
  • Normalbenzin
  • Super
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • Methan
  • Biodiesel
  • Lkw-Diesel
evChargeOptions Anzahl der Ladestationen für Elektrofahrzeuge an dieser Tankstelle. Einige Ladestationen für Elektrofahrzeuge haben zwar mehrere Anschlüsse, aber jede Ladestation kann jeweils nur ein Fahrzeug aufladen. 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 zum Ziel. Ein Eingang ist ein einzelnes Breiten-/Längengrad-Koordinatenpaar, das den Standort eines Ein- und Ausgangspunkts 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 Es gibt Sitzgelegenheiten im Freien.
liveMusic Hier gibt es Livemusik.
menuForChildren Es gibt eine Speisekarte für Kinder.
servesCocktails Hier werden Cocktails serviert.
servesDessert Hier wird Dessert serviert.
servesCoffee Hier wird Kaffee serviert.
goodForChildren Der Ort ist gut für Kinder geeignet.
allowsDogs Hunde sind erlaubt.
restroom Es gibt eine Toilette.
goodForGroups Die Unterkunft bietet Platz für Gruppen.
goodForWatchingSports Der Ort eignet sich für Sportübertragungen.

Optionen für Bedienungshilfen

Die Places API (New) enthält die folgenden Felder für Barrierefreiheitsoptionen:

Feld Beschreibung
wheelchairAccessibleParking Der Ort bietet rollstuhlgerechte Parkplätze.
wheelchairAccessibleEntrance Der Ort hat einen rollstuhlgerechten Eingang.
wheelchairAccessibleRestroom Der Ort verfügt über ein rollstuhlgerechtes WC.
wheelchairAccessibleSeating Der Ort verfügt über 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-basierte 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 häufige Menü-Highlights 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 nahegelegene 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 den Antworten der Places API (New) verfügbar:

  • Zusammenfassungen für Orte: Kurze Zusammenfassungen zu einem bestimmten Ort.
  • Rezensionsüberblicke: Das sind leicht verständliche Zusammenfassungen der Rezensionen zu einem Ort.
  • Gebietszusammenfassungen mit Übersichten über nahegelegene und beliebte Orte in der Umgebung. Dazu gehören Zusammenfassungen von 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 aktuellsten Daten angezeigt.

Zur Places API (New) migrieren

Wenn Sie bereits die Places API (Legacy) nutzen und Ihre App zur Verwendung der Places API (New) migrieren möchten, lesen Sie die folgende Migrationsdokumentation: