使用地點 ID

搜尋地點會傳回結果清單。大多數結果包PlaceId括該結果。您可以在GetPlace作業PlaceId中使用 a 來傳回有關該位置的資訊 (包括名稱、地址、位置或其他詳細資訊)。

注意

使用SearchPlaceIndexForSuggestions將傳回使用任何資料來源建立的任何位置索引的PlaceId結果。PlaceId僅當使SearchPlaceIndexForText用SearchPlaceIndexForPosition的資料來源為 HERE 時，使用或才會傳回。

每個PlaceId唯一定義它所指的地方，但是PlaceId隨著時間的推移，並且基於上下文，單個地方可以有多個地方。以下規則描述了 a 的唯一性和壽命PlaceId。

• 您所進行的呼叫中PlaceId傳回的資料特定於您 AWS 帳戶、對該 AWS 地區以及PlaceIndex資源中的資料提供者。 GetPlace只有當這三個屬性符合建立的原始呼叫時，才會尋找結果PlaceId。

• 當有PlaceId關該地點的數據發生變化時，該地點的數據將發生變化。例如，當其參照的商家移動位置或變更名稱時。

• 重複搜尋呼叫PlaceId傳回的可能會在後端服務進行更新時變更。PlaceId將繼續找到較舊的，但是要搜索的新呼叫可能會返回不同的 ID。

PlaceId是一個字符串。a 的長度沒有特定限制PlaceId。以下是有效的範例PlaceId。

AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

GetPlace使PlaceId用資料已變更的地點呼叫 (例如，已停業的營業地點)，將會導致ResourceNotFound錯誤。404GetPlace使用無效的調用，或者一個不在上下文中（例如來自另 AWS 帳戶一個）將返回一400個ValidationException錯誤。PlaceId

雖然您可以在後續請求中使用 PlacId，但 PlacId 並不打算成為永久標識符，並且 ID 可以在連續的 API 調用之間更改。請參閱每個資料提供者的下列 PlacId 行為：

• Esri：地點 ID 將至少每季度更改一次。這些變更的典型時段為三月、六月、九月和十二月。地點 ID 也可能會在典型的季度變更之間發生變化，但這樣做的頻率會降低得多。

• HER E：我們建議您快取資料的時間不超過一週，以保持資料資料的最新狀態。您可以假設少於 1％ 的 ID 偏移將在發行版本中釋放，每週約 1-2 次。

• 抓取：在下列情況下，地點 ID 可能會過期或變成無效。

  • 數據操作：根據地面真相，例如在現實世界中關閉，被檢測為重複的 POI 或具有不正確的信息，可以通過 Grab Map Ops 從 Grab POI 數據庫中刪除 POI。Grab 將每週將數據同步到航點環境。

  • 內插 POI：內插 POI 是提供請求時實時生成的臨時 POI，並且在響應中將其標記為派生。place.result_type內插的 POI 資料將保留至少 30 天，這意味著您可以在 30 天內從地點詳細信息 API 獲取地點 ID 的 POI 詳細信息。30 天後，內插的 POI（地點 ID 和詳細信息）可能會過期且無法從「地點詳細信息」API 訪問。