Geocoding API 개요

Geocoding API는 장소를 주소, 위도 및 경도 좌표 또는 장소 ID로 허용하는 서비스입니다. 주소를 위도 및 경도 좌표와 장소 ID로 변환하거나, 위도 및 경도 좌표 또는 장소 ID를 주소로 변환합니다.

Geocoding API의 장점

Google Maps Platform API 중 하나에서 제공하는 지도 내에서 지오코딩 데이터를 사용하려면 웹사이트 또는 모바일 애플리케이션에 Geocoding API를 사용하세요. Geocoding API에서는 주소를 사용하여 지도에 마커를 배치하거나 지도의 마커를 주소로 변환합니다. 이 서비스는 애플리케이션 콘텐츠를 지도에 배치하기 위해 사전 정의된 고정 주소를 지오코딩하도록 설계되었습니다.

Geocoding API로 할 수 있는 작업

다음을 포함하여 Geocoding API를 사용하여 하나 이상의 주소 또는 장소의 지오코딩 데이터를 가져올 수 있습니다.

  • 주소의 지리 좌표입니다.
  • 위도 및 경도 좌표 세트의 주소입니다.
  • 장소 ID의 주소입니다.

결과가 표시되는 위치를 제어하고 결과를 특정 지역, 카운티 또는 우편번호로 제한할 수 있습니다.

Geocoding API의 작동 방식

Geocoding API는 지오코딩과 역 지오코딩을 모두 수행합니다.

  • 지오코딩: '1600 Amphitheatre Parkway, Mountain View, CA' 등의 주소를 위도 및 경도 좌표나 장소 ID로 변환합니다. 이 좌표를 사용하여 지도에 마커를 배치하거나 뷰 프레임 내에서 지도의 중심을 맞추거나 위치를 변경할 수 있습니다.
  • 역 지오코딩: 위도/경도 좌표 또는 장소 ID를 사람이 읽을 수 있는 주소로 변환합니다. 배송 또는 수령을 비롯한 다양한 시나리오에서 주소를 사용할 수 있습니다.

다음 데모에서는 Maps JavaScript API를 통해 지오코딩 서비스를 사용하여 Geocoding API의 작동 방식을 보여줍니다. 별도의 탭에서 지도를 열고 더 많은 옵션과 세부정보를 확인하세요.

자료

다음 표에는 각 엔드포인트에서 반환하는 데이터와 함께 Geocoding API를 통해 사용할 수 있는 리소스가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
지오코딩 주소, 주소 구성요소, 주소 유형을 반환합니다. 지오코딩 요청 및 응답 가이드의 결과를 참고하세요.
  • JSON
  • XML
역 지오코딩 주소, 주소 구성요소, 주소 유형을 반환합니다. 역 지오코딩 요청 및 응답 가이드의 역 지오코딩 응답을 참고하세요.
장소 지오코딩 주소, 주소 구성요소, 주소 유형을 반환합니다. 지오코딩 지오코딩 요청 및 응답 가이드의 역 지오코딩 응답을 참고하세요.

Geocoding API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정부터 시작하여 설정 안내를 완료합니다.
2 지오코딩 요청 시도하기 API 키가 있으면 cURL 또는 브라우저에서 직접 Geocoding API 테스트를 시작할 수 있습니다. 주소 또는 구성요소 조회를 위한 올바른 조회 매개변수를 제공해야 합니다. 자세한 내용은 지오코딩 매개변수를 참고하세요.
3 역 지오코딩 요청 시도 API 키와 함께 위도/경도 좌표를 제공하여 이 위치에서 사람이 읽을 수 있는 가장 가까운 주소의 주소 구성요소를 가져오세요. 자세한 내용은 역 지오코딩 요청 을 참고하세요.
4 응답 기본사항 이해하기 Geocoding API의 모든 엔드포인트는 JSON 또는 XML로 동일한 데이터를 반환합니다. 데이터, 상태 코드, 오류 메시지에 대한 설명은 지오코딩 응답을 참조하세요.
5 앱에 지오코딩 데이터를 통합합니다. 지오코딩 데이터를 사용하여 지도 마커에서 주소를 가져오거나 알려진 주소를 기반으로 지도에 마커를 제공할 수 있습니다.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.

Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 커뮤니티 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드할 수 있으며 설치 안내 및 샘플 코드도 제공됩니다.

다음 단계