Einführung
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 in der Geocoding API und im Geocoding-Dienst der Maps JavaScript API abrufen
- Start, Ziel und Wegpunkte in der Routes API und der Directions API (alte Version) sowie im Directions-Dienst, Maps JavaScript API (alte Version) angeben
- Start und Ziel in der Routes API, der Distance Matrix API (alte Version) und dem Distance Matrix-Dienst der Maps JavaScript API (alte Version) angeben
- Place Details-Daten in der Places API (neu), im Places SDK for Android (neu), im Places SDK for iOS (neu) und 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.
In den folgenden Beispielen wird gezeigt, wie Sie eine Symbol-URL für die neue Places API und die alte Places API anfordern.
Places API (New)
Mit der Places API können Sie eine Orts-ID mithilfe einer Text Search (New)-Anfrage ermitteln.
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 eine Orts-ID im Feld id
, wie unten dargestellt:
{ "places": [ { "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0", "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... }
Sie können jetzt eine Place Details (New)-Anfrage stellen, indem Sie die Place ID in die Anfrage-URL aufnehmen:
https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY
Places API (alte Version)
Mit der Places API können Sie eine Orts-ID mithilfe einer Place Search-Anfrage ermitteln.
Im folgenden Beispiel wird nach Orten vom Typ „Restaurant“ innerhalb eines Umkreises von 1.500 m um einen Punkt in Sydney, Australien, gesucht, die das Wort „Kreuzfahrt“ enthalten:
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 eine Orts-ID im Feld place_id
, wie in diesem Snippet zu sehen:
{ "html_attributions" : [], "results" : [ { "geometry" : { "location" : { "lat" : -33.870775, "lng" : 151.199025 } }, ... "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0", ... } ], "status" : "OK" }
Sie können jetzt eine Place Details (Legacy)-Anfrage senden und die Place ID im Parameter place_id
angeben:
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
Da sich Orts-IDs aufgrund von Aktualisierungen der Google Maps-Datenbank ändern können, empfiehlt Google, Orts-IDs zu aktualisieren, wenn sie älter als 12 Monate sind. Das ist kostenlos möglich. Dazu stellen Sie eine Place Details-Anfrage, in der Sie nur das Feld für die Place ID im Parameter fields
angeben.
Places API (New)
Beispiel für die Verwendung von Place Details (New):
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
Places API (alte Version)
Beispiel für die Places API (alte Version):
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
Dadurch wird die SKU Place Detail New Essentials IDs Only oder Places Details – ID Refresh ausgelöst.
Fehlercodes bei der Verwendung von Orts-IDs
INVALID_REQUEST
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.
NOT_FOUND
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 auch aufgrund von 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.
Wenn Sie die Ergebnisse bei einer veralteten Orts-ID aktualisieren möchten, speichern Sie die ursprüngliche Anfrage, für die die einzelnen Orts-IDs zurückgegeben wurden, und senden Sie die Anfrage bei Bedarf noch einmal. Die neu erstellte Anfrage wird mit der entsprechenden SKU in Rechnung gestellt.
Bei einigen Arten von Orts-IDs wird manchmal die Antwort NOT_FOUND
oder eine andere Orts-ID in der Antwort zurückgegeben. Zu diesen Orts-ID-Typen gehören:
- 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