本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
搜尋位置會傳回結果清單。大多數結果都包含該結果PlaceId
的 。您可以在 GetPlace
操作PlaceId
中使用 來傳回有關該位置的資訊 (包括名稱、地址、位置或其他詳細資訊)。
注意
使用 SearchPlaceIndexForSuggestions會傳回使用任何資料來源建立之任何位置索引PlaceId
的結果。PlaceId
只有在使用的資料來源為 時,才會使用 SearchPlaceIndexForText或 SearchPlaceIndexForPosition傳回 HERE。
每個 PlaceId
都唯一地定義了其所指的位置,但單一位置可以具有PlaceId
一段時間以上的位置,並根據內容而定。下列規則描述 的唯一性和持久性PlaceId
。
-
您進行的呼叫中
PlaceId
傳回的 是專屬於您的 AWS 帳戶、 AWS 區域,以及PlaceIndex
資源中的資料提供者。只有當這三個屬性符合建立 的原始呼叫時,GetPlace
才會尋找結果PlaceId
。 -
當位置的資料變更時, 位置
PlaceId
的 會變更。例如,當其所指的企業移動位置或變更名稱時。 -
重複搜尋呼叫
PlaceId
傳回的 可能會在後端服務進行更新時變更。PlaceId
會繼續找到較舊的 ,但要搜尋的新呼叫可能會傳回不同的 ID。
PlaceId
是字串。的長度沒有特定限制PlaceId
。以下是有效 的範例PlaceId
。
AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ
針對資料已變更PlaceId
的位置 GetPlace
(例如已停止營業的業務位置) 呼叫 ,將導致 404
ResourceNotFound
錯誤。GetPlace
使用PlaceId
無效 的呼叫,或來自另一個 等內容外的呼叫 AWS 帳戶,將傳回 400
ValidationException
錯誤。
雖然您可以在後續請求中使用 PlaceID,但 PlaceID 並非永久識別符,而且 ID 可能會在連續API呼叫之間變更。請參閱每個資料提供者的下列 PlaceID 行為:
-
Esri:地點至少每季IDs都會變更。這些變更的典型期間是 3 月、6 月、9 月和 12 月。位置IDs也可能在典型的季度變更之間變更,但頻率會更低。
-
HERE:我們建議您快取資料的時間不超過一週,以保持資料新鮮。您可以假設少於 1% 的 ID 轉移會釋出超過版本,每週大約 1 - 2 次。
-
抓取 :在下列情況中, 位置IDs可能會過期或變成無效。
資料操作 : POI可能會由 Grab Map Ops 根據地面事實從 Grab POI 資料庫移除,例如在真實世界中關閉、被偵測到為重複 POI或具有不正確的資訊。Grab 將每週將資料同步到航點環境。
插補 POI:插補 POI 是在提供請求時即時POI產生的臨時 ,且會在回應中的
place.result_type
欄位中將其標記為衍生。插補的資訊POIs會保留至少 30 天,這表示您可以在 30 天內從放置POI詳細資訊 依放置 ID 取得詳細資訊API。30 天後,插入的 POIs(位置 ID 和詳細資訊) 可能會過期,而且無法從位置詳細資訊 存取API。