기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GetPlace
<a name="get-place"></a>

GetPlace는 고유한 `PlaceId`를 사용하여 장소에 대한 세부 정보를 검색합니다. 요청은 시간대 데이터 또는 음소 및 언어 현지화 등과 같은 추가 기능에 대한 선택적 파라미터를 지원합니다. API는 주소, 좌표, 비즈니스 세부 정보, 연락 방법 및 시간대 정보와 같은 정보를 반환합니다.

**참고**  
결과가 저장되면 더 높은 스토리지 요금 계층으로 요금이 청구됩니다. `IntendedUse` 파라미터를 사용하여 결과가 일회용인지 저장용인지 지정합니다. 저장된 결과와 관련된 비용 세부 정보는 [Places 요금](places-pricing.md) 섹션을 참조하세요.

자세한 내용은 *Amazon Location Service API 참조*의 [GetPlace](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html) 섹션을 참조하세요.

이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 [GetPlace 사용 방법](https://docs.aws.amazon.com/location/latest/developerguide/get-place-how-to.html)을 참조하세요.

## 사용 사례
<a name="get-place-use-cases"></a>
+ **저장된 데이터 새로 고침:** 저장된 데이터를 정기적으로 새로 고쳐 애플리케이션이 정확한 최신 정보를 제공하도록 합니다. GetPlace API를 사용하여 비즈니스 및 장소에 대한 세부 정보를 업데이트하여 사용자에게 최신 정보를 제공합니다. 예를 들어, 사용자 신뢰 및 애플리케이션 기능을 개선하기 위해 현지 레스토랑 또는 상점에 대한 영업 시간, 연락처 세부 정보 및 사용자 리뷰를 새로 고칩니다.
+ **미리 입력 제안 후 장소 세부 정보 검색:** GetPlace API를 자동 완성 또는 제안 기능과 통합하여 사용자 경험을 개선합니다. 사용자가 주소, 비즈니스 이름 또는 관심 지점을 입력하면 제안을 통해 관련 장소를 제공하며, GetPlace를 사용하면 선택한 후 더 자세한 정보에 액세스할 수 있습니다.

## 요청 이해
<a name="get-place-request-parameters"></a>

**참고**  
 `ap-southeast-1` 및의 고객의 경우 `ap-southeast-5`지원되는 요청 및 응답 필드가 다를 수 있습니다. 자세한 내용은 [GetPlace API 참조](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)를 참조하세요.

GetPlace API 요청에는 `PlaceId`와 같은 특정 파라미터가 필요하며 추가 기능 또는 언어 현지화를 위한 선택적 파라미터를 지원합니다. 이러한 파라미터는 언어, 용도 및 지리적 컨텍스트에 따라 결과를 조정하는 데 도움이 됩니다. 자세한 내용은 GetPlace API 참조를 참조하세요.

요청은 다음 주요 파라미터를 수용합니다.

**Authentication**  
다른 인증 방법을 사용하는 경우 `Key` 파라미터는 선택 사항입니다.  
+ `Key`: 권한 부여를 위한 API 키입니다.
자세한 내용은 [Amazon Location Service로 인증](access.md) 단원을 참조하십시오.

**쿼리**  
장소 정보를 검색하기 위한 고유 식별자를 정의합니다.  
+ `PlaceId`: 장소의 고유 식별자입니다(필수).
자세한 내용은 [쿼리 및 편향](places-querying-biasing.md) 단원을 참조하십시오.

**국제화 및 현지화**  
언어를 사용자 지정하고 결과에 정치적 견해를 적용하는 옵션입니다.  
+ `Language`: 결과의 언어를 지정합니다.
+ `PoliticalView`: 지역 클레임을 반영하는 정치적 견해를 적용합니다.
자세한 내용은 [현지화 및 국제화](places-localization-internationalization.md) 단원을 참조하십시오.

**추가 기능**  
시간대 세부 정보와 같은 추가 데이터를 요청합니다.  
+ `AdditionalFeatures`: 시간대 또는 음소 세부 정보와 같은 추가 정보를 요청하는 옵션입니다.
자세한 내용은 [기타 기능](additional-features.md) 단원을 참조하십시오.

## 응답 이해
<a name="get-place-response-details"></a>

GetPlace API의 응답에는 주소, 좌표, 비즈니스 세부 정보와 같은 기본 데이터뿐만 아니라 요청 파라미터를 기반으로 하는 추가 데이터도 포함됩니다. 액세스 제한, 시간대 및 발음을 위한 음소 세부 정보와 같은 정보도 제공할 수 있습니다. 자세한 내용은 GetPlace API 참조를 참조하세요.

응답에는 다음 주요 데이터가 포함됩니다.

**주소 및 관련 세부 정보**  
위치에 대한 전체 주소 세부 정보를 제공합니다.  
+ `Address`: 국가, 리전 및 우편 번호를 포함한 전체 주소 정보입니다.
+ `PostalCodeDetails`: 우편 번호 및 권한에 대한 추가 정보입니다.

**장소 유형 및 범주**  
장소의 유형과 범주를 설명합니다.  
+ `BusinessChains`: 연결된 비즈니스 체인에 대한 정보입니다.
+ `Categories`: 음식점 또는 소매점과 같이 장소가 속한 범주입니다.
+ `PlaceType`: 관심 지점 또는 지역성과 같은 장소의 유형입니다.

**추가 세부 정보**  
요청에 지정된 대로 장소에 대한 추가 데이터를 제공합니다.  
+ `Contacts`: 전화번호, 이메일 및 웹 사이트를 포함한 연락 방법입니다.
+ `OpeningHours`: 업무 시간 또는 액세스 시간입니다.
+ `AccessPoints`: 액세스 포인트의 지리적 좌표(경도 및 위도)입니다.
+ `Phonemes`: 다양한 주소 구성 요소에 대한 발음입니다.
+ `TimeZone`: 오프셋을 포함한 시간대 정보입니다.