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 Gebäuden, geografischen Standorten oder markanten POIs zurück.Gründe für die Verwendung der Places API (New)
Sie können standortbezogene Funktionen erstellen, 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. Hier sind einige Anwendungsbeispiele:
- Anzeigen von Mietwohnungen in großen Ballungsgebieten mit Ergebnissen, die speziell auf Städte ausgerichtet sind.
- Geben Sie in einem Update zum Abhol- oder Lieferstatus Details zum Ort an.
- Eine Liste mit Parks in einer Gegend zusammen mit von Nutzern eingereichten Fotos und Rezensionen anzeigen.
- Nutzer, die Reisen planen, erhalten Kontaktinformationen, Rezensionen und Preisniveaus für Einrichtungen entlang der Strecke.
Funktionen der Places API (neu)
Mit der Places API (New) können Sie die folgenden Funktionen in Ihre Anwendungen einbinden:
- Ortsbezogene Suchergebnisse für verschiedene Arten von Nutzeranfragen liefern, z. B. für Texteingaben, Orte in der Nähe und mehrdeutige oder kategorische Nutzeranfragen.
- Aktivieren Sie die Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen, entweder für bestimmte Textanfragen oder für kategorische Anfragen.
- Sie können den Typ der zurückgegebenen Details zu einem Ort eingrenzen, z. B. Öffnungszeiten, Zusammenfassung, Rezensionen von Nutzern und ein Foto.
- Fügen Sie den von Ihrer Anwendung unterstützten Standorten hochwertige Fotos hinzu.
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 (neu), 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 Gebäude oder POI abrufen, 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 gesendet, um die Adresskomponenten für eine Orts-ID mit einem API-Schlüssel zurückzugeben:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API (New) verwenden
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 wie „Nearby Search (New)“ und „Place Photos (New)“ verwenden.| 1 | Einrichten | Richten Sie die Abrechnung ein, aktivieren Sie die Places API (New) und senden Sie Ihre erste Anfrage. |
| 2 | Einfache Textsuche ausführen | Führen Sie eine Textsuche mit Text Search (New) durch. |
| 3 | Orts-ID für weitere Details verwenden | Viele Google Maps Platform APIs geben eine Orts-ID als Teil einer Antwort zurück. Mit Orts-IDs können Sie Ortsdetails (neu) abrufen. |
| 4 | Foto für einen Ort abrufen | Mit „Ortsfotos (Neu)“ können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Mit Place Photos (New) können Sie auf Fotos für einen Ort zugreifen. |