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 in 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.
Funktionsweise der 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 Anfrage vom Typ „Place Details (New)“ 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 verwenden
Die folgenden Schritte beschreiben einen typischen Anwendungsfall 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 Photo (New)“ 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. |
| 2 | Grundlegende Textsuche ausprobieren | Führen Sie eine Textsuche mit Text Search (New) 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 Orts-IDs, um Ortsdetails (neu) abzurufen. |
| 4 | Foto für einen Ort abrufen | Mit dem Dienst „Place Photo (New)“ können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Verwenden Sie Fotos von Orten (neu), um auf Fotos für einen Ort zuzugreifen. |