本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
搜尋附近
Search Nearby API 可讓開發人員從中央座標查詢指定半徑內的興趣點。API 提供具有選用篩選條件的位置結果，包括類別、商業鏈、食品類型等。回應詳細資訊包括地點名稱、地址、電話、類別、食物類型、聯絡人和營業時間。根據請求的參數，可以使用其他功能，例如音素、時區和其他功能。
注意
如果儲存結果，則會以較高的儲存體定價方案來計費。使用 IntendedUse 參數來指定結果是用於單次使用或儲存。如需與預存結果相關的成本影響Places 定價，請參閱 。
如需詳細資訊，請參閱《Amazon Location Service API 參考》中的 SearchNearby。
如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱如何使用搜尋附近。
使用案例
-
房地產應用程式：為潛在的購房者或租客提供靠近房地產的設施和服務清單，例如學校、醫院和購物中心。
-
Local Business Discovery：讓使用者能夠從目前位置找到特定半徑內的企業、餐廳或商店。例如，食品交付應用程式可以根據即時位置顯示附近的餐廳。
-
旅遊和旅遊應用程式：協助旅行者探索其位置或目的地附近的景點、地標、飯店和服務。旅遊應用程式可能會建議附近的興趣點，例如美術館、公園和歷史網站。
-
緊急服務：協助使用者在緊急情況下尋找最近的醫院、政策站或藥店，對於專注於健康、安全或災難回應的應用程式尤其重要。
-
運輸和物流：協助使用者尋找最近的瓦斯站、EV 充電點或公有交通站點。乘車服務可以顯示附近的可用驅動程式。
了解請求
Search Nearby API 請求包含必要參數，例如 QueryPosition和選用參數，例如篩選條件，以精簡搜尋。Language 和 等其他選項PoliticalView可自訂特定需求的結果。如需詳細資訊，請參閱搜尋附近 API 參考。
請求包含下列關鍵參數：
- 身分驗證
-
如果使用其他身分驗證方法，則
Key參數為選用。-
Key：用於授權的 API 金鑰。
如需詳細資訊，請參閱使用 Amazon Location Service 驗證
-
- 查詢
-
定義查詢的位置和搜尋半徑。
-
QueryPosition：指定經度和緯度座標。 -
QueryRadius：定義指定座標周圍的搜尋半徑。
如需詳細資訊，請參閱查詢和偏差
-
- 精簡結果
-
篩選結果以縮小搜尋條件範圍。
-
Filter：套用篩選條件，例如類別、商業鏈或食品類型。
如需詳細資訊，請參閱篩選。
-
- 國際化和當地語系化
-
自訂語言並將政治觀點套用至結果的選項。
-
Language：指定結果的語言。 -
PoliticalView：套用反映領土宣告的政治觀點。
如需詳細資訊，請參閱當地語系化和國際化
-
- 其他功能
-
請求其他資料，例如時區資訊。
-
AdditionalFeatures：請求時區資訊等其他詳細資訊的選項。
如需詳細資訊，請參閱額外功能
-
了解回應
搜尋附近 API 的回應提供符合查詢的詳細結果，包括位置、地址詳細資訊、業務鏈、聯絡人、電話、時區和營業時間。如需詳細資訊，請參閱搜尋附近 API 參考。
回應包含下列金鑰資料：
- 地址和相關詳細資訊
-
傳回位置的完整地址資訊。
-
Address：包括完整的地址詳細資訊，例如國家/地區和街道。
-
- 位置類型和類別
-
描述傳回位置的類型和類別。
-
Categories：描述位置的類別，例如餐廳或學校。 -
FoodTypes：餐廳或餐廳供應的食品類型。 -
BusinessChains：表示任何相關聯的業務鏈。
-
- 其他詳細資訊
-
與位置相關的其他資訊，如要求。
-
Contacts：列出電子郵件、電話號碼和網站。 -
OpeningHours：指定地點的操作時間。 -
Phonemes：提供地址元件的音標表示法。 -
TimeZone：包括位置的時區資訊。
-
