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

# 搜尋文字
<a name="search-text"></a>

Search Text 可讓您使用單一自由格式文字輸入來查詢位置資料，並使用國家/地區、地理圓圈或週框方塊等選用篩選條件傳回位置結果。API 也可透過建議 API `QueryId`傳回的 進行搜尋。回應包含地點名稱、地址、電話號碼、類別、食物類型、聯絡資訊和營業時間等詳細資訊。根據指定的參數，也可以使用電話、時區等選用功能。

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

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

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

## 使用案例
<a name="search-text-use-cases"></a>
+ **依文字搜尋鄰里：**協助客戶找到最近的相關位置。客戶可以找到最近的地址、商業或景點，例如美術館、商店或公園。
+ **業務探索：**透過輸入關鍵字，例如「義大利餐廳」或「咖啡店」，允許使用者尋找特定的業務或地點類型。此功能對於食品交付或餐廳建議應用程式特別有用。
+ **在旅遊應用程式中放置搜尋：**讓使用者能夠使用自由格式的文字搜尋位置、標記或企業，例如靠近艾菲爾鐵塔的「飯店」，以快速接收相關建議。
+ **教育機構搜尋：**允許使用者搜尋學校、學院或訓練中心 （例如，「大學」或「大學」)，這是適合父系或學生的實用工具。

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

**注意**  
 對於 `ap-southeast-1`和 中的客戶`ap-southeast-5`，支援的請求和回應欄位可能不同。如需詳細資訊，請參閱 [SearchText API 參考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)。

Search Text API 請求允許各種參數縮小搜尋範圍。選用參數可啟用其他功能、位置偏差、篩選條件、語言偏好設定和結果限制。如需詳細資訊，請參閱搜尋文字 API 參考。

請求包含下列關鍵參數：

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

**查詢**  
用於指定文字搜尋和位置偏差的參數。  
+ `QueryText`：搜尋位置的自由格式文字。
+ `QueryId`：啟用從建議 API 完成建議的查詢。
+ `BiasPosition`：優先考慮接近特定經度和緯度的結果。
如需詳細資訊，請參閱[查詢和偏差](places-querying-biasing.md)。

**精簡結果**  
篩選結果以縮小搜尋條件範圍。  
+ `Filter`：允許依週框方塊或圓形區域進行篩選，以限制搜尋結果。
如需詳細資訊，請參閱[篩選](places-filtering.md)。

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

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

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

搜尋文字 API 的回應包含符合查詢的詳細結果，其中包含位置、地址詳細資訊、業務鏈、聯絡人、電話、時區和營業時間的相關資訊。如需詳細資訊，請參閱搜尋文字 API 參考。

回應包含下列金鑰資料：

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

**位置類型和類別**  
描述位置的類型和類別。  
+ `Categories`：描述位置的類別清單，例如*餐廳*或*學校*。
+ `PlaceType`：指定位置類型，例如城市、地址或區域。
+ `BusinessChains`：表示任何相關聯的業務鏈。

**其他詳細資訊**  
與位置相關的其他資料，如要求。  
+ `Contacts`：提供電子郵件、電話號碼和網站。
+ `OpeningHours`：該地點的營運時間。
+ `AccessPoints`：與位置相關聯的地理座標。
+ `Phonemes`：地址元件的音標表示法。
+ `TimeZone`：時區資訊，包括位移。