Geocoding API 개요

유럽 경제 지역 (EEA) 개발자

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

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

다음 단계