Geocoding API는 장소를 주소, 위도 및 경도 좌표 또는 장소 ID로 허용하는 서비스입니다. 주소를 위도 및 경도 좌표와 장소 ID로 변환하거나 위도 및 경도 좌표 또는 장소 ID를 주소로 변환합니다.
Geocoding API로 할 수 있는 작업
Geocoding API를 사용하여 다음을 비롯한 하나 이상의 주소 또는 장소의 지오코딩 데이터를 가져올 수 있습니다.
이 Geocoding API v4 버전에는 다음 엔드포인트 출시가 포함되어 있습니다.
- 주소 지오코딩 - 주소의 지리적 좌표입니다. 정방향 지오코딩 이라고도 합니다.
- 위치 지오코딩 - 위도 및 경도 좌표 집합의 주소입니다. 역 지오코딩 이라고도 합니다.
- 장소 지오코딩 - 장소 ID에서 주소를 가져옵니다.
- 목적지 검색 - 주소, 장소 ID 또는 위치에서 목적지를 검색합니다.
결과가 표시되는 위치를 제어하고 결과를 특정 지역, 카운티 또는 우편번호로 제한할 수 있습니다.
데모 사용해 보기
Geocoding API의 작동 방식
Geocoding API는 지오코딩과 역 지오코딩을 모두 실행합니다.
- 지오코딩: '서울특별시 강남구 테헤란로 152'와 같은 주소를 위도 및 경도 좌표 또는 장소 ID로 변환합니다. 이러한 좌표를 사용하여 지도에 마커를 배치하거나 뷰 프레임 내에서 지도를 가운데에 배치하거나 위치를 변경할 수 있습니다.
- 역 지오코딩: 위도 및 경도 좌표 또는 장소 ID를 사람이 읽을 수 있는 주소로 변환합니다. 배송 또는 픽업을 비롯한 다양한 시나리오에서 주소를 사용할 수 있습니다.
다음 표에는 Geocoding API를 통해 사용할 수 있는 리소스와 각 메서드가 반환하는 데이터가 요약되어 있습니다.
| 데이터 리소스 | 반환된 데이터 | 반환 형식 |
|---|---|---|
| 지오코딩 | 주소, 주소 구성요소, 주소 유형을 반환합니다. 지오코드 응답 문서를 참고하세요. |
|
| 역 지오코딩 | 주소, 주소 구성요소, 주소 유형을 반환합니다. 역 지오코딩 응답 문서를 참고하세요. | |
| 장소 지오코딩 | 주소, 주소 구성요소, 주소 유형을 반환합니다. 장소 지오코딩 응답 문서를 참고하세요. | |
| 목적지 검색 | 주소, 장소 ID 또는 위도 및 경도 좌표와 같은 다양한 입력 기준에 따라 다양한 목적지에 관한 세부정보를 반환합니다. 목적지 검색 문서를 참고하세요. |
Geocoding API v4의 기능
Geocoding API 버전 4는 다음과 같은 새로운 기능을 제공합니다.
목적지 검색 메서드
v4에는 목적지 검색 메서드가 도입되었습니다. 이 메서드를 사용하면 주소, 장소 ID 또는 위도 및 경도 좌표와 같은 다양한 입력 기준에 따라 다양한 목적지에 관한 세부정보를 가져올 수 있습니다. 응답에는 정확한 경로 지정을 위해 Navigation SDK에 전달할 수 있는 컨텍스트 정보가 포함된 AI 기반 요약 및 탐색 지점 토큰이 포함됩니다.
Google Cloud 표준 플랫폼에 구현됨
Geocoding API v4는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현은 OAuth와 같은 향상된 보안 옵션을 갖춘 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 API 설계는 Geocoding API v4를 사용한 개발 효율성을 개선하는 API 전반에 일관성을 제공합니다.
OAuth 지원 추가됨
Geocoding API v4는 인증을 위해 OAuth 2.0 사용을 지원합니다. Google은 웹 서버와 같은 일반적인 OAuth 2.0 시나리오를 지원합니다.
필드 마스크 지원 추가됨
필드 마스크를 사용하여 응답에서 반환해야 하는 정보를 지정합니다. 주소 지오코딩, 위치 지오코딩, 장소 지오코딩 메서드의 경우 응답 객체의 모든 필드가 기본적으로 반환됩니다. 목적지 검색 메서드의 경우 API 요청에서 필드 마스크를 지정해야 합니다.
API 보안
Geocoding API v4는 서버 간 API로 설계되었습니다. 브라우저에서 직접 클라이언트 측 호출은 HTTP 리퍼러 제한이 웹 서비스 엔드포인트를 충분히 보호하지 못하므로 API 키가 도난 및 오용될 위험이 큽니다.
자체 백엔드 서버에서 Geocoding API v4를 호출하는 것이 좋습니다. 클라이언트 측 요구사항에 관한 보안 구현 패턴 및 대안에 관한 자세한 내용은 보안 고려사항을 참고하세요.