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 einem der genauesten, neuesten und umfassendsten 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 Ihre Anwendungen einbinden:
- Stellen Sie Ortssuchergebnisse aus verschiedenen Arten von Nutzeranfragen bereit, z. B. Texteingabe, Standorte in der Nähe und mehrdeutige oder kategorische Nutzeranfragen.
- Aktivieren Sie Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen, entweder für bestimmte Text- oder kategoriale Suchanfragen.
- Optimieren Sie die Art der zu einem Ort zurückgegebenen Details, z. B. Ö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 unterstützen Orts-IDs, bei denen ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert wird. 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 über die Places API weitere Details zu einer bestimmten Einrichtung oder einem 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 (New) ist die Version der nächsten Generation.
Mit der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs verwendet werden sollen. Dies gilt, wenn Sie Neukunde oder Bestandskunde sind und die APIs bereits verwenden. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs beschrieben.
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. Die Places API (New) unterstützt die Autorisierung per API-Schlüssel und OAuth-Token.
Im folgenden Beispiel wird eine „Place Details“-Anfrage gestellt, um die Adresskomponenten für eine Orts-ID mithilfe eines API-Schlüssels 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 den in der Anfrage angegebenen Formattyp, entweder JSON oder XML. Die Dienstanfrage verwendet für diesen bestimmten Endpunkt relevante Parameter, um die zurückgegebenen Daten zu optimieren.
Im folgenden Beispiel wird eine „Place Details“-Anfrage erstellt, 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.
Weitere Informationen
In der folgenden Tabelle sind die Ressourcen aufgeführt, die über die Places API verfügbar sind.
| Places API | Places API (New) | Hinweise |
|---|---|---|
| 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 und einer Textabfrage sollte Text Search (New) verwendet werden, da „Nearby Search (New)“ keine Texteingabe 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. Beim Ausbau Ihrer Lösung können Sie zusätzliche Endpunkte wie Nearby Search und Place Photos verwenden.| 1 | Jetzt einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der darauffolgenden Einrichtungsanleitung. Lesen Sie dann, wie Sie Ihren API-Schlüssel verwenden. Für die Places API (New) können Sie auch OAuth-Tokens verwenden. |
| 2 | Einfache Textsuche ausprobieren | Führen Sie eine einfache Textsuche mit Text Search (New) oder Text Search durch. |
| 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 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 in der Places-Datenbank zugreifen. Verwenden Sie Place Photo (New) oder Place Details, um auf Fotos für einen Ort zuzugreifen. |