Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Orts-IDs werden in Anfragen an die folgenden Maps APIs akzeptiert:
- Adresse für eine Orts-ID im Geocoding API-Webdienst und Geocoding-Dienst der Maps JavaScript API abrufen
- Start, Ziel und Wegpunkte im Routes API- und Directions API-Webdienst und Directions-Dienst der Maps JavaScript API angeben
- Start und Ziel im Routes API- und Distance Matrix API-Webdienst und Distance Matrix-Dienst der Maps JavaScript API angeben
- Place Details-Daten im Places API-Webdienst, Places SDK for Android und Places SDK for iOS sowie in der Places Library abrufen
- Orts-ID-Parameter in der Maps Embed API verwenden
- Suchanfragen in Maps-URLs abrufen
- Geschwindigkeitsbegrenzungen in der Roads API anzeigen
- Begrenzungspolygone finden und mit datengestützten Stilen für Grenzen gestalten
Nach der ID eines bestimmten Orts suchen
Sie suchen nach der ID eines bestimmten Orts? Dann verwenden Sie die Orts-ID-Suche:
Alternativ können Sie sich auch die Seite zur Orts-ID-Suche mit dem entsprechenden Code in der Maps JavaScript API-Dokumentation ansehen.
Übersicht
Die Orts-ID ist eine Kennung in Textform, die einen Ort eindeutig definiert. Die Länge von Orts-IDs kann variieren und ist nicht begrenzt. Beispiele:
-
ChIJgUbEo8cfqokR5lP9_Wh_DaM
-
GhIJQWDl0CIeQUARxks3icF8U8A
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
-
IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ
Orts-IDs lassen sich für die meisten Orte abrufen, einschließlich Unternehmen, Sehenswürdigkeiten, Parks und Kreuzungen. Ein Ort kann mehrere unterschiedliche Orts-IDs haben. Orts-IDs können sich im Laufe der Zeit ändern.
Sie können dieselbe Orts-ID für die Places API und verschiedene Google Maps Platform APIs verwenden. So kann z. B. dieselbe Orts-ID verwendet werden, um in der Places API, Maps JavaScript API, Geocoding API, Maps Embed API und Roads API auf einen Ort zu verweisen.
Ortsdetails mithilfe der Orts-ID abrufen
Häufig wird nach einem Ort gesucht (z. B. mit der Places API oder der Places Library in der Maps JavaScript API) und die zurückgegebene Orts-ID dann verwendet, um Ortsdetails abzurufen. Sie können die Orts-ID speichern und später verwenden, um dieselben Ortsdetails noch einmal abzurufen. Informationen zum Speichern von Orts-IDs finden Sie unten.
Die folgenden Beispiele zeigen, wie Sie eine Symbol-URL für Places API (New) und Places API
Places API (New)
Mit der Places API können Sie eine Orts-ID ermitteln, indem Sie Textsuche (neu)
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Die Antwort enthält im Feld id
eine Orts-ID:
{ "places": [ { "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0", "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... }
Jetzt können Sie Place Details (neu) indem Sie die Orts-ID in die Anfrage-URL einfügen:
https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY
Places API
Mit der Places API können Sie eine Orts-ID ermitteln, indem Sie Place Search-Anfrage
Das folgende Beispiel zeigt eine Suchanfrage für Orte vom Typ „Restaurant“. innerhalb eines Radius von 1.500 m um einen Punkt in Sydney, Australien, der das Wort 'Kreuzfahrt':
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY
Die Antwort enthält im Feld place_id
eine Orts-ID, z. B.
wie in diesem Snippet dargestellt:
{ "html_attributions" : [], "results" : [ { "geometry" : { "location" : { "lat" : -33.870775, "lng" : 151.199025 } }, ... "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0", ... } ], "status" : "OK" }
Sie können jetzt eine
„Place Details“-Anfrage
Fügen Sie die Orts-ID in den Parameter place_id
ein:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY
Orts-IDs zur späteren Verwendung speichern
Orts-IDs sind von den Caching-Einschränkungen in Paragraf 3.2.3(b) der Nutzungsbedingungen für die Google Maps Platform ausgenommen. Sie können Orts-IDs daher zur späteren Verwendung speichern.
Gespeicherte Orts-IDs aktualisieren
Wir empfehlen, Orts-IDs, die älter als 12 Monate sind, zu aktualisieren. Ich
Orts-IDs kostenlos aktualisieren können, indem Sie eine
„Place Details“-Anfrage, bei der nur die Orts-ID angegeben wird
im Parameter fields
.
Places API (New)
Beispiel mit Place Details (New):
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
Places API
Beispiel mithilfe der alten Place Details API:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
Bei dieser Anfrage kann auch der Status „NOT_FOUND
“ zurückgegeben werden
Code. Eine Möglichkeit ist, die ursprüngliche Anfrage zu speichern, für die die einzelnen Orts-IDs zurückgegeben wurden. Wenn eine Orts-ID ungültig wird, können Sie die Anfrage noch einmal senden, um neue Ergebnisse zu erhalten. Diese Ergebnisse können den ursprünglichen Ort umfassen oder auch nicht. Diese Anfrage
ist anrechenbar.
Fehlercodes bei der Verwendung von Orts-IDs
Der Statuscode INVALID_REQUEST
gibt an, dass die angegebene
Orts-ID ungültig ist. INVALID_REQUEST
wird zurückgegeben, wenn die Orts-ID abgeschnitten oder anderweitig geändert wurde und nicht mehr korrekt ist.
Der Statuscode NOT_FOUND
gibt an, dass die angegebene Orts-ID veraltet ist. Eine Orts-ID kann auch als veraltet eingestuft werden, wenn ein Unternehmen schließt oder an einen neuen Standort umzieht. Orts-IDs können sich aufgrund umfangreicher Aktualisierungen der Google Maps-Datenbank ändern. In solchen Fällen wird einem Ort eventuell eine neue Orts-ID zugewiesen und für die alte die Antwort NOT_FOUND
zurückgegeben.
Besonders bei folgenden Arten von Orts-IDs wird manchmal die Antwort NOT_FOUND
oder eine andere Orts-ID in der Antwort zurückgegeben:
- Adressen, die in Google Maps nicht als genaue Adressen vorhanden sind, sondern aus einem Adressbereich abgeleitet werden
- Segmente einer langen Route, für die in der Anfrage auch eine Stadt oder ein Ort angegeben wird
- Kreuzungen
- Orte mit einer Adresskomponente vom Typ
subpremise
Die IDs sind häufig lange Strings (es gibt keine Längenbeschränkung für Orts-IDs). Beispiel:
EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4