Vorteile der Places API
Erstellen Sie standortbezogene Funktionen, um Ihren Nutzern ganz einfach detaillierte Standortdaten zur Verfügung zu stellen. Die über die Places API verfügbaren Daten basieren auf einer der genauesten, aktuellsten und Ortsmodelle der realen Welt. Hier einige Anwendungsbeispiele für Anwendungen:
- Anzeige von Eigentumswohnungen in großen Ballungsgebieten mit speziell auf Städte ausgerichteten Ergebnissen
- Geben Sie bei Updates des Abhol- oder Lieferstatus Details zum Ort an.
- Es wird eine Liste der Parks in einem Gebiet sowie von Nutzern eingereichte Fotos und Rezensionen angezeigt.
- Stellen Sie Nutzern, die eine Reise planen, unterwegs Kontaktinformationen, Rezensionen und Preisstufen von Unterkünften bereit.
Was kann ich mit der Places API tun?
Mit der Places API können Sie die folgenden Funktionen in Ihren Anwendungen:
- Stellen Sie Place Search-Ergebnisse aus verschiedenen Arten von Nutzeranfragen bereit, z. B. Texteingabe, Standorte in der Nähe und mehrdeutige oder kategoriale Nutzeranfragen.
- Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen aktivieren, z. B. für bestimmte Textanfragen oder kategoriale Suchanfragen.
- Verfeinern Sie die Art der Details, die zu einem Ort zurückgegeben werden, wie Öffnungszeiten, eine Zusammenfassung, Nutzerrezensionen und ein Foto.
- Fügen Sie Fotos in hoher Qualität zu Standorten hinzu, die von Ihrer Anwendung bereitgestellt werden.
Viele Google Maps Platform-APIs werden unterstützt place IDs: Die Orts-ID eindeutig. einen Ort in der Google Places-Datenbank und in Google Maps identifiziert. Es gibt verschiedene Möglichkeiten, eine Orts-ID abzurufen, 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 für eine bestimmte Einrichtung oder einen POI, wie z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertungen und Rezensionen.
Version der Places API auswählen
Die Places API unterstützt zwei API-Versionen: Places API sind die Vorhandene APIs und die Places API (Neu) sind die APIs-Versionen der nächsten Generation.
Mit der Veröffentlichung des Places API (New) müssen Sie als Erstes entscheiden, welche die zu verwendenden APIs. Dies gilt, wenn Sie Neukunde oder Bestandskunde sind die APIs bereits nutzen. Verwenden Sie in diesem Leitfaden. die Unterschiede zwischen den beiden APIs.
Funktionsweise der Places API
Places API (New)
Die Places API (New) akzeptiert Anfragen als Standard-URL mit einem bestimmten
Dienstendpunkt wie /places oder places:searchText
und gibt eine JSON-Antwort zurück. Places API (New) unterstützt Autorisierung durch
API-Schlüssel und OAuth-Token.
Im folgenden Beispiel wird eine „Place Details“-Anfrage gestellt, um die Adresskomponenten für eine
Orts-ID mit einem API-Schlüssel an:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API akzeptiert Anfragen als Standard-URL mit einem bestimmten
Dienstendpunkt wie /place oder /photo. Die Endpunkte
akzeptieren den in der Anfrage angegebenen Formattyp, entweder JSON oder XML. Dienst
verwendet Parameter, die für diesen spezifischen 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:
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 gibt die Adresskomponenten im JSON-Format zurück.
Ressourcen
In der folgenden Tabelle sind die Ressourcen aufgeführt, die über die Places API
| Places API | Places API (New) | Hinweis |
|---|---|---|
| Find Place | Textsuche (neu) | Es gibt keine neue Version von Find Place. Sie wurde durch „Text Search (New)“ ersetzt. |
| Nearby Search | Nearby Search (neu) | Für alle Anfragen mit der vorhandenen API, die eine Textabfrage enthalten, sollte Folgendes verwendet werden: Textsuche (neu) da „Nearby Search (New)“ die Texteingabe nicht unterstützt. |
| Textsuche | Textsuche (neu) | |
| Ortsdetails | Place Details (neu) | |
| Ortsfoto | Ortsfoto (Neu) | |
| Place Autocomplete | Automatische Vervollständigung (neu) | |
| Automatische Vervollständigung von Abfragen | Automatische Vervollständigung (neu) | Funktionen zur automatischen Vervollständigung (neu) |
Places API verwenden
Die folgenden Schritte behandeln ein typisches Anwendungsszenario für die Verwendung des Places API-Dienstes. Während Sie können Sie zusätzliche Endpunkte wie Nearby Search und Place Photos verwenden.| 1 | Einrichten | Beginnen Sie mit Ihre Google Cloud-Projekt und folgen Sie der Anleitung zur Einrichtung. Hier erfahren Sie, wie Sie Ihren API-Schlüssel verwenden. Für Places API (New) können Sie auch Folgendes verwenden: OAuth-Tokens. |
| 2 | Einfache Textsuche ausprobieren | Führen Sie eine einfache Textsuche mit Text Search (New) oder Textsuche: |
| 3 | Verwenden Sie die Orts-ID, um weitere Informationen zu erhalten. | Viele Google Maps Platform APIs geben im Rahmen einer Antwort eine Orts-ID zurück. Verwenden Sie die Methode Orts-ID, um Details zu einem Ort abzurufen. Weitere Informationen finden Sie unter Place Details (New) und Place Details. |
| 4 | Fotos von Orten aufnehmen | Mit dem Place Photo-Dienst können Sie auf die Millionen von Fotos zugreifen, die in den Places-Karten der Nutzer gespeichert sind. Datenbank. Die Funktion Place Photo (New) verwenden oder Place Details um auf Fotos für einen Ort zuzugreifen. |