주소를 지오코딩하는 방법 - Amazon Location Service
잠재적 사용 사례예시개발자 팁

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

주소를 지오코딩하는 방법

지오코드 API를 사용하면 특정 지점 주소, 보간된 주소 또는 거리를 지오코딩할 수 있습니다. API 응답에는 결과가 쿼리와 얼마나 정확하게 일치하는지 나타내는 지리적 좌표 및 일치 점수를 포함한 위치 정보가 포함됩니다.

잠재적 사용 사례

  • 주소 데이터베이스 정리: 주소 레코드의 오류를 식별하고 수정하여 데이터 품질을 개선합니다.

  • 주소 정규화 및 표준화: 데이터 상호 운용성을 개선하기 위해 데이터 세트 전반에서 일관된 주소 형식을 보장합니다.

  • 추가 정보로 주소 강화: 지리적 좌표 및 기타 관련 세부 정보를 추가하여 위치 기반 분석 및 인사이트를 지원하기 위해 레코드를 처리합니다.

예시

Sample request
{
  "QueryText": "510 W Georgia St, Vancouver, BC"
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
            "Address": {
                "Label": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Downtown Vancouver",
                "PostalCode": "V6B 0M3",
                "Street": "W Georgia St",
                "StreetComponents": [
                    {
                        "BaseName": "Georgia",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Prefix": "W",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "510"
            },
            "Position": [
                -123.11694,
                49.28126
            ],
            "MapView": [
                -123.11832,
                49.28036,
                -123.11556,
                49.28216
            ],
            "AccessPoints": [
                {
                    "Position": [
                        -123.11656,
                        49.28151
                    ]
                }
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Region": 1,
                        "Locality": 1,
                        "Intersection": [
                            1
                        ],
                        "AddressNumber": 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": "510 W Georgia St, Vancouver, BC"}'
AWS CLI
aws geo-places geocode --key ${YourAPIKey} --query-text "510 W Georgia St, Vancouver, BC"
Sample request
{
  "QueryComponents": {
    "AddressNumber": "510",
    "Locality": "Vancouver",
    "Region": "BC",
    "Country": "Canada",
    "Street": "Georgia"
  }
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
            "Address": {
                "Label": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Downtown Vancouver",
                "PostalCode": "V6B 0M3",
                "Street": "W Georgia St",
                "StreetComponents": [
                    {
                        "BaseName": "Georgia",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Prefix": "W",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "510"
            },
            "Position": [
                -123.11694,
                49.28126
            ],
            "MapView": [
                -123.11832,
                49.28036,
                -123.11556,
                49.28216
            ],
            "AccessPoints": [
                {
                    "Position": [
                        -123.11656,
                        49.28151
                    ]
                }
            ],
            "MatchScores": {
                "Overall": 0.99,
                "Components": {
                    "Address": {
                        "Country": 1,
                        "Region": 1,
                        "Locality": 1,
                        "Intersection": [
                            0.78
                        ],
                        "AddressNumber": 1
                    }
                }
            }
        },
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "InterpolatedAddress",
            "Title": "510 E Georgia St, Vancouver, BC V6A 1Z9, Canada",
            "Address": {
                "Label": "510 E Georgia St, Vancouver, BC V6A 1Z9, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Strathcona",
                "PostalCode": "V6A 1Z9",
                "Street": "E Georgia St",
                "StreetComponents": [
                    {
                        "BaseName": "Georgia",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Prefix": "E",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "510"
            },
            "Position": [
                -123.0932,
                49.27829
            ],
            "MapView": [
                -123.09458,
                49.27739,
                -123.09182,
                49.27919
            ],
            "AccessPoints": [
                {
                    "Position": [
                        -123.0932,
                        49.27842
                    ]
                }
            ],
            "MatchScores": {
                "Overall": 0.99,
                "Components": {
                    "Address": {
                        "Country": 1,
                        "Region": 1,
                        "Locality": 1,
                        "Intersection": [
                            0.78
                        ],
                        "AddressNumber": 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 '{"QueryComponents": {"AddressNumber": "510", "Locality": "Vancouver", "Region": "BC", "Country": "Canada", "Street": "Georgia"}}'
AWS CLI
./aws geo-places geocode --key ${YourAPIKey} --query-components '{
"AddressNumber" : "510", 
"Locality": "vancouver", 
"Region": "BC", 
"Country": "Canada", 
"Street": "Georgia"}'
Sample request
{
  "QueryText": "W. 6th St",
  "QueryComponents": {
    "AddressNumber": "415",
    "Locality": "Vancouver"
  }
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "415 W 6th St, Vancouver, WA 98660-3375, United States",
            "Address": {
                "Label": "415 W 6th St, Vancouver, WA 98660-3375, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "WA",
                    "Name": "Washington"
                },
                "SubRegion": {
                    "Name": "Clark"
                },
                "Locality": "Vancouver",
                "District": "Esther Short",
                "PostalCode": "98660-3375",
                "Street": "W 6th St",
                "StreetComponents": [
                    {
                        "BaseName": "6th",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Prefix": "W",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "415"
            },
            "Position": [
                -122.67543,
                45.62527
            ],
            "MapView": [
                -122.67672,
                45.62437,
                -122.67414,
                45.62617
            ],
            "AccessPoints": [
                {
                    "Position": [
                        -122.67543,
                        45.62506
                    ]
                }
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Locality": 1,
                        "Intersection": [
                            1
                        ],
                        "AddressNumber": 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": "W. 6th St", "QueryComponents": {"AddressNumber": "415", "Locality": "Vancouver"}}'
AWS CLI
./aws geo-places geocode -key ${YourAPIKey} --query-text "W. 6th St" \
--query-components '{"AddressNumber" : "415", "Locality": "Vancouver"}'

개발자 팁

IncludeCountries 및와 같은 필터를 사용하여 정확한 결과를 얻을 IncludePlaceTypes 수 있습니다. 예를 들어 미국의 밴쿠버가 필요한 경우 "IncludeCountries": ["USA"]를 적용하여 미국의 결과를 우선시합니다. 자세한 내용은 필터를 사용하여 지오코딩하는 방법를 참조하세요.

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