기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Search Text
Search Text를 사용하면 단일 자유 형식 텍스트 입력을 사용하여 위치 데이터를 쿼리하여 국가, 지리적 원 또는 경계 상자와 같은 선택적 필터가 있는 장소 결과를 반환할 수 있습니다. API는 Suggest 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 명령의 예는 [Search Text 사용 방법](https://docs.aws.amazon.com/location/latest/developerguide/search-text-how-to.html)을 참조하세요.
## 사용 사례
+ **텍스트로 지역 검색:** 고객이 가장 가까운 관련 위치를 찾을 수 있도록 도와줍니다. 고객은 가장 가까운 주소, 비즈니스 또는 박물관, 상점 또는 공원과 같은 명소를 찾을 수 있습니다.
+ **비즈니스 검색:** "이탈리아 레스토랑" 또는 "커피숍"과 같은 키워드를 입력하여 사용자가 특정 비즈니스 또는 장소 유형을 찾을 수 있도록 허용합니다. 이 기능은 음식 배달 또는 레스토랑 추천 앱에 특히 유용합니다.
+ **여행 앱의 장소 검색:** 사용자가 "Eiffel Tower 근처의 호텔"과 같은 자유 형식 텍스트를 사용하여 위치, 랜드마크 또는 기업을 검색하여 관련 제안을 신속하게 받을 수 있습니다.
+ **교육 기관 검색:** 사용자가 학부모 또는 학생에게 유용한 도구인 학교, 대학 또는 훈련 센터(예: "초등학교" 또는 "대학교")를 검색할 수 있도록 허용합니다.
## 요청 이해
**참고**
`ap-southeast-1` 및의 고객의 경우 `ap-southeast-5`지원되는 요청 및 응답 필드가 다를 수 있습니다. 자세한 내용은 [SearchText API 참조](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)를 참조하세요.
Search Text API 요청을 사용하면 다양한 파라미터가 검색을 세분화할 수 있습니다. 선택적 파라미터를 사용하면 추가 기능, 위치 편향, 필터링 기준, 언어 기본 설정 및 결과 제한이 가능합니다. 자세한 내용은 Search Text API 참조를 참조하세요.
이 요청에는 다음 주요 파라미터가 포함되어 있습니다.
**Authentication**
다른 인증 방법을 사용하는 경우 `Key` 파라미터는 선택 사항입니다.
+ `Key`: 권한 부여를 위한 API 키입니다.
자세한 내용은 [Amazon Location Service로 인증](access.md) 단원을 참조하십시오.
**쿼리**
Search Text 및 위치 편향을 지정하는 데 사용되는 파라미터입니다.
+ `QueryText`: 장소 검색을 위한 자유 형식 텍스트입니다.
+ `QueryId`: Suggest API에서 제안된 쿼리를 완료할 수 있습니다.
+ `BiasPosition`: 특정 경도 및 위도에 가까운 결과의 우선순위를 지정합니다.
자세한 내용은 [쿼리 및 편향](places-querying-biasing.md) 단원을 참조하십시오.
**결과 구체화**
결과를 필터링하여 검색 기준을 좁힙니다.
+ `Filter`: 경계 상자 또는 원형 영역을 기준으로 필터링하여 검색 결과를 제한할 수 있습니다.
자세한 내용은 [필터링](places-filtering.md) 섹션을 참조하세요.
**국제화 및 현지화**
언어를 사용자 지정하고 결과에 정치적 견해를 적용하는 옵션입니다.
+ `Language`: 결과의 언어를 지정합니다.
+ `PoliticalView`: 지역 클레임을 반영하는 정치적 견해를 적용합니다.
자세한 내용은 [현지화 및 국제화](places-localization-internationalization.md) 단원을 참조하십시오.
**추가 기능**
시간대 정보와 같은 추가 데이터를 요청합니다.
+ `AdditionalFeatures`: 시간대 세부 정보와 같은 추가 데이터를 요청하는 옵션입니다.
자세한 내용은 [기타 기능](additional-features.md) 단원을 참조하십시오.
## 응답 이해
Search Text API의 응답에는 위치, 주소 세부 정보, 비즈니스 체인, 연락처, 음소, 시간대 및 운영 시간에 대한 정보와 함께 쿼리와 일치하는 자세한 결과가 포함됩니다. 자세한 내용은 Search Text API 참조를 참조하세요.
응답에는 다음 주요 데이터가 포함됩니다.
**주소 및 관련 세부 정보**
반환된 위치에 대한 포괄적인 주소 정보입니다.
+ `Address`: 국가, 도로명 및 기타 주소 세부 정보를 포함합니다.
**장소 유형 및 범주**
장소의 유형과 범주를 설명합니다.
+ `Categories`: *레스토랑* 또는 *학교*와 같이 장소를 설명하는 범주 목록입니다.
+ `PlaceType`: 도시, 주소 또는 리전과 같은 장소 유형을 지정합니다.
+ `BusinessChains`: 연결된 비즈니스 체인을 나타냅니다.
**추가 세부 정보**
요청에 따라 장소와 관련된 추가 데이터입니다.
+ `Contacts`: 이메일, 전화번호, 웹 사이트를 제공합니다.
+ `OpeningHours`: 장소의 운영 시간입니다.
+ `AccessPoints`: 장소와 연결된 지리적 좌표입니다.
+ `Phonemes`: 주소 구성 요소의 음성 표현입니다.
+ `TimeZone`: 오프셋을 포함한 시간대 정보입니다.