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

# 지리 공간 컨텍스트를 사용하여 지오코딩하는 방법
<a name="how-to-geocode-geospatial"></a>

Geocode API를 사용하면 지리 공간 컨텍스트(예: 바이어스 위치)를 사용하여 원하는 결과를 얻을 수 있습니다.

**참고**  
“바이어스 위치”는 사용자의 지정된 위치 또는 정의된 영역을 기반으로 검색 결과의 우선순위를 지정하는 메커니즘을 말합니다. 다른 결과를 제외하지 않고도 검색 결과의 초점을 지정된 바이어스 지점에 지리적으로 가까운 위치로 이동시킵니다.

## 잠재적 사용
<a name="geospatial-uses"></a>

지리 공간 컨텍스트를 사용하여 비즈니스 요구 사항에 따라 올바른 결과를 얻습니다.

## 예제
<a name="geospatial-examples"></a>

### 위치에 대한 바이어스 결과
<a name="bias-position-example"></a>

위치에 바이어스를 지정하여 결과의 순위를 변경할 수 있습니다. `BiasPosition` 값을 사용한 다음, 사용하지 않고 다음 예제를 시도한 후 결과를 비교합니다.

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

```
{
    "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "George St, Sydney NSW, Australia",
            "Address": {
                "Label": "George St, Sydney NSW, Australia",
                "Country": {
                    "Code2": "AU",
                    "Code3": "AUS",
                    "Name": "Australia"
                },
                "Region": {
                    "Code": "NSW",
                    "Name": "New South Wales"
                },
                "Locality": "Sydney",
                "Street": "George St",
                "StreetComponents": [
                    {
                        "BaseName": "George",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ]
            },
            "Position": [
                151.20691,
                -33.86974
            ],
            "Distance": 117,
            "MapView": [
                151.20225,
                -33.88406,
                151.20912,
                -33.85635
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Intersection": [
                            1
                        ]
                    }
                }
            }
        },
        ...
        ...
    ]
}
```

------
#### [ 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": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}'
```

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

```
aws geo-places geocode --key ${YourKey} --query-text "George Street" --bias-position 151.2059 -33.8691
```

------

## 개발자 팁
<a name="geospatial-developer-tips"></a>

주소 지오코딩의 경우 국가 및 장소를 포함한 바이어스 위치를 조합하여 전체 주소 또는 쿼리 구성 요소를 사용합니다. 자세한 내용은 [주소를 지오코딩하는 방법](how-to-geocode-address.md)를 참조하세요.