기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 관리 영역 및 우편 지역을 지오코딩하는 방법
Geocode API를 사용하면 국가, 리전(주 또는 도) 또는 도시의 이름과 같은 쿼리 텍스트 입력을 사용하여 지리적 영역에 대한 지오코딩을 수행할 수 있습니다. API 응답에는 지리적 좌표, 맵 시각화를 위한 경계 상자, 쿼리에 대한 결과의 관련성을 나타내는 일치 점수와 같은 위치 세부 정보가 포함됩니다.
## 잠재적 사용 사례
+ **관리 영역에 대한 좌표 가져오기:** 좌표를 다른 Places API의 바이어스 위치 또는 중심으로 사용합니다.
+ **맵에서 정보 시각화:** 지오코딩된 좌표를 사용하여 맵에서 데이터를 시각적으로 표시할 수 있습니다.
## 예제
### 국가 지오코딩
------
#### [ Sample request ]
```
{
"QueryText": "Canada"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId":"",
"PlaceType": "Country",
"Title": "Canada",
"Address": {
"Label": "Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
}
},
"Position": [-75.69122, 45.42177],
"MapView": [-141.00271, 41.67659, -52.61901, 83.11062],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Country": 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": "Canada"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places geocode --key ${YourAPIKey} --query-text "Canada"
```
------
### 리전 지오코딩
------
#### [ Sample request ]
```
{
"QueryText": "BC"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "Region",
"Title": "BC, Canada",
"Address": {
"Label": "BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
}
},
"Position": [-123.36445, 48.42854],
"MapView": [-139.04941, 48.22478, -114.05201, 60.00043],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Region": 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": "BC"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places geocode --key ${YourAPIKey} --query-text "BC"
```
------
### 도시 지오코딩
------
#### [ Sample request ]
```
{
"QueryText": "Vancouver"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "Locality",
"Title": "Vancouver, BC, Canada",
"Address": {
"Label": "Vancouver, BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"PostalCode": "V5Y"
},
"Position": [-123.11336, 49.26038],
"MapView": [-123.26754, 49.19891, -123.02301, 49.33557],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Locality": 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": "Vancouver"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places geocode --key ${YourAPIKey} --query-text "Vancouver"
```
------
### 우편 번호 지오코딩
우편 번호를 지오코딩할 수 있습니다. 보다 정확한 결과를 얻으려면 `IncludePlaceTypes`와 `["PostalCode"]`를 함께 사용합니다.
------
#### [ Sample request ]
```
{
"QueryText": "800006",
"Filter": { "IncludePlaceTypes": ["PostalCode"] }
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PostalCodeArea",
"Title": "800006, Patna, Bihar, India",
"Address": {
"Label": "800006, Patna, Bihar, India",
"Country": {
"Code2": "IN",
"Code3": "IND",
"Name": "India"
},
"Region": {
"Code": "BR",
"Name": "Bihar"
},
"SubRegion": { "Name": "Patna" },
"Locality": "Patna",
"PostalCode": "800006"
},
"Position": [85.18048, 25.61532],
"MapView": [85.16599, 25.60054, 85.19103, 25.6221],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "PostalCode": 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": "800006",
"Filter": { "IncludePlaceTypes": ["PostalCode"] }
}'
```
------
#### [ AWS CLI ]
```
aws geo-places geocode --key ${YourAPIKey} --query-text "800006" --filter '{"IncludePlaceTypes": ["PostalCode"]}'
```
------
## 개발자 팁
보다 구체적인 결과를 얻으려면 `IncludeCountries` 및 `IncludePlaceTypes`와 같은 필터를 사용합니다. 예를 들어 미국의 밴쿠버에서 결과를 보장하려면 `"IncludeCountries": ["USA"]`를 설정합니다. 자세한 내용은 섹션을 참조하십시오.
```
{
"QueryText": "Vancouver",
"Filter": { "IncludeCountries": ["USA"] }
}
```