Überblick

Plattform auswählen: Android iOS JavaScript Webdienst
Die Places API ist ein Dienst, der HTTP-Anfragen für Standortdaten über verschiedene Methoden akzeptiert. Dabei werden formatierte Standortdaten und Bilder zu Einrichtungen, geografischen Standorten oder markanten POIs zurückgegeben.

Vorteile der Places API

Erstellen Sie standortbezogene Funktionen, um Ihren Nutzern detaillierte Standortdaten leicht zugänglich zu machen. Die über die Places API verfügbaren Daten basieren auf einem der genauesten, aktuellsten und umfassendsten Ortsmodelle der realen Welt. Im Folgenden finden Sie Beispiele für Anwendungsfälle für Anwendungen:

  • Vermietung von Eigentumswohnungen in Ballungsräumen mit speziell auf Städte ausgerichtete Ergebnisse anzeigen.
  • Nehmen Sie Ortsdetails in ein Update zum Abhol- oder Lieferstatus auf.
  • Eine Liste der Parks in einem Gebiet mit von Nutzern eingereichten Fotos und Rezensionen anzeigen.
  • Sie können Nutzern, die Reisen planen, Kontaktinformationen, Rezensionen und Preisstufen für Einrichtungen zur Verfügung stellen.

Was kann ich mit der Places API tun?

Mit der Places API können Sie die folgenden Funktionen in Ihre Anwendungen einbinden:

  • Stellen Sie „Place Search“-Ergebnisse aus verschiedenen Arten von Suchanfragen bereit, z. B. Texteingabe, Standorte in der Nähe und mehrdeutige oder kategoriale Suchanfragen von Nutzern.
  • Aktivieren Sie Funktionen zur automatischen Vervollständigung für verschiedene Suchtypen, entweder für bestimmte Text- oder kategoriale Suchanfragen.
  • Hier kannst du die Art der zurückgegebenen Details zu einem Ort eingrenzen, z. B. Öffnungszeiten, eine Zusammenfassung, Nutzerrezensionen oder ein Foto.
  • Fügen Sie Fotos in hoher Qualität zu Standorten hinzu, die von Ihrer App bereitgestellt werden.

Viele Google Maps Platform APIs unterstützen Orts-IDs. Damit wird ein Ort in der Google Places-Datenbank und auf Google Maps eindeutig identifiziert. 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 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 ist die vorhandenen APIs und Places API (New) ist die Version der nächsten Generation.

Bei der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs verwendet werden sollen. Dies gilt für Neu- oder Bestandskund*innen, die 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 über eine „Place Details“-Anfrage mithilfe eines API-Schlüssels die Adresskomponenten für eine Orts-ID zurückgegeben:

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 wie /place oder /photo. Die Endpunkte akzeptieren auch den in der Anfrage angegebenen Formattyp, entweder JSON oder XML. Die Dienstanfrage verwendet Parameter, die für diesen bestimmten 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 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.

Ressourcen

In der folgenden Tabelle sind die Ressourcen zusammengefasst, die über die Places API verfügbar sind.

Places API Places API (New) Hinweise
Find Place Text Search (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 Text Search (New) verwendet werden, da „Nearby Search (New)“ keine Texteingabe unterstützt.
Textsuche Text Search (Neu)
Ortsdetails Place Details (neu)
Foto des Ortes Foto des Ortes (Neu)
Place Autocomplete Automatische Vervollständigung (neu) In der Vorschau
Query Autocomplete Automatische Vervollständigung (neu) Funktionen der Vorschauversion der automatischen Vervollständigung hinzugefügt (neu)

Places API verwenden

Die folgenden Schritte decken ein typisches Anwendungsszenario für die Verwendung des Places API-Dienstes ab. Für die Entwicklung 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 führen Sie die folgenden Einrichtungsanleitungen aus. Hier erfahren Sie, wie Sie Ihren API-Schlüssel verwenden. Für die Places API (New) können auch OAuth-Tokens verwendet werden.
2 Einfache Textsuche ausprobieren Führen Sie eine einfache Textsuche mit Text Search (New) oder Text Search durch.
3 Weitere Informationen über die Orts-ID Viele Google Maps Platform APIs geben als Teil 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 einem Ort aufnehmen Mit „Place Photo“ haben Sie Zugriff auf Millionen von Fotos in der Places-Datenbank. Verwenden Sie Place Photo (New) oder Place Details, um auf Fotos für einen Ort zuzugreifen.