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

# 搜尋附近
<a name="search-nearby"></a>

Search Nearby API 可讓開發人員從中央座標查詢指定半徑內的興趣點。API 提供具有選用篩選條件的位置結果，包括類別、商業鏈、食品類型等。回應詳細資訊包括地點名稱、地址、電話、類別、食物類型、聯絡人和營業時間。根據請求的參數，可以使用其他功能，例如音素、時區和其他功能。

**注意**  
如果儲存結果，則會以較高的儲存體定價方案來計費。使用 `IntendedUse` 參數來指定結果是用於單次使用或儲存。如需與預存結果相關的成本影響[Places 定價](places-pricing.md)，請參閱 。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [SearchNearby](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchNearby.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用搜尋附近](https://docs.aws.amazon.com/location/latest/developerguide/search-nearby-how-to.html)。

## 使用案例
<a name="search-nearby-use-cases"></a>
+ **房地產應用程式：**為潛在的購房者或租客提供靠近房地產的設施和服務清單，例如學校、醫院和購物中心。
+ **Local Business Discovery：**讓使用者能夠從目前位置找到特定半徑內的企業、餐廳或商店。例如，食品交付應用程式可以根據即時位置顯示附近的餐廳。
+ **旅遊和旅遊應用程式：**協助旅行者探索其位置或目的地附近的景點、地標、飯店和服務。旅遊應用程式可能會建議附近的興趣點，例如美術館、公園和歷史網站。
+ **緊急服務：**協助使用者在緊急情況下尋找最近的醫院、政策站或藥店，對於專注於健康、安全或災難回應的應用程式尤其重要。
+ **運輸和物流：**協助使用者尋找最近的瓦斯站、EV 充電點或公有交通站點。乘車服務可以顯示附近的可用驅動程式。

## 了解請求
<a name="search-nearby-request-parameters"></a>

Search Nearby API 請求包含必要參數，例如 `QueryPosition`和選用參數，例如篩選條件，以精簡搜尋。`Language` 和 等其他選項`PoliticalView`可自訂特定需求的結果。如需詳細資訊，請參閱搜尋附近 API 參考。

請求包含下列關鍵參數：

**身分驗證**  
如果使用其他身分驗證方法，則 `Key` 參數為選用。  
+ `Key`：用於授權的 API 金鑰。
如需詳細資訊，請參閱[使用 Amazon Location Service 驗證](access.md)

**查詢**  
定義查詢的位置和搜尋半徑。  
+ `QueryPosition`：指定經度和緯度座標。
+ `QueryRadius`：定義指定座標周圍的搜尋半徑。
如需詳細資訊，請參閱[查詢和偏差](places-querying-biasing.md)

**精簡結果**  
篩選結果以縮小搜尋條件範圍。  
+ `Filter`：套用篩選條件，例如類別、商業鏈或食品類型。
如需詳細資訊，請參閱[篩選](places-filtering.md)。

**國際化和當地語系化**  
自訂語言並將政治觀點套用至結果的選項。  
+ `Language`：指定結果的語言。
+ `PoliticalView`：套用反映領土宣告的政治觀點。
如需詳細資訊，請參閱[當地語系化和國際化](places-localization-internationalization.md)

**其他功能**  
請求其他資料，例如時區資訊。  
+ `AdditionalFeatures`：請求時區資訊等其他詳細資訊的選項。
如需詳細資訊，請參閱[額外功能](additional-features.md)

## 了解回應
<a name="search-nearby-response-details"></a>

搜尋附近 API 的回應提供符合查詢的詳細結果，包括位置、地址詳細資訊、業務鏈、聯絡人、電話、時區和營業時間。如需詳細資訊，請參閱搜尋附近 API 參考。

回應包含下列金鑰資料：

**地址和相關詳細資訊**  
傳回位置的完整地址資訊。  
+ `Address`：包括完整的地址詳細資訊，例如國家/地區和街道。

**位置類型和類別**  
描述傳回位置的類型和類別。  
+ `Categories`：描述位置的類別，例如*餐廳*或*學校*。
+ `FoodTypes`：餐廳或餐廳供應的食品類型。
+ `BusinessChains`：表示任何相關聯的業務鏈。

**其他詳細資訊**  
與位置相關的其他資訊，如要求。  
+ `Contacts`：列出電子郵件、電話號碼和網站。
+ `OpeningHours`：指定地點的操作時間。
+ `Phonemes`：提供地址元件的音標表示法。
+ `TimeZone`：包括位置的時區資訊。