Einführung
Die Places API ist ein Dienst, der HTTP-Anfragen für Standortdaten über verschiedene Methoden akzeptiert. Sie gibt formatierte Standortdaten und Bilder zu Unternehmen, geografischen Standorten oder markanten POIs zurück.Gründe für die Verwendung der Places API (New)
Erstellen Sie standortbezogene Funktionen, um Ihren Nutzern detaillierte Standortdaten zur Verfügung zu stellen. Die über die Places API (New) verfügbaren Daten basieren auf einem der genauesten, aktuellsten und umfassendsten Modelle der realen Welt. Beispielanwendungsfälle für Anwendungen:
- Anzeigen von Mietwohnungen in großen Ballungsräumen mit Ergebnissen speziell auf Städte ausgerichtet sind.
- Ortsdetails in eine Statusaktualisierung für die Abholung oder Lieferung einfügen.
- Eine Liste von Parks in einem Gebiet zusammen mit von Nutzern eingereichten Fotos und Rezensionen anzeigen.
- Personen, die Reisen planen, Kontaktdaten, Rezensionen, und Preisklassen für Unternehmen entlang der Strecke zur Verfügung stellen.
Funktionen der Places API (New)
Mit der Places API (New) können Sie die folgenden Funktionen in Ihre Anwendungen einbinden:
- Ortssuchergebnisse für verschiedene Arten von Nutzeranfragen bereitstellen, z. B. für Texteingaben, Orte in der Nähe und mehrdeutige oder kategoriale Nutzeranfragen.
- Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen aktivieren, entweder für bestimmte Textanfragen oder kategoriale Anfragen.
- Die Art der Details zu einem Ort verfeinern, z. B. Öffnungszeiten, eine Zusammenfassung, Nutzerrezensionen und ein Foto.
- Hochwertige Fotos zu Orten hinzufügen, die von Ihrer Anwendung bereitgestellt werden.
Viele Google Maps Platform APIs unterstützen Orts-IDs, mit denen ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert wird. Es gibt viele Möglichkeiten, eine Orts-ID zu erhalten, z. B. über die Places API (New), 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 (New) weitere Details zu einem bestimmten Unternehmen oder POI anfordern, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertung und Rezensionen.
Funktionsweise der Places API (New)
Die Places API (New) 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 (New) unterstützt die Autorisierung per API-Schlüssel und OAuth-Token.
Im folgenden Beispiel wird eine „Place Details (New)“-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
Verwendung der Places API (New)
Die folgenden Schritte beschreiben ein typisches Anwendungsfallszenario für die Verwendung des Places API-Dienstes. Beim Erstellen Ihrer Lösung können Sie zusätzliche Endpunkte verwenden, z. B. „Nearby Search (New)“ und „Place Photos (New)“.| 1 | Einrichten | Richten Sie die Abrechnung ein, aktivieren Sie die Places API (New) und stellen Sie Ihre erste Anfrage. |
| 2 | Einfache Textsuche ausprobieren | Führen Sie eine Textsuche mit „Text Search (New)“ aus. |
| 3 | Orts-ID für weitere Details verwenden | Viele Google Maps Platform APIs geben eine Orts-ID als Teil einer Antwort zurück. Verwenden Sie Orts-IDs, um „Place Details (New)“ abzurufen. |
| 4 | Foto für einen Ort abrufen | Mit „Place Photos (New)“ können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Verwenden Sie Place Photos (New), um auf Fotos für einen Ort zuzugreifen. |