Geocoding API는 장소를 주소, 위도 및 경도 좌표 또는 장소 ID로 허용하는 서비스입니다. 주소를 위도 및 경도 좌표와 장소 ID로 변환하거나 위도 및 경도 좌표 또는 장소 ID를 주소로 변환합니다.
Geocoding API로 할 수 있는 작업
Geocoding API를 사용하여 다음을 비롯한 하나 이상의 주소 또는 장소에 대한 지오코딩 데이터를 가져올 수 있습니다.
Geocoding API v4의 이번 출시에는 다음 엔드포인트의 출시가 포함됩니다.
- (미리보기) 주소 지오코딩: 주소의 지리 좌표입니다. 정방향 지오코딩이라고도 합니다.
- (미리보기) 위치 지오코드: 위도 및 경도 좌표 집합의 주소입니다. 역 지오코딩이라고도 합니다.
- (미리보기) 장소 지오코딩: 장소 ID에서 주소를 가져옵니다.
- (미리보기) 목적지 검색: 주소, 장소 ID 또는 위치에서 목적지를 검색합니다.
결과가 표시되는 위치를 제어하고 결과를 특정 지역, 카운티 또는 우편번호로 제한할 수 있습니다.
Geocoding API 작동 방식
Geocoding API는 지오코딩과 역 지오코딩을 모두 실행합니다.
- 지오코딩: '1600 Amphitheatre Parkway, Mountain View, CA'와 같은 주소를 위도 및 경도 좌표 또는 장소 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 설계는 API 전반에 일관성을 제공하여 Geocoding API v4를 사용한 개발 효율성을 개선합니다.
OAuth 지원 추가
Geocoding API v4는 인증에 OAuth 2.0 사용을 지원합니다. Google은 웹 서버용과 같은 일반적인 OAuth 2.0 시나리오를 지원합니다.
필드 마스크 지원 추가
필드 마스크를 사용하여 응답에서 반환해야 하는 정보를 지정합니다. 주소 지오코딩, 위치 지오코딩, 장소 지오코딩 엔드포인트의 경우 응답 객체의 모든 필드가 기본적으로 반환됩니다. 여행지 검색 엔드포인트의 경우 API 요청에 필드 마스크를 지정해야 합니다.
미리보기 기간 중 사용에 대한 비용 없음
Geocoding API v4는 GA 전 미리보기 단계에 있으며 미리보기 중에는 API 사용에 대한 요금이 청구되지 않습니다. API 호출은 Cloud 콘솔의 결제 페이지에 표시되지만 요금은 0달러입니다.
의견
이 기능은 미리보기 기능입니다. geocoding-feedback-channel@google.com으로 의견을 보내주시면 감사하겠습니다.