Die Places API (New) enthält die folgenden APIs:
- Place Details (neu)
- Ortsfoto (Neu)
- Nearby Search (neu)
- Textsuche (neu)
- Automatische Vervollständigung (neu)
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:
- Textsuche (neu)
- Nearby Search (neu)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
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 erhalten die Fotoressource 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:
-
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.
-
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:
|
parkingOptions |
Der Ort bietet Parkmöglichkeiten. Zu den Optionen gehören:
|
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:
|
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 gegebenen Ergebnisses. Zum Beispiel kann ein Ort
als cafe oder airport klassifiziert sein. A
Ort kann nur einen einzigen 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: