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 (New)

Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und auf 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 senden. Eine „Place Details (New)“-Anfrage gibt umfassende Informationen zum angegebenen Ort zurück, 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)

Place Photos (New) ermöglicht Ihnen das Hinzufügen hochwertiger Fotos zu Ihrer Anwendung, da Sie Zugriff auf die Millionen von Fotos in der Google Places-Datenbank haben. Mit der Place Photos (New) API können Sie auf die Fotos zugreifen und die Bildgröße für Ihre Anwendung optimieren.

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

Wenn Sie den Fotonamen in die Antwort einer „Place Details (New)“-, „Text Search (New)“- oder „Nearby Search (New)“- Anfrage einfügen möchten, müssen Sie das photos Feld in der Feldmaske der Anfrage angeben.

Text Search (New) und Nearby Search (New)

Die Places API umfasst zwei Such-APIs:

  • Text Search (New)

    Mit dieser API können Sie eine Textzeichenfolge angeben, nach der nach einem Ort gesucht werden soll. Beispiele: „Scharfes vegetarisches Essen in Sydney, Australien“ oder „Gutes Fischrestaurant in der Nähe von Palo Alto, Kalifornien“.

    Sie können die Suche verfeinern, indem Sie Details wie Preisklassen, aktuellen Öffnungsstatus, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch angeben, dass die Ergebnisse auf einen bestimmten Ort ausgerichtet oder die Suche auf einen bestimmten Ort beschränkt werden soll.

  • Nearby Search (New)

    Mit dieser API können Sie eine Region angeben, in der gesucht werden soll, sowie eine Liste von Ortstypen. Geben Sie die Region als Kreis an, der durch die Breiten- und Längengrad koordinaten des Mittelpunkts und den Radius in Metern definiert wird.

    Geben Sie einen oder mehrere Ortstypen an, die die Merkmale des Ortes definieren. Geben Sie beispielsweise „pizza_restaurant“ und „shopping_mall“ an, um nach einem Pizza-Restaurant in einem Einkaufszentrum in der angegebenen Region zu suchen.

Der Hauptunterschied zwischen den beiden Suchvorgängen besteht darin, dass Sie mit „Text Search (New)“ eine beliebige Suchzeichenfolge angeben können, während für „Nearby Search (New)“ ein bestimmter Bereich erforderlich ist, in dem gesucht werden soll.

Autocomplete (New) und Sitzungstokens

Autocomplete (New) ist ein Webdienst, der als Antwort auf eine HTTP-Anfrage Ortsvorschläge und Suchvorschläge zurückgibt. Geben Sie in der Anfrage eine Textsuchzeichenfolge und geografische Grenzen an, die den Suchbereich steuern.

Sitzungstokens sind von Nutzern generierte Strings, mit denen Autocomplete (New) Aufrufe als Sitzungen erfasst werden. Autocomplete (New) verwendet Sitzungstokens, um die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu einer separaten Sitzung zu Abrechnungszwecken zusammenzufassen.

Neue Felder, Attribute und Optionen für Bedienungshilfen

Die Places API (New) enthält neue Felder, Attribute und Optionen für Bedienungshilfen, um Nutzern mehr Informationen zu einem Ort zu geben. 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 Hauptöffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten für den Drive-in oder die Lieferzeiten als sekundäre Öffnungszeiten angeben.
paymentOptions Zahlungsoptionen, die der Ort akzeptiert. Ein Ort kann mehr als eine Zahlungsoption akzeptieren. Wenn keine Daten zu Zahlungsoptionen verfügbar sind, wird das Feld für die Zahlungsoption nicht festgelegt. Diese Optionen sind verfügbar:
  • Kreditkarte
  • Debitkarte
  • Nur Barzahlung
  • NFC-Zahlung
parkingOptions Parkmöglichkeiten, die der Ort bietet. Diese 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 Eindeutige Orte, die mit einem bestimmten Ort verknüpft sind. 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: die folgenden:
  • Diesel
  • Super
  • Super
  • Premium
  • SP91
  • Super 91 E10
  • SP92
  • Super 95 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 nur ein Fahrzeug gleichzeitig aufladen. Daher gibt dieses Feld die Anzahl der verfügbaren Ladestationen für Elektrofahrzeuge zu einem bestimmten Zeitpunkt an.
shortFormattedAddress Eine kurze, lesbare Adresse für einen Ort.
primaryType Der primäre Typ des angegebenen Ergebnisses. Ein Ort kann beispielsweise als cafe oder ein airport klassifiziert werden. Ein Ort kann nur einen primären Typ haben. Die vollständige Liste der möglichen Werte finden Sie unter Unterstützte Typen.
primaryTypeDisplayName Der Anzeigename des primären Typs, falls zutreffend in die Sprache der Anfrage lokalisiert. Die 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 Der Ort bietet Sitzgelegenheiten im Freien.
liveMusic Der Ort bietet Livemusik.
menuForChildren Der Ort hat eine Kinderkarte.
servesCocktails Der Ort serviert Cocktails.
servesDessert Der Ort serviert Desserts.
servesCoffee Der Ort serviert Kaffee.
goodForChildren Der Ort ist für Kinder geeignet.
allowsDogs Der Ort erlaubt Hunde.
restroom Der Ort hat 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 für Bedienungshilfen:

Feld Beschreibung
wheelchairAccessibleParking Der Ort bietet rollstuhlgerechte Parkplätze.
wheelchairAccessibleEntrance Der Ort hat einen rollstuhlgerechten Eingang.
wheelchairAccessibleRestroom Der Ort hat eine rollstuhlgerechte Toilette.
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-basierte Zusammenfassungen synthetisieren Daten aus einer Vielzahl von Eingaben, um Nutzern 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 eine Vorstellung von der Atmosphäre vermitteln oder Themen aus Nutzerrezensionen zusammenfassen. Wenn Sie eine neue Stadt besuchen, kann eine KI-basierte Zusammenfassung einen Überblick über nahe gelegene Sehenswürdigkeiten und Annehmlichkeiten bieten.

KI-basierte Funktionen, die der Places API (New) hinzugefügt wurden

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:

  • Ortszusammenfassungen, kurze Zusammenfassungen zu einem bestimmten Ort.
  • Rezensionszusammenfassungen: Verständliche Zusammenfassungen der Rezensionen zu einem Ort.
  • Gebietszusammenfassungen: Übersichten über nahe gelegene und beliebte Orte in der Umgebung. Dazu gehören Zusammenfassungen zu Stadtteilen und Ladestationen für Elektrofahrzeuge Zusammenfassungen.

Google generiert diese Zusammenfassungen häufig neu, damit sie frisch auf den neuesten verfügbaren Informationen basieren. Wenn Sie eine Anfrage an die Places API (New) senden, werden in Ihrer App die aktuellsten Daten angezeigt.

Zu den neuen Places APIs migrieren

Wenn Sie bereits Kunde der Places API (New) sind und Ihre App zu den neuen APIs migrieren möchten, finden Sie in der folgenden Migrationsdokumentation weitere Informationen: