Orts-IDs

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Plattform auswählen: Android iOS JavaScript Webdienst

Orts-IDs identifizieren einen Ort in der Datenbank „Google Places“ und in Google Maps eindeutig. Orts-IDs werden in Anfragen an die folgenden Maps APIs akzeptiert:

  • Adresse für eine Orts-ID im Geocoding API-Webdienst und Geocoding-Dienst, Maps JavaScript API abrufen
  • Ausgangsort, Zielort und Zwischenwegpunkte im Directions API-Webdienst und Directions-Dienst, Maps JavaScript API angeben.
  • Start und Ziel im Distance Matrix API-Webdienst und Distance Matrix Service in der Maps JavaScript API angeben
  • Place Details im Places API-Webdienst, Places SDK for Android, Places SDK for iOS und Places Library, JavaScript API abrufen.
  • Orts-ID-Parameter in der Maps Embed API verwenden
  • Suchanfragen werden in Maps-URLs abgerufen.
  • Geschwindigkeitsbegrenzungen werden in der Roads API angezeigt.
  • Grenzenartige Polygone im datengetriebenen Stil suchen und gestalten

Nach der ID eines bestimmten Orts suchen

Sie suchen nach der Orts-ID eines bestimmten Orts? Suchen Sie über die Orts-ID-Suche nach einem Ort und erhalten Sie seine ID:

Alternativ können Sie sich die Orts-ID-Suche mit dem Code in der Maps JavaScript API-Dokumentation ansehen.

Übersicht

Die Orts-ID ist eine ID in Textform, mit der ein Ort eindeutig bezeichnet wird. Die Länge der ID kann variieren. Es gibt keine maximale Länge für Orts-IDs. Beispiele:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

Orts-IDs sind für die meisten Standorte verfügbar, einschließlich Unternehmen, Sehenswürdigkeiten, Parks und Kreuzungen. Es ist möglich, dass ein Ort oder ein Standort mehrere unterschiedliche Orts-IDs hat. Orts-IDs können sich im Laufe der Zeit ändern.

Sie können dieselbe Place ID für die Places API und eine Reihe von Google Maps Platform APIs verwenden. Du kannst beispielsweise dieselbe Orts-ID verwenden, um auf einen Ort in der Places API, der Maps JavaScript API, der Geocoding API, der Maps Embed API und der Roads API zu verweisen.

Ortsdaten mithilfe der Orts-ID abrufen

Orts-IDs sind von den Caching-Einschränkungen ausgenommen, die in Abschnitt 3.2.3(b) der Nutzungsbedingungen für die Google Maps Platform angegeben sind. Nachdem Sie die Orts-ID eines Orts gefunden haben, können Sie diesen Wert bei der nächsten Suche verwenden. Weitere Informationen finden Sie unten im Abschnitt Orts-IDs für die spätere Verwendung speichern.

Eine gängige Methode bei der Verwendung von Orts-IDs ist es, nach einem Ort zu suchen (z. B. mit der Places API oder der Places Library in der Maps JavaScript API) und dann die zurückgegebene Orts-ID zu verwenden, um Ortsdetails abzurufen. Sie können die Orts-ID speichern und später dieselben Ortsdetails abrufen. Informationen zum Speichern von Orts-IDs finden Sie unten.

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

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

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 für eine spätere Verwendung speichern

Orts-IDs sind von den in Abschnitt 3.2.3(a) der Google Maps Platform-Nutzungsbedingungen genannten Caching-Einschränkungen ausgenommen. Daher können Sie Orts-ID-Werte für die spätere Verwendung speichern.

IDs gespeicherter Orte werden aktualisiert

Wir empfehlen, Orts-IDs zu aktualisieren, wenn sie älter als 12 Monate sind. Sie können Place IDs kostenlos aktualisieren, indem Sie eine Place Details-Anfrage senden und dabei nur das Feld place_id im Parameter fields angeben. Dadurch wird die SKU Places Details – ID Refresh ausgelöst. Diese Anfrage kann jedoch auch den Statuscode NOT_FOUND zurückgeben. Eine Strategie besteht darin, die ursprüngliche Anfrage zu speichern, die jede Orts-ID zurückgegeben hat. Wenn eine Orts-ID ungültig wird, kannst du die Anfrage noch einmal senden, um neue Ergebnisse zu erhalten. Diese Ergebnisse können den ursprünglichen Ort umfassen. Die Anfrage ist kostenpflichtig.

Fehlercodes bei Verwendung von Orts-IDs

Der Statuscode INVALID_REQUEST gibt an, dass die angegebene Orts-ID ungültig ist. INVALID_REQUEST kann zurückgegeben werden, 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 Unternehmens-ID ist dann möglicherweise veraltet, wenn ein Unternehmen schließt oder seinen Standort verlegt. Orts-IDs können aufgrund umfangreicher Aktualisierungen in der Google Maps-Datenbank geändert werden. In solchen Fällen erhält ein Ort möglicherweise eine neue Orts-ID und die alte ID gibt eine NOT_FOUND-Antwort zurück.

Insbesondere können bestimmte Arten von Orts-IDs manchmal zu einer NOT_FOUND-Antwort führen oder die API gibt möglicherweise eine andere Orts-ID in der Antwort zurück. Zu diesen Orts-ID-Typen gehören:

  • Adressen, die in Google Maps nicht als genaue Adressen vorhanden sind, aber aus einem Adressbereich abgeleitet werden.
  • Segmente einer langen Route, wobei die Anfrage auch eine Stadt oder einen Ort angibt
  • Kreuzungen.
  • Orte mit einer Adresskomponente vom Typ subpremise.

Diese IDs haben häufig die Form eines langen Strings (es gibt keine maximale Länge 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