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

# Reverse Geocode
<a name="reverse-geocode"></a>

Reverse Geocode는 지리적 좌표를 사람이 읽을 수 있는 주소 또는 장소로 변환합니다. 세부 주소 구성 요소, 장소 유형, 범주 및 거리 정보와 장소 유형에 따른 필터링 옵션을 제공하여 결과를 구체화합니다. API에는 시간대 정보 및 정치적 관점 조정과 같은 추가 기능도 포함될 수 있습니다.

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

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

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

## 사용 사례
<a name="reverse-geocode-use-cases"></a>
+ **고객 위치 데이터에 보조 데이터 추가:** 우편 번호, 좌표를 포함하고 영구 스토리지를 활용하여 정보에 입각한 비즈니스 및 마케팅 결정을 지원하여 위치 데이터 레코드를 개선합니다.
+ **위치 데이터 표준화:** 지속적인 참조를 위해 영구 스토리지를 활용하여 데이터 파이프라인 또는 배치 프로세스에 지오코드를 적용하여 위치 데이터를 표준화합니다.
+ **시간대 결정:** 도시 또는 주소의 시간대를 식별하여 이동, 예약, 인보이싱과 같은 애플리케이션에 정확한 타임스탬프를 제공합니다.

## 요청 이해
<a name="reverse-geocode-request-parameters"></a>

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

Reverse Geocode API 요청은 필수 파라미터와 선택적 파라미터의 조합을 수락하여 결과를 사용자 지정합니다. 필수 파라미터 `QueryPosition`(경도 및 위도)는 역방향 지오코드 좌표를 지정합니다. 선택적 파라미터에는 `AdditionalFeatures` 추가 데이터, 결과 `Filter` 구체화, 반환된 결과 수 `MaxResults` 제한 등이 포함됩니다. `Language`, `PoliticalView`, `IntendedUse`와 같은 추가 옵션을 사용하면 사용자 지정을 추가할 수 있습니다. 자세한 내용은 Reverse Geocode API 참조를 참조하세요.

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

**Authentication**  
다른 인증 방법을 사용하는 경우 `Key` 파라미터는 선택 사항입니다.  
+ `Key`: 인증을 위한 선택적 파라미터입니다.
자세한 내용은 [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="reverse-geocode-response-details"></a>

Reverse Geocode API의 응답은 지정된 좌표의 위치에 대한 자세한 정보를 제공합니다. `ResultItems` 배열에는 각각 주소 세부 정보, 범주 및 지리적 위치를 포함하는 장소 객체 목록이 포함됩니다. `TimeZone`, `FoodTypes`, `PostalCodeDetails`와 같은 추가 데이터는 추가 컨텍스트를 제공합니다. 응답에는 매핑을 위한 경계 상자 정보와 쿼리 위치로부터의 거리도 포함됩니다. 자세한 내용은 Reverse Geocode API 참조를 확인하세요.

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

**주소 및 관련 세부 정보**  
반환된 위치에 대한 자세한 주소 정보입니다.  
+ `Address`: 국가, 리전, 우편 번호 및 도로명 세부 정보를 포함한 전체 주소 정보입니다.
+ `PostalCodeDetails`: 분류 및 우편 기관과 같은 우편 번호와 관련된 추가 세부 정보입니다.
+ `StreetComponents`: 기본 이름 및 유형을 포함하여 거리에 대한 추가 세부 정보입니다.

**장소 유형 및 범주**  
반환된 장소의 유형과 범주를 설명합니다.  
+ `Categories`: *레스토랑* 또는 *학교*와 같이 장소를 설명하는 범주입니다.
+ `PlaceType`: 도시, 주소 또는 리전과 같은 장소 유형을 지정합니다.

**결과 분석**  
각 결과가 입력 쿼리와 얼마나 일치하는지에 대한 정보입니다.  
+ `MatchScores`: 입력 쿼리에 대한 각 일치의 정확도를 나타내는 점수입니다.

**추가 세부 정보**  
추가 위치 관련 데이터를 제공합니다.  
+ `TimeZone`: 위치의 시간대 정보입니다.
+ `AccessPoints`: 위치를 가리키는 진입점을 나타내는 지리적 좌표입니다.