Places API (New)

Die Places API (New) umfasst die folgenden APIs:

In diesem Dokument finden Sie eine Übersicht über diese neuen APIs.

Place Details (New)

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 POI anfordern, indem Sie eine Place Details (New)-Anfrage stellen. Bei einer Anfrage vom Typ „Place Details (New)“ 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 Photo (neu)

Mit der Place Photo (New) API können Sie Ihrer Anwendung hochwertige Fotos hinzufügen. Sie erhalten Zugriff auf die Millionen von Fotos, die in der Google Places-Datenbank gespeichert sind. Mit der Place Photo (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 Photo (New) API müssen den Namen einer Fotoressource enthalten, der das zurückzugebende Foto eindeutig identifiziert. So rufen Sie den Namen der Fotoressource ab:

Wenn Sie den Namen der Fotoressource 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 aufnehmen.

Text Search (New) und Nearby Search (New)

Die Places API umfasst zwei Such-APIs:

  • Text Search (Neu)

    Hier können Sie einen Textstring angeben, nach dem nach einem Ort gesucht werden soll. Beispiele: „Scharfe vegetarische Gerichte in Sydney, Australien“ oder „Feine Meeresfrüchteküche in der Nähe von Palo Alto, CA, USA“.

    Sie können die Suche eingrenzen, indem Sie Details wie Preisniveau, aktuellen Öffnungsstatus, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch angeben, dass die Ergebnisse auf einen bestimmten Standort ausgerichtet oder die Suche auf einen bestimmten Standort beschränkt werden sollen.

  • Nearby Search (Neu)

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

    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 Suchbereich angegeben werden muss.

Autocomplete (New) und Sitzungstokens

Autocomplete (New) ist ein Webdienst, der Ortsvorschläge und Suchanfragevorschläge als Reaktion auf eine HTTP-Anfrage zurückgibt. Geben Sie in der Anfrage einen Suchstring und geografische Grenzen an, die den Suchbereich festlegen.

Sitzungstokens sind von Nutzern generierte Strings, mit denen Autocomplete-Aufrufe vom Typ „Neu“ 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 (neu) enthält neue Felder, Attribute und Optionen für die Barrierefreiheit, um Nutzern mehr Informationen zu einem Ort zur Verfügung zu stellen. 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 Nebenöffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-Through-Bereichs oder der Lieferservice als sekundäre Öffnungszeiten angeben.
paymentOptions Zahlungsoptionen, die vom Standort akzeptiert werden. Für einen Ort kann mehr als eine Zahlungsoption akzeptiert werden. 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 vom Standort 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. So gelten beispielsweise Flughafenterminals als untergeordnete Ziele eines Flughafens.
fuelOptions Die neuesten Informationen zu den Kraftstoffoptionen an einer Tankstelle. Diese Informationen werden regelmäßig aktualisiert. Folgende Optionen sind verfügbar:
  • Diesel
  • Normales bleifreies Benzin
  • 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 jedes Ladegerät 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, visuell lesbare Adresse für einen Ort.
primaryType Der primäre Typ des 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.

Attribute

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

Attribut Beschreibung
outdoorSeating Es gibt Sitzgelegenheiten im Freien.
liveMusic Es gibt Livemusik.
menuForChildren Es gibt eine Kinderkarte.
servesCocktails Hier werden Cocktails serviert.
servesDessert Es werden Desserts serviert.
servesCoffee Hier wird Kaffee serviert.
goodForChildren Der Ort ist gut für Kinder.
allowsDogs Hunde sind in diesem Hotel erlaubt.
restroom Es gibt eine Toilette.
goodForGroups Der Ort bietet Platz für Gruppen.
goodForWatchingSports Der Ort eignet sich für Sportübertragungen.

Optionen für Bedienungshilfen

Die Places API (neu) enthält die folgenden Felder für Optionen zur Barrierefreiheit:

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

Zu den New Places APIs migrieren

Wenn Sie bereits die Places API nutzen und Ihre App auf die neuen APIs umstellen möchten, lesen Sie die folgende Migrationsdokumentation: