Es kann losgehen!

Bevor Sie mit der Entwicklung beginnen, lesen Sie bitte unsere Entwicklerdokumentation.

Den Google Places API Web Service aktivieren

Zum Einstieg führen wir Sie durch die Google Developers Console, wo Sie vorab Folgendes tun müssen:

  1. Ein Projekt erstellen oder auswählen
  2. Den Google Places API Web Service aktivieren
  3. Zugehörige Schlüssel erstellen
Weiter

Orts-IDs

Orts-IDs identifizieren einen Ort in der Datenbank „Google Places“ und in Google Maps eindeutig.

  1. Übersicht
  2. Ortsdaten mithilfe der Orts-ID abrufen
  3. Mehrere Orts-IDs und Orts-ID-Bereichsdefinitionen bearbeiten
  4. Nach der ID eines bestimmten Orts suchen
  5. Orts-IDs für eine spätere Verwendung speichern

Nach der ID eines bestimmten Orts suchen

Sie suchen nach der Orts-ID eines bestimmten Orts? Verwenden Sie den unten stehenden Orts-ID-Finder, um nach einem Ort zu suchen und seine ID abzurufen:

Alternativ hierzu können Sie sich in derGoogle Maps JavaScript API-Dokumentation den Orts-ID-Finder mit seinem Code ansehen.

Übersicht

Die Orts-ID ist eine ID in Textform, mit der ein Ort eindeutig bezeichnet wird. Sie sieht aus wie im folgenden Beispiel (wobei die Länge der Kennung variieren kann):

ChIJrTLr-GyuEmsRBfy61i59si0

Orts-IDs können für die meisten Orte abgerufen werden, einschließlich Unternehmen, Sehenswürdigkeiten, Parks und Knotenpunkte. Diese IDs sind stabil, das heißt, sobald Sie die Orts-ID eines Orts identifiziert haben, können Sie diesen Wert bei der nächsten Suche nach demselben Ort wiederverwenden.

Sie können dieselbe Orts-ID in der gesamten Google Places API und in zahlreichen Google Maps APIs verwenden. Zum Beispiel können Sie dieselbe Orts-ID für den Verweis auf einen Ort in der Places API, in der Google Maps JavaScript API, in der Google Maps Geocoding API, in der Google Maps Embed API und in der Google Maps Roads API verwenden.

Ortsdaten mithilfe der Orts-ID abrufen

Die Orts-ID ist eine zuverlässige Methode, um Informationen zu einem bestimmten Ort zu referenzieren. Häufig werden Orts-IDs dazu verwendet, nach einem Ort zu suchen (zum Beispiel mithilfe des Google Places API Web Service oder der Places-Bibliothek in der Google Maps JavaScript API). Anschließend werden anhand der zurückgegebenen Orts-ID Ortsdaten abgerufen. Sie können die Orts-ID speichern und sie verwenden, um die gleichen Ortsdaten später erneut abzurufen.

Beispiel für die Verwendung der Places API Web Service

Mit dem Google Places API Web Service können Sie nach einer Orts-ID suchen, indem Sie eine Anforderung zu einer Ortssuche ausführen.



Das folgende Beispiel zeigt eine Suchanfrage zu Orten des Typs „restaurant“ in einem Umkreis von 500 m um einen Punkt in Sydney, Australien an, die das Wort „cruise“ im Namen enthalten.

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

Die Antwort enthält im Feld place_id eine Orts-ID, wie es der Codeausschnitt zeigt:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

Eine Beschreibung aller Antwortfelder finden Sie in der Dokumentation zu Ortssuche.

Sie können jetzt eine Anforderung bezüglich Ortsdaten senden, indem Sie die Orts-ID in den Parameter placeid einfügen:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

Mehrere Orts-IDs und Orts-ID-Bereichsdefinitionen bearbeiten

Jede Orts-ID kann nur auf einen Ort verweisen, ein Ort kann jedoch mehrere Orts-IDs aufweisen. Mehrere Orts-IDs für einen Ort kommen meist dann vor, wenn Sie einen Ort hinzugefügt haben, der bereichsmäßig ursprünglich für Ihre Anwendung definiert war und dann eine Google-weite Bereichsdefinition erhält.

Wenn Sie mit dem Places API Web Service einen Ort hinzufügen, erhalten Sie unverzüglich eine Orts-ID für den neuen Ort. Diese Orts-ID ist bereichsmäßig nur für Ihre Anwendung definiert. Der Ort durchläuft eine Moderationswarteschlange zur Entscheidung, ob er in die Datenbank „Google Places“ aufgenommen wird. Wird der Ort bestätigt, erhält er eine neue Orts-ID, die in allen Anwendungen und in Google Maps sichtbar ist. Weitere Informationen finden Sie in der Dokumentation Orte hinzufügen.

Es gibt weitere Situationen, in denen es erforderlich ist, dass ein Ort eine neue Orts-ID erhält. Zum Beispiel kann dies der Fall sein, wenn ein Unternehmen seinen Sitz verlagert.

Das folgende Diagramm zeigt ein mögliches Szenario eines Orts mit mehr als einer Orts-ID:

Ort mit mehreren Orts-IDs abrufen

Hat ein Ort mehrere Orts-IDs, so hat dies keine Auswirkungen auf eine Places API-Anforderung. Jedoch wird die Antwort dadurch beeinflusst.

Wenn Sie einen Ort per Eingabe einer Orts-ID anfordern, werden Sie mit Sicherheit immer denselben Ort (sofern noch bestehend) in der Antwort erhalten.

Beachten Sie jedoch, dass die Antwort mehr als eine Orts-ID für den angeforderten Ort oder eine Orts-ID enthalten kann, die von der in Ihrer Anforderung abweicht.

  • Verhalten im Places API Web Service: Hat der Ort mehrere Orts-IDs, so gibt der Places API Web Service die primäre ID des Orts und ein Array zurück, das alle alternativen IDs für diesen Ort enthält. Weitere Informationen dazu finden Sie in der Dokumentation zu Ortsdaten und Ortssuche.
  • Verhalten in der Places JavaScript-Bibliothek und in anderen APIs: Wenn Sie Ortsdaten zu einer bestimmten Orts-ID anfordern, erhalten Sie die Details zum angeforderten Ort. Beachten Sie jedoch, dass die Orts-ID abweichen kann, falls der Ort seit Ihrer letzten Anforderung eine neue ID bekommen haben sollte. Sie können mit der ursprünglichen Orts-ID weiterhin auf den Ort zugreifen, aber sicherer ist es, wann immer möglich, die zuletzt zurückgegebene Orts-ID zu verwenden.

Orts-IDs für eine spätere Verwendung speichern

Orts-IDs sind, mit Ausnahme der Zwischenspeicherbeschränkungen, in Abschnitt 10.5.d der Google Maps API-Nutzungsbedingungen angegeben. Daher können Sie Orts-ID-Werte unbegrenzt speichern.

Feedback geben zu...

location_on
Google Places API Web Service