Vorteile der Places API
Erstellen Sie standortbezogene Funktionen, um Ihren Nutzern detaillierte Standortdaten zur Verfügung zu stellen. Die über die Places API verfügbaren Daten basieren auf einem der genauesten, aktuellsten und umfassendsten Ortsmodelle der realen Welt. Hier sind einige Anwendungsfälle für Anwendungen:
- Anzeigen für die Vermietung von Eigentumswohnungen in großen Ballungsräumen mit Ergebnissen, die speziell auf Städte ausgerichtet sind.
- Fügen Sie bei der Aktualisierung des Status für die Abholung oder Lieferung Details zum Ort hinzu.
- Eine Liste von Parks in einer Region mit von Nutzern eingereichten Fotos und Rezensionen anzeigen
- Stellen Sie Nutzern, die eine Reise planen, Kontaktdaten, Rezensionen und Preisniveaus für Unterkünfte entlang der Route zur Verfügung.
Was kann ich mit der Places API tun?
Mit der Places API können Sie die folgenden Funktionen in Ihre Anwendungen einbinden:
- Stellen Sie Suchergebnisse für Orte aus verschiedenen Arten von Nutzerabfragen bereit, z. B. aus Texteingaben, Standorten in der Nähe und mehrdeutigen oder kategorischen Nutzerabfragen.
- Aktivieren Sie die Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen, entweder für bestimmte Textabfragen oder kategorische Abfragen.
- Sie können die Art der zurückgegebenen Details zu einem Ort eingrenzen, z. B. Öffnungszeiten, eine Zusammenfassung, Nutzerrezensionen und ein Foto.
- Fügen Sie Orten, die von Ihrer App abgedeckt werden, hochwertige Fotos hinzu.
Viele Google Maps Platform APIs unterstützen Orts-IDs, mit denen ein Ort in der Google Places-Datenbank und auf Google Maps eindeutig identifiziert wird. Es gibt viele Möglichkeiten, eine Orts-ID zu erhalten, z. B. über die Places API, aber auch über die Geocoding API, die Routes API und die Address Validation API.
Sobald Sie eine Orts-ID haben, können Sie mit der Places API weitere Details zu einem bestimmten Unternehmen oder POI anfordern, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertung und Rezensionen.
Version der Places API auswählen
Die Places API unterstützt zwei API-Versionen: Die Places API sind die vorhandenen APIs und die Places API (neu) sind die Versionen der nächsten Generation.
Mit der Veröffentlichung der Places API (neu) müssen Sie zuerst entscheiden, welche APIs Sie verwenden möchten. Das gilt sowohl für neue als auch für bestehende Kunden, die die APIs bereits nutzen. In diesem Leitfaden erfahren Sie die wichtigsten Unterschiede zwischen den beiden APIs.
Funktionsweise der Places API
Places API (New)
Die Places API (neu) akzeptiert Anfragen als Standard-URL mit einem bestimmten Dienstendpunkt, z. B. /places oder places:searchText, und gibt eine JSON-Antwort zurück. Die Places API (neu) unterstützt die Autorisierung per API-Schlüssel und OAuth-Token.
Im folgenden Beispiel wird eine „Place Details“-Anfrage mit einem API-Schlüssel gesendet, um die Adresskomponenten für eine Orts-ID zurückzugeben:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Die Places API akzeptiert Anfragen als Standard-URL mit einem bestimmten Dienstendpunkt, z. B. /place oder /photo. Die Endpunkte akzeptieren auch das in der Anfrage angegebene Format, entweder JSON oder XML. Die Dienstanfrage verwendet Parameter, die für diesen bestimmten Endpunkt relevant sind, um die zurückgegebenen Daten zu verfeinern.
Im folgenden Beispiel wird eine Place Details-Anfrage gestellt, um die Adresskomponenten für eine Orts-ID im JSON-Format zurückzugeben:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
In diesem Fall verwendet der Dienst die angegebene Orts-ID, um den angeforderten Ort zu finden und die Adresskomponenten im JSON-Format zurückzugeben.
Ressourcen
In der folgenden Tabelle sind die über die Places API verfügbaren Ressourcen zusammengefasst.
| Places API | Places API (New) | Hinweis |
|---|---|---|
| Find Place | Text Search (Neu) | Es gibt keine neue Version von „Ort finden“. Sie wurde durch „Text Search (New)“ ersetzt. |
| Nearby Search | Nearby Search (Neu) | Alle Anfragen mit der vorhandenen API, die eine Textabfrage enthalten, sollten Text Search (New) verwenden, da die Nearby Search (New) keine Texteingabe unterstützt. |
| Text Search | Text Search (Neu) | |
| Place Details | Ortsdetails (neu) | |
| Ortsfoto | Ortsfoto (neu) | |
| Place Autocomplete | Automatische Vervollständigung (neu) | |
| Query Autocomplete | Automatische Vervollständigung (neu) | Dem Autocomplete-Dienst (neu) hinzugefügte Funktionen |
Places API verwenden
Die folgenden Schritte beschreiben einen typischen Anwendungsfall für die Verwendung des Places API-Dienstes. Wenn Sie Ihre Lösung entwickeln, können Sie zusätzliche Endpunkte wie Nearby Search und „Fotos von Orten“ verwenden.| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. Anschließend erfahren Sie, wie Sie Ihren API-Schlüssel verwenden. Für die Places API (New) können Sie auch OAuth-Tokens verwenden. |
| 2 | Grundlegende Textsuche ausprobieren | Führen Sie eine Textsuche mit Text Search (New) oder Text Search durch. |
| 3 | Orts-ID verwenden, um weitere Informationen zu erhalten | Viele Google Maps Platform APIs geben eine Orts-ID als Teil einer Antwort zurück. Verwenden Sie die Orts-ID, um Details zu einem Ort abzurufen. Weitere Informationen finden Sie unter Place Details (New) und Place Details. |
| 4 | Foto für einen Ort abrufen | Mit dem Place Photos-Dienst können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Verwenden Sie Place Photo (New) oder Place Details, um auf Fotos für einen Ort zuzugreifen. |