Places API (New)

Die Places API (New) enthält die folgenden APIs:

In diesem Dokument erhalten Sie einen Überblick ü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 Gebäude oder POI anfordern, indem Sie eine Place Details (New)-Anfrage initiieren. Bei „Place Details (New)“-Anfragen 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:

Ortsfoto (Neu)

Mit der Place Photo (New) API können Sie Ihrer Anwendung qualitativ hochwertige fotografische Inhalte hinzufügen. Sie erhalten Zugriff auf Millionen von Fotos, die in der Datenbank „Google Places“ gespeichert sind. Mit der Place Photo (New) API können Sie auf die Fotos zugreifen und das Bild an die für Ihre Anwendung optimale Größe anpassen.

Alle Anfragen an die Place Photo (New) API müssen einen Fotoressourcennamen enthalten, der das zurückzugebende Foto eindeutig identifiziert. Sie können den Namen der Fotoressource folgendermaßen abrufen:

Wenn Sie den Namen der Fotoressource in die Antwort auf eine „Place Details (New)“-, „Text Search (New)“- oder „Nearby Search (New)“-Anfrage aufnehmen möchten, fügen Sie das Feld photos in die Feldmaske der Anfrage ein.

„Text Search (New)“ und „Nearby Search (New)“

Die Places API umfasst zwei Such-APIs:

  • Textsuche (neu)

    Geben Sie eine Textzeichenfolge an, anhand derer nach einem Ort gesucht werden soll. Beispiel: „Scharfes vegetarisches Essen in Sydney, Australien“ oder „Fein Meeresfrüchterestaurants in der Nähe von Palo Alto, CA“.

    Sie können die Suche verfeinern, indem Sie Details wie Preisniveaus, aktueller Öffnungsstatus, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch festlegen, dass die Ergebnisse nach einem bestimmten Standort gewichtet werden sollen, oder die Suche auf einen bestimmten Standort beschränken.

  • Nearby Search (neu)

    Hier können Sie eine Region für die Suche zusammen mit einer Liste von Ortstypen angeben. Geben Sie die Region als Kreis an, der durch die Breiten- und Längengradkoordinaten des Mittelpunkts und des Radius in Metern definiert ist.

    Geben Sie einen oder mehrere Ortstypen an, die die Merkmale des Ortes 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 Suchen besteht darin, dass Sie mit „Text Search (New)“ einen beliebigen Suchstring angeben können, während „Nearby Search (New)“ einen bestimmten Bereich für die Suche erfordert.

Autocomplete (New) und Sitzungstokens

Autocomplete (New) ist ein Webdienst, mit dem Ortsvorschläge und Suchanfragen als Antwort auf eine HTTP-Anfrage zurückgegeben werden. Geben Sie in der Anfrage einen Textsuchstring und geografische Grenzen an, die den Suchbereich steuern.

Sitzungstokens sind vom Nutzer erstellte Strings, die Aufrufe der automatischen Vervollständigung (Neu) als Sitzungen erfassen. Bei „Autocomplete (New)“ werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzersuche mit automatischer Vervollständigung zu Abrechnungszwecken in einer separaten Sitzung zu gruppieren.

Neue Felder, Attribute und Optionen für Bedienungshilfen

Die Places API (New) enthält neue Felder, Attribute und Optionen für Bedienungshilfen, mit denen Nutzer mehr Informationen zu einem Ort erhalten. Diese Aspekte werden in den folgenden Abschnitten beschrieben.

Felder

Die Places API (New) enthält mehrere neue Felder:

Field Beschreibung
regularSecondaryOpeningHours Beschreibt bestimmte Zeiten für bestimmte Vorgänge. Sekundäre Öffnungszeiten unterscheiden sich von den Hauptöffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise Drive-in- oder Lieferzeiten als sekundäre Öffnungszeiten angeben.
paymentOptions Akzeptierte Zahlungsoptionen In einem Geschäft können mehrere Zahlungsoptionen akzeptiert werden. Wenn keine Daten zur Zahlungsoption verfügbar sind, wird das Feld für die Zahlungsoption deaktiviert. Zu den Optionen gehören:
  • Kreditkarten
  • Debitkarte
  • Nur Barzahlung
  • NFC-Zahlung
parkingOptions Der Ort bietet Parkmöglichkeiten. Zu den Optionen gehören:
  • Kostenlose Parkplätze
  • Gebührenpflichtige Parkplätze
  • Kostenlose Parkplätze an der Straße
  • Einparkservice
  • Kostenlose Garagenparkplätze
  • Gebührenpflichtige Garagenparkplätze
subDestinations Eindeutige Orte, die mit einem bestimmten Ort verbunden sind. Beispielsweise gelten Flughafenterminals als Unterziele eines Flughafens.
fuelOptions Die neuesten Informationen zu den verfügbaren Kraftstoffoptionen an Tankstellen. Diese Informationen werden regelmäßig aktualisiert. Zu den Optionen gehören:
  • Diesel
  • Normal (ohne Bleistift)
  • 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 Ladegeräte für Elektrofahrzeuge haben zwar mehrere Anschlüsse, mit jedem Ladegerät kann jedoch jeweils nur ein Fahrzeug geladen werden. Daher spiegelt dieses Feld die Anzahl der verfügbaren Ladegeräte für Elektrofahrzeuge zu einem bestimmten Zeitpunkt wider.
shortFormattedAddress Eine kurze, visuell lesbare Adresse eines Ortes.
primaryType Der primäre Typ des jeweiligen Ergebnisses. Ein Ort kann beispielsweise als cafe oder airport klassifiziert werden. Ein Ort kann nur einen einzigen 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, ggf. 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 Im Hotel wird Livemusik geboten.
menuForChildren Der Ort hat eine Kinderkarte.
servesCocktails In diesem Lokal werden Cocktails serviert.
servesDessert Hier wird Dessert serviert.
servesCoffee In diesem Café wird Kaffee serviert.
goodForChildren Der Ort ist für Kinder geeignet.
allowsDogs In diesem Ort sind Hunde erlaubt.
restroom Es gibt eine Toilette.
goodForGroups Ort bietet Platz für Gruppen.
goodForWatchingSports Ort ist für Sportübertragungen geeignet.

Optionen für Bedienungshilfen

Die Places API (New) enthält die folgenden Optionsfelder für Bedienungshilfen:

Field Beschreibung
wheelchairAccessibleParking Der Ort bietet rollstuhlgerechte Parkplätze.
wheelchairAccessibleEntrance Der Ort hat einen rollstuhlgerechten Eingang.
wheelchairAccessibleRestroom Der Ort hat ein rollstuhlgerechtes WC.
wheelchairAccessibleSeating Es gibt rollstuhlgerechte Sitzgelegenheiten.

Zu den neuen Places APIs migrieren

Wenn Sie Places API-Kunde sind und Ihre Anwendung auf die neuen APIs migrieren möchten, finden Sie in der folgenden Migrationsdokumentation weitere Informationen: