Verwenden von Orts-IDs - Amazon Location Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Orts-IDs

Die Suche nach Orten gibt eine Liste von Ergebnissen zurück. Die meisten Ergebnisse enthalten einen PlaceId für dieses Ergebnis. Sie können einen PlaceId in einer -GetPlaceOperation verwenden, um die Informationen über diesen Ort (einschließlich Name, Adresse, Standort oder anderer Details) zurückzugeben.

Anmerkung

Die Verwendung von SearchPlaceIndexForSuggestions gibt PlaceId Ergebnisse für alle Ortsindizes zurück, die mit einer beliebigen Datenquelle erstellt wurden. Die Verwendung von SearchPlaceIndexForText oder SearchPlaceIndexForPosition gibt PlaceId nur dann einen zurück, wenn die verwendete Datenquelle HERE ist.

Jede definiert PlaceId eindeutig den Ort, auf den sie sich bezieht, aber ein einzelner Ort kann im PlaceId Laufe der Zeit mehr als einen haben und basiert auf dem Kontext. Die folgenden Regeln beschreiben die Eindeutigkeit und Lebensdauer eines PlaceId.

  • Die in Aufrufen PlaceId zurückgegebenen sind spezifisch für Ihr AWS-Konto, die AWS Region und den Datenanbieter in Ihrer PlaceIndex Ressource. GetPlace findet Ergebnisse nur, wenn diese drei Attribute mit dem ursprünglichen Aufruf übereinstimmen, der das erstellt hatPlaceId.

  • Die PlaceId für einen Ort ändert sich, wenn sich die Daten zu diesem Ort ändern. Wenn beispielsweise das Unternehmen, auf das es sich bezieht, den Standort verschiebt oder Namen ändert.

  • Der von einem wiederholten Suchaufruf PlaceId zurückgegebene kann sich ändern, wenn der Backend-Service eine Aktualisierung vornimmt. Das ältere PlaceId wird weiterhin gefunden, aber neue Suchaufrufe geben möglicherweise eine andere ID zurück.

ist PlaceId eine Zeichenfolge. Es gibt keine spezifische Begrenzung für die Länge eines PlaceId. Im Folgenden finden Sie ein Beispiel für einen gültigen PlaceId. 

AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

Wenn Sie GetPlace mit einem PlaceId für einen Ort aufrufen, dessen Daten sich geändert haben (z. B. einen Geschäftsstandort, der nicht mehr funktioniert), führt dies zu einem 404-, -ResourceNotFoundFehler. Wenn Sie GetPlace mit einer aufrufen, PlaceId die nicht gültig ist, oder einer, die nicht im Kontext ist, z. B. von einer anderen AWS-Konto, wird ein 400-ValidationExceptionFehler zurückgegeben.

Sie können PlaceID zwar in nachfolgenden Anforderungen verwenden, PlaceID ist jedoch nicht als permanente Kennung gedacht und die ID kann sich zwischen aufeinanderfolgenden API-Aufrufen ändern. Bitte beachten Sie das folgende PlaceID-Verhalten für jeden Datenanbieter:

  • Esri : Orts-IDs ändern sich mindestens jedes Quartal. Der typische Zeitraum für diese Änderungen wäre März, Juni, September und Dezember. Orts-IDs können sich auch zwischen der typischen vierteljährlichen Änderung ändern, aber das wird viel seltener sein.

  • HERE : Wir empfehlen, dass Sie Daten nicht länger als eine Woche zwischenspeichern, um Ihre Daten auf dem neuesten Stand zu halten. Sie können davon ausgehen, dass weniger als 1 % ID-Schichten gegenüber der Veröffentlichung freigegeben werden, was etwa 1–2 Mal pro Woche entspricht.

  • Grab : Orts-IDs können in den folgenden Situationen ablaufen oder ungültig werden.

    • Datenoperationen: Das POI kann von Grab Map Ops auf der Grundlage der Grundwahrheit aus der Grab-POI-Datenbank entfernt werden, z. B. in der realen Welt geschlossen, als doppeltes POI erkannt oder falsche Informationen vorliegen. Grab synchronisiert Daten wöchentlich mit der Waypoint-Umgebung.

    • Interpoliertes POI: Interpoliertes POI ist ein temporäres POI, das bei der Verarbeitung einer Anforderung in Echtzeit generiert wird, und es wird im place.result_type Feld in der Antwort als abgeleitet markiert. Die Informationen zu interpolierten POIs werden mindestens 30 Tage lang aufbewahrt, was bedeutet, dass Sie innerhalb von 30 Tagen POI-Details nach Orts-ID von der API für Ortsdetails abrufen können. Nach 30 Tagen können die interpolierten POIs (sowohl Orts-ID als auch Details) ablaufen und über die API für Ortsdetails nicht mehr zugänglich sein.