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 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.

다음 단계