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

# 주소 이름 변형을 제어하는 방법
<a name="how-to-geocode-address-names-mode"></a>

`AddressNamesMode`는 주소 이름을 반환하는 방법을 지정합니다. 설정하지 않으면 서비스는 기본적으로 정규화된(공식) 이름을 반환합니다. 로 설정하면 응답의 `Matched`주소 이름은 공식 이름이 아닌 입력 쿼리를 기반으로 합니다. 로 설정하면 `Administrative`서비스는 주소 구성 요소의 공식 관리 이름을 반환합니다.는 `Administrative` 현재 미국 내 주소에만 적용됩니다.

## 잠재적 사용 사례
<a name="geocode-address-names-mode-use"></a>
+ **주소 양식 완성:** 사용자가 입력한 것과 일치하는 이름을 반환`Matched`하여 자동 완성 워크플로의 혼동을 줄이는 데 사용합니다.
+ **주소 표준화:** 데이터 품질 및 중복 제거를 위해 도시 이름을 공식 관리 양식으로 정규화`Administrative`하는 데 사용합니다.

## 예제
<a name="geocode-address-names-mode-example"></a>

### 일치 모드 사용
<a name="geocode-address-names-mode-matched"></a>

------
#### [ Sample request ]

```
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal City Plz, Universal City, CA 91608, United States",
            "Address": {
                "Label": "100 Universal City Plz, Universal City, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Universal City",
                "PostalCode": "91608",
                "Street": "Universal City Plz",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Matched
```

------

### 관리 모드 사용
<a name="geocode-address-names-mode-administrative"></a>

------
#### [ Sample request ]

```
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
            "Address": {
                "Label": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Los Angeles",
                "PostalCode": "91608",
                "Street": "Universal Terrace Pkwy",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Administrative
```

------

## 개발자 팁
<a name="geocode-address-names-mode-dev-tips"></a>
+ 설정하지 않으면 서비스는 기본적으로 정규화된(공식) 이름을 반환합니다.
+ `Administrative`는 현재 미국 내 주소에만 적용됩니다.