Geocode - Amazon Location Service
사용 사례요청 이해응답 이해

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

Geocode

지오코딩은 텍스트 주소 또는 장소 이름을 자세한 주소 구성 요소 및 추가 정보와 함께 지리적 좌표로 변환합니다. 이 API는 자유 형식 텍스트와 도로명, 우편 번호 및 리전이 포함된 구조화된 쿼리를 모두 포함하여 유연한 쿼리를 지원합니다. 선택적 기능에는 시간대 데이터 및 정치적 견해 조정이 포함됩니다.

참고

저장된 결과에는 더 높은 스토리지 요금이 발생합니다. IntendedUse 파라미터를 사용하여 일회용 또는 스토리지를 나타냅니다. 저장된 결과의 비용 영향을 이해하려면 Places 요금 섹션을 참조하세요.

자세한 내용은 Amazon Location Service API 참조의 Geocode 섹션을 참조하세요.

이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 지오코드를 사용하는 방법을 참조하세요.

사용 사례

  • 고객 주소에 보조 데이터 추가: 우편 번호, 좌표를 포함하고 영구 스토리지를 활용하여 정보에 입각한 비즈니스 및 마케팅 결정을 지원하여 주소 레코드를 개선합니다.

  • 주소 데이터 표준화: 지속적인 참조를 위해 영구 스토리지를 활용하여 데이터 파이프라인 또는 배치 프로세스에 지오코딩을 적용하여 주소 데이터를 표준화합니다.

  • 시간대 결정: 도시 또는 주소의 시간대를 식별하여 이동, 예약, 인보이스 발행과 같은 애플리케이션에 정확한 타임스탬프를 제공합니다.

요청 이해

요청은 AdditionalFeatures, BiasPosition 및 Filter 등과 같은 선택적 파라미터를 수락하여 검색 결과를 구체화합니다. Language, MaxResults 및 PoliticalView와 같은 추가 옵션을 사용하면 응답을 추가로 사용자 지정할 수 있습니다. 필수 파라미터는 Query이며 자유 형식 텍스트로 제공되거나 QueryComponents로 구조화될 수 있습니다. 자세한 내용은 Geocode API 참조를 참조하세요.

요청에는 다음 주요 파라미터가 포함됩니다.

인증

인증에서 다른 방법을 사용하는 경우 Key 파라미터는 선택 사항입니다.

  • Key: 인증을 위한 선택적 파라미터입니다.

자세한 내용은 Amazon Location Service로 인증 섹션을 참조하세요.

쿼리 및 편향

결과의 쿼리 및 지리적 편향에 사용되는 파라미터입니다.

  • QueryText: 위치 검색을 위한 자유 형식 텍스트 쿼리입니다.

  • QueryComponents: 정확한 검색을 위한 주소 번호, 국가, 지역 또는 우편 번호와 같은 구조화된 구성 요소입니다.

  • BiasPosition: 검색 결과를 편향시킬 지리적 위치입니다.

자세한 내용은 쿼리 및 편향 섹션을 참조하세요.

결과 구체화

필터를 적용하여 결과를 구체화합니다.

  • Filter: 특정 국가 또는 장소 유형을 포함하도록 필터링합니다. 자세한 내용은 필터링 섹션을 참조하세요.

국제화 및 현지화

현지화된 결과에 언어를 지정하고 정치적 견해를 적용합니다.

  • Language: 결과의 언어입니다.

  • PoliticalView: 지역 클레임을 반영하는 정치적 견해를 적용합니다.

자세한 내용은 현지화 및 국제화 섹션을 참조하세요.

추가 기능

시간대 세부 정보와 같은 추가 정보를 요청합니다.

  • AdditionalFeatures: 시간대와 같은 추가 세부 정보를 요청하는 옵션입니다. 자세한 내용은 기타 기능 섹션을 참조하세요.

응답 이해

응답은 Address, PlaceId, Position 및 기타 관련 속성과 같은 자세한 위치 데이터를 포함하는 ResultItems를 제공합니다. 각 쿼리 구성 요소에 대한 TimeZone 정보 또는 MatchScores와 같은 추가 기능도 포함될 수 있습니다. 각 ResultItem은 지정된 요청 파라미터를 기반으로 일치하는 위치 또는 지오코딩 결과를 나타냅니다. 자세한 내용은 Geocode API 참조를 참조하세요.

응답에는 다음 주요 파라미터가 포함됩니다.

주소 및 관련 세부 정보

주소 구성 요소를 포함하여 반환된 위치에 대한 세부 정보입니다.

  • Address: 국가, 리전, 우편 번호 및 도로명 세부 정보를 포함한 전체 주소입니다.

  • PostalCodeDetails: 우편 번호와 관련된 추가 정보입니다.

  • StreetComponents: 기본 이름 및 유형을 포함한 거리 세부 정보입니다.

장소 유형 및 범주

반환된 장소의 유형 및 범주에 대한 정보입니다.

  • Categories: 레스토랑, 학교 등과 같은 장소를 설명하는 범주 목록입니다.

  • PlaceType: 도시, 주소 또는 리전과 같은 장소 유형을 지정합니다.

결과 분석

결과가 입력 쿼리와 얼마나 일치하는지 나타내는 점수입니다.

  • MatchScores: 일치하는 정밀도에 대한 점수입니다.

    • Overall: 주소 검색이 입력과 얼마나 잘 일치하는지 0.0~1.0(0%~100%)의 척도로 측정합니다. 1.0의 완벽한 점수는 검색의 모든 부분이 데이터베이스에서 발견되었음을 의미합니다. 연락처 이름 또는 전송 지침과 같은 추가 세부 정보를 포함할 경우 점수가 낮은 것은 정상입니다. 이러한 정보가 자연스럽게 점수를 낮추지만 반드시 주소가 잘못되었다는 의미는 아닙니다.

    • Component Score: 각 주소 구성 요소(예: AddressNumber 또는 PostalCode)는 0.0~1.0(0%~100%)의 척도로 개별적으로 점수가 매겨집니다. 이러한 점수는 주소의 각 부분이 결과와 얼마나 정확하게 일치하는지 나타냅니다. 예를 들어 AddressNumber, Street 및 PostalCode 점수가 1.0에 가까우면 다른 쿼리 세부 정보로 인해 전체 점수가 낮더라도 해당 일치 항목을 신뢰할 수 있습니다.

    참고

    특정 구성 요소(예: Street)에 대한 점수가 표시되지 않으면 해당 구성 요소는 0으로 계산됩니다. 이렇게 하면 검증이 필요할 수 있는 주소 부분을 식별하는 데 도움이 됩니다.

    이 채점 시스템은 종종 추가 정보가 포함된 실제 주소 검색을 처리할 때 정확한 일치와 실제 사용성 간의 균형을 맞추는 데 도움이 됩니다.

추가 세부 정보

필요에 따라 추가 위치 관련 정보를 포함합니다.

  • AccessPoints: 액세스 포인트를 나타내는 지리적 좌표입니다.

  • TimeZone: 위치의 시간대 정보입니다.