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)

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 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 folgendem 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 umfasst zwei Such-APIs:

  • Textsuche (Neu)

    Ermöglicht es Ihnen, einen Textstring anzugeben, nach dem ein 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 Ortstypen 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 der Textsuche (neu) einen beliebigen Suchstring angeben können, während bei der Suche in der Nähe (neu) ein bestimmter Bereich erforderlich ist, in dem gesucht werden soll.

Autocomplete (New) 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 unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten für den Drive-through oder die 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 Ladegeräte 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 angezeigte Name des primären Typs, sofern zutreffend 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 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) umfasst die folgenden Felder für Barrierefreiheit:

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 Sitzplätze.

KI-basierte Zusammenfassungen

KI-basierte Zusammenfassungen in der Places API (neu) nutzen die Funktionen des Gemini-Modells, um Zusammenfassungen zu Orten und Gebieten zu erstellen, die Nutzern bei der Entscheidung helfen können, wohin sie gehen möchten.

KI-basierte Zusammenfassungen fassen Daten aus verschiedenen Quellen zusammen, um Nutzern dabei zu helfen, fundiertere Entscheidungen zu einem Ort zu treffen. Wenn Sie beispielsweise ein neues Restaurant ausprobieren möchten, kann eine KI-basierte Zusammenfassung häufige Highlights auf 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-basierte Zusammenfassung Ihnen einen Überblick über nahegelegene Sehenswürdigkeiten und Einrichtungen geben.

KI-basierte Funktionen in der Places API (Neu)

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 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.

Zu den neuen Places APIs migrieren

Wenn Sie bereits die Places API (New) nutzen und Ihre App auf die neuen APIs migrieren möchten, finden Sie hier die entsprechende Migrationsdokumentation: