Orts-IDs

Plattform auswählen: Android iOS JavaScript Webdienst

Entwickler im Europäischen Wirtschaftsraum (EWR)

Wenn sich Ihre Rechnungsadresse im Europäischen Wirtschaftsraum befindet, gelten ab dem 8. Juli 2025 die Nutzungsbedingungen der Google Maps Platform für den EWR für Ihre Nutzung der Dienste. Der Funktionsumfang variiert je nach Region. Weitere Informationen

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.

Beispiel für die Verwendung der Places Library in der Maps JavaScript API

Wenn Sie eine Orts-ID in Ihrer JavaScript-App verwenden möchten, müssen Sie zuerst die ID suchen. Sie wird im PlaceResult einer Place Search-Anfrage oder über getPlace() im Place Autocomplete (Legacy)-Dienst zurückgegeben. Anschließend können Sie die Orts-ID verwenden, um Ortsdetails abzurufen.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

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 place_id im fields-Parameter angeben.

Dadurch wird die SKU 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.

Hinweis:Orts-IDs, die nicht mehr verwendet werden, können noch einige Tage lang in Antworten von „Place Autocomplete (Legacy)“, „Query Autocomplete (Legacy)“ oder „Autocomplete (New)“ zurückgegeben werden, nachdem die Orts-ID aus der Google Maps-Datenbank entfernt wurde.

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