Ort IDs mit Amazon Location verwenden - 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.

Ort IDs mit Amazon Location verwenden

Bei der Suche nach Orten wird eine Ergebnisliste zurückgegeben. Die meisten Ergebnisse enthalten ein PlaceId für dieses Ergebnis. Sie können a PlaceId in einer GetPlace Operation verwenden, um Informationen über diesen Ort (einschließlich Name, Adresse, Standort oder andere Details) zurückzugeben.

Anmerkung

Bei Verwendung SearchPlaceIndexForSuggestionswerden PlaceId Ergebnisse für alle Ortsindizes zurückgegeben, die mit einer beliebigen Datenquelle erstellt wurden. Wenn Sie SearchPlaceIndexForTextoder verwenden SearchPlaceIndexForPosition, wird PlaceId nur dann a zurückgegeben, wenn die verwendete Datenquelle istHERE.

Jeder Ort definiert PlaceId eindeutig den Ort, auf den er sich bezieht, aber ein einzelner Ort kann PlaceId im Laufe der Zeit und je nach Kontext mehrere haben. Die folgenden Regeln beschreiben die Einzigartigkeit und Langlebigkeit einesPlaceId.

  • Die PlaceId zurückgegebenen Anrufe, die Sie tätigen, sind spezifisch für Ihre Ressource AWS-Konto, für die AWS Region und für den Datenanbieter in Ihrer PlaceIndex Ressource. GetPlacefindet nur dann Ergebnisse, wenn diese drei Attribute mit dem ursprünglichen Anruf übereinstimmen, der den erstellt hatPlaceId.

  • Die PlaceId Angabe für einen Ort ändert sich, wenn sich die Daten zu diesem Ort ändern. Zum Beispiel, wenn das Unternehmen, auf das es sich bezieht, seinen Standort wechselt oder seinen Namen ändert.

  • Das Ergebnis PlaceId eines wiederholten Suchaufrufs kann sich ändern, wenn der Back-End-Dienst ein Update vornimmt. Die ältere ID PlaceId wird weiterhin gefunden, aber bei neuen Suchaufrufen kann es sein, dass eine andere ID zurückgegeben wird.

Das PlaceId ist eine Zeichenfolge. Es gibt keine spezifische Begrenzung für die Länge von PlaceId a. Das Folgende ist ein Beispiel für ein gültigesPlaceId. 

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. ein Geschäftsstandort, der seinen Betrieb eingestellt hat), wird der ResourceNotFound Fehler404, zurückgegeben. Wenn Sie GetPlace mit einer PlaceId Angabe aufrufen, die nicht gültig ist oder aus dem Zusammenhang gerissen ist, z. B. von einer anderen AWS-Konto, wird ein 400 ValidationException Fehler zurückgegeben.

Sie können PlaceID zwar in nachfolgenden Anfragen 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: Place IDs wird sich mindestens vierteljährlich ändern. Der typische Zeitraum für diese Änderungen wäre März, Juni, September und Dezember. Zwischen den typischen vierteljährlichen Änderungen IDs könnte sich auch der Ort ändern, aber das wird viel seltener sein.

  • HERE: Wir empfehlen, Daten nicht länger als eine Woche zwischenzuspeichern, um Ihre Datendaten auf dem neuesten Stand zu halten. Sie können davon ausgehen, dass weniger als 1% der ID-Shifts mehr als 1 — 2 mal pro Woche veröffentlicht werden.

  • Grab: Place IDs kann in den folgenden Situationen ablaufen oder ungültig werden.

    • Datenoperationen: Sie POI können von Grab Map Ops aus der POI Grab-Datenbank entfernt werden, wenn es sich um grundlegende Fakten handelt, z. B. wenn sie in der realen Welt geschlossen wurden, als Duplikat POI erkannt wurden oder falsche Informationen enthalten. Grab synchronisiert die Daten wöchentlich mit der Waypoint-Umgebung.

    • Interpoliert POI: Interpoliert POI ist eine temporäre Datei, die in Echtzeit POI generiert wird, wenn eine Anfrage bearbeitet wird. Sie wird in dem Feld in der place.result_type Antwort als abgeleitet markiert. Die interpolierten Informationen POIs werden mindestens 30 Tage lang gespeichert, was bedeutet, dass Sie innerhalb von 30 Tagen die Informationen anhand der Orts-ID in den POI Ortsdetails abrufen können. API Nach 30 Tagen laufen die interpolierten Daten POIs (sowohl Ort-ID als auch Details) möglicherweise ab und sind über die Ortsdetails nicht mehr zugänglich. API