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 unter Google Maps Mit einer Orts-ID können Sie Details zu einer bestimmten Einrichtung oder POI durch Erstellen von Place Details (New) Eine „Place Details (New)“-Anfrage gibt umfassende Informationen zu den angegebenen Ort, wie 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 lassen sich qualitativ hochwertige fotografische Inhalte hinzufügen. auf die Millionen von Fotos zugreifen, die in der Google Places-Datenbank. Mit der Place Photo (New) API können Sie auf die Fotos und passen Sie die Größe des Bildes an die für Ihre Anwendung optimale Größe an.

Alle Anfragen an die Place Photo (New) API müssen den Namen einer Fotoressource, mit dem das zurückzugebende Foto eindeutig identifiziert wird. Sie können die Fotoressource herunterladen mit dem folgenden Befehl benennen:

So fügen Sie den Namen der Fotoressource in die Antwort von „Place Details (New)“ ein: „Text Search (New)“ oder „Nearby Search (New)“ verwenden möchten, stellen Sie sicher, dass Sie Das Feld photos in der Feldmaske der Anfrage.

„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. Hier einige Beispiele: „Scharfes vegetarisches Essen in Sydney, Australien“ oder „Gute Fischrestaurants in der Nähe von Palo Alto, CA.

    Sie können die Suche verfeinern, indem Sie Details wie Preisstufen, den aktuellen Öffnungsstatus, Bewertungen oder bestimmte Ortstypen. Sie können auch geben Sie an, dass die Ergebnisse nach einem bestimmten Standort gewichtet werden sollen, oder schränken Sie die Suche ein. an einen bestimmten Ort verschieben.

  • Nearby Search (neu)

    Hier können Sie eine Region für die Suche zusammen mit einer Liste von Ortstypen angeben. Region als durch Breiten- und Längengrad definierter Kreis angeben Koordinaten des Mittelpunkts und des Radius in Metern.

    Geben Sie einen oder mehrere Ortstypen an, um die Merkmale der Geben Sie beispielsweise „pizza_restaurant“ an. und "shopping_mall" bis nach einer Pizzeria in einem Einkaufszentrum im angegebenen Region

Der Hauptunterschied zwischen den beiden Suchanfragen besteht darin, dass Sie mit „Text Search (New)“ eine beliebige Suchzeichenfolge angeben, während Nearby Search (New) eine bestimmte Bereich, in dem gesucht werden soll.

Autocomplete (New) und Sitzungstokens

Autocomplete (New) ist ein Webdienst, mit dem Ortsvorschläge und als Antwort auf eine HTTP-Anfrage. Geben Sie in der Anfrage einen Text Suchzeichenfolge und geografischen Grenzen, die den Suchbereich steuern.

Sitzungstokens sind vom Nutzer erstellte Strings, die Aufrufe der automatischen Vervollständigung (Neu) erfassen als Sitzungen. Bei Autocomplete (New) werden Sitzungstokens verwendet, um die Anfrage zu gruppieren und der Auswahlphasen einer Suchanfrage durch automatische Vervollständigung in einer eigenständigen Sitzung Abrechnungszwecke.

Neue Felder, Attribute und Optionen für Bedienungshilfen

Neue Felder, Attribute und Optionen für Bedienungshilfen in der Places API (New) um Nutzern weitere Informationen zu einem Ort zu bieten. Diese Aspekte sind die in den folgenden Abschnitten beschrieben werden.

Felder

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

Feld Beschreibung
regularSecondaryOpeningHours Beschreibt bestimmte Zeiten für bestimmte Vorgänge. Sekundär Öffnungszeiten unterscheiden sich von denen eines Unternehmens. Für Beispiel: Ein Restaurant kann Drive-through-Öffnungszeiten oder einen Lieferservice angeben. Stunden als sekundäre Öffnungszeiten festlegen.
paymentOptions Akzeptierte Zahlungsoptionen Ein Ort kann mehr als eine Zahlungsoption. Wenn keine Daten zur Zahlungsoption verfügbar sind, Die Festlegung des Felds für die Zahlungsoption wird aufgehoben. Zu den Optionen gehören:
  • Kreditkarte
  • 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. Für Beispiel: Flughafenterminals gelten als Unterziele eines Flughafen.
fuelOptions Die neuesten Informationen zu den verfügbaren Kraftstoffoptionen Tankstellen. Diese Informationen werden regelmäßig aktualisiert. Zu den Optionen gehören Folgendes:
  • 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. Während haben manche Ladegeräte für Elektrofahrzeuge mehrere Anschlüsse. Jedes Ladegerät kann nur jeweils nur ein Fahrzeug laden; Daher spiegelt dieses Feld den Wert Anzahl verfügbarer Ladestationen für Elektrofahrzeuge.
shortFormattedAddress Eine kurze, visuell lesbare Adresse eines Ortes.
primaryType Der primäre Typ des jeweiligen Ergebnisses. Zum Beispiel kann ein Ort als cafe oder airport klassifiziert sein. A Ort kann nur einen primären Typ haben. Eine vollständige Liste aller Mögliche Werte finden Sie unter Unterstützte Typen.
primaryTypeDisplayName Der Anzeigename des primären Typs, lokalisiert in der Anfrage Sprache, falls zutreffend. Die vollständige Liste der möglichen Werte Siehe 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:

Feld 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 migrieren möchten zu die neuen APIs verwenden, finden Sie in der folgenden Migrationsdokumentation: