選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

將 位置IDs與 Amazon Location 搭配使用

焦點模式
將 位置IDs與 Amazon Location 搭配使用 - Amazon Location Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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

注意

使用 SearchPlaceIndexForSuggestions會傳回使用任何資料來源建立之任何位置索引PlaceId的結果。PlaceId 只有在使用的資料來源為 時,才會使用 SearchPlaceIndexForTextSearchPlaceIndexForPosition傳回 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 (例如已停止營業的業務位置) 呼叫 ,將導致 404ResourceNotFound錯誤。GetPlace 使用PlaceId無效 的呼叫,或來自另一個 等內容外的呼叫 AWS 帳戶,將傳回 400ValidationException錯誤。

雖然您可以在後續請求中使用 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。

下一個主題:

類別和篩選

上一個主題:

自動完成
隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。