관리 및 우편 영역을 지오코딩하는 방법

지오코드 API를 사용하면 국가, 리전(주 또는 도) 또는 도시의 이름과 같은 쿼리 텍스트 입력을 사용하여 지리적 영역에 대한 지오코딩을 수행할 수 있습니다. API 응답에는 지리적 좌표, 맵 시각화를 위한 경계 상자, 쿼리에 대한 결과의 관련성을 나타내는 일치 점수와 같은 위치 세부 정보가 포함됩니다.

잠재적 사용 사례

• 관리 영역에 대한 좌표 가져오기: 좌표를 다른 Places APIs의 바이어스 위치 또는 중심으로 사용합니다.

• 맵에서 정보 시각화: 지오코딩된 좌표를 사용하여 맵에 데이터를 시각적으로 표시할 수 있습니다.

예시

국가 지오코딩

Sample request

{
  "QueryText": "Canada"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId":"<Redacted>",
            "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": "<Redacted>",
            "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": "<Redacted>",
            "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"

우편 번호 지오코드

우편 번호를 지오코딩할 수 있습니다. 보다 정확한 결과를 ["PostalCode"] 얻으려면와 IncludePlaceTypes 함께를 사용합니다.

Sample request

{
  "QueryText": "800006",
  "Filter": { "IncludePlaceTypes": ["PostalCode"] }
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "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"]}'

개발자 팁

보다 대상화된 결과를 IncludePlaceTypes 얻으려면 IncludeCountries 및와 같은 필터를 사용합니다. 예를 들어 미국에서 밴쿠버의 결과를 보장하려면를 설정합니다"IncludeCountries": ["USA"]. 자세한 내용은 섹션을 참조하십시오.

{
  "QueryText": "Vancouver",
  "Filter": { "IncludeCountries": ["USA"] }
}