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를 통해 사용할 수 있는 리소스와 각 엔드포인트에서 반환하는 데이터가 요약되어 있습니다.

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

Geocoding API 사용 방법

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

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

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

Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계