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 Place ID können Sie Details zu einem bestimmten Unternehmen oder Point of Interest 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 das Bild 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 es Ihnen, eine Textzeichenfolge anzugeben, nach der nach einem Ort gesucht werden soll. Beispiele: „Scharfe vegetarische Gerichte in Sydney, Australien“ oder „Gourmet-Meeresfrüchte 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 Suchanfragen besteht darin, dass Sie bei Text Search (New) einen beliebigen Suchstring angeben können, während bei Nearby Search (New) ein bestimmter Bereich erforderlich ist, in dem gesucht werden soll.

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. Die sekundären Öffnungszeiten weichen von den regulären Öffnungszeiten eines Unternehmens ab. Ein Restaurant kann beispielsweise Drive-in- oder Lieferzeiten als sekundäre Öffnungszeiten angeben.
paymentOptions Zahlungsoptionen, die an diesem Ort akzeptiert werden. Ein Ort kann mehr als eine Zahlungsoption akzeptieren. Wenn keine Daten zur Zahlungsoption 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 Station. 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, falls zutreffend in der Sprache der Anfrage lokalisiert. 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. Er umfasst unterstützte Mobilitätsformen und Verwendungszwecke.

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 ist für Gruppen geeignet.
goodForWatchingSports Der Ort eignet sich für Sportübertragungen.

Optionen für Bedienungshilfen

Die Places API (New) umfasst 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

Bei KI-basierten Zusammenfassungen der Places API (neu) werden die Funktionen des Gemini-Modells verwendet, um Zusammenfassungen von 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-basierte Zusammenfassung Ihnen einen Überblick über nahegelegene Sehenswürdigkeiten und Einrichtungen geben.

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 Antworten der Places API (New) verfügbar:

Google generiert diese Zusammenfassungen häufig 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: