Informationen zu den neuen Places APIs

Die neue Places API umfasst die folgenden APIs:

Dieses Dokument bietet einen Überblick über diese neuen APIs.

Place Details API

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 einer bestimmten Einrichtung oder einem POI anfordern, indem Sie eine Anfrage vom Typ Place Details (New) 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 verschiedene Möglichkeiten, eine Orts-ID zu erhalten. Sie können Folgendes angeben:

Place Photo API

Mit der Place Photo (New) API können Sie Ihrer App hochwertige Fotos hinzufügen. Sie erhalten dadurch Zugriff auf 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 sie an die optimale Größe für Ihre Anwendung anpassen.

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

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 einfügen.

„Text Search“ und „Nearby Search“

Die Places API umfasst zwei Such-APIs:

  • Text Search (Neu)

    Hier können Sie eine Textzeichenfolge angeben, anhand derer nach einem Ort gesucht werden soll. Beispiele: „Vegetarisches Essen in Sydney“ oder „Gourmetrestaurant in der Nähe von Palo Alto, Kalifornien“.

    Sie können die Suche verfeinern, indem Sie Details wie Preisstufen, den aktuellen Eröffnungsstatus, Bewertungen oder bestimmte Ortstypen angeben. Sie können auch festlegen, dass die Ergebnisse nach einem bestimmten Standort gewichtet oder die Suche auf einen bestimmten Standort beschränkt werden soll.

  • Nearby Search (neu)

    Sie können eine Region, nach der gesucht werden soll, sowie eine Liste von Ortstypen angeben. Geben Sie die Region als Kreis an, der durch die Breiten- und Längengradkoordinaten des Mittelpunkts sowie 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 zu suchen, die sich in einem Einkaufszentrum in der angegebenen Region befindet.

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

Autocomplete API und Sitzungstokens

Die Autocomplete (New) API ist ein Webdienst, der Orts- und Abfragevorhersagen als Antwort auf eine HTTP-Anfrage zurückgibt. Geben Sie in der Anfrage einen Suchstring für Text sowie geografische Grenzen an, die den Suchbereich steuern.

Sitzungstokens sind vom Nutzer erstellte Strings, die Aufrufe der automatischen Vervollständigung (New) als Sitzungen erfassen. Die Funktion „Autocomplete (New)“ verwendet Sitzungstokens, um die Abfrage- und Auswahlphasen einer automatischen Vervollständigung durch den Nutzer 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 regulären Öffnungszeiten eines Unternehmens. Beispielsweise kann ein Restaurant als sekundäre Öffnungszeiten Drive-in- oder Lieferzeiten angeben.
paymentOptions Vom Ort akzeptierte Zahlungsoptionen An einem Ort können mehrere Zahlungsoptionen akzeptiert werden. Wenn keine Daten zu Zahlungsoptionen verfügbar sind, wird die Festlegung des Felds für die Zahlungsoption aufgehoben. Zu den Optionen gehören:
  • Kreditkarten
  • Debitkarte
  • Nur Barzahlung
  • NFC-Zahlung
parkingOptions Parkmöglichkeiten sind vorhanden. 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 einen Bezug zu einem bestimmten Ort haben. Flughafenterminals sind beispielsweise untergeordnete Ziele eines Flughafens.
fuelOptions Die neuesten Informationen zu Tankstellen. Diese Informationen werden regelmäßig aktualisiert. Zu den Optionen gehören:
  • Diesel
  • Normales Produkt ohne Lead-Angabe
  • Super
  • Premium-Support
  • 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 mehrere Anschlüsse, aber jedes Ladegerät kann jeweils nur ein Fahrzeug laden. Daher enthält dieses Feld die Anzahl der verfügbaren Ladegeräte für Elektrofahrzeuge zu einem bestimmten Zeitpunkt.
shortFormattedAddress Eine kurze, visuell lesbare Adresse eines Ortes.
primaryType Der primäre Typ des gegebenen 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, gegebenenfalls lokalisiert für die Anfragesprache. 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 Ort wird Livemusik geboten.
menuForChildren Es gibt eine Kinderkarte.
servesCocktails In der Bar werden Cocktails serviert.
servesDessert Es wird ein Dessert serviert.
servesCoffee Hier wird Kaffee serviert.
goodForChildren Der Ort ist für Kinder geeignet.
allowsDogs Hier sind Hunde erlaubt.
restroom Es gibt eine Toilette.
goodForGroups Ort bietet Platz für Gruppen.
goodForWatchingSports Der Ort eignet sich für Sportübertragungen.

Optionen für Bedienungshilfen

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

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

Zu den neuen Places APIs migrieren

Wenn Sie Places API-Kunde sind und Ihre Anwendung migrieren möchten, um die neuen APIs zu verwenden, lesen Sie die folgende Migrationsdokumentation: