지오코딩은 주소 (예: 상세 주소)를 지리 좌표 (위도 및 경도)로 변환하는 프로세스이며, 이를 사용하여 지도에 마커를 배치하거나 지도의 위치를 지정할 수 있습니다. 이 문서에서는 주소를 지오코딩할 때 고려할 사항을 명확히 설명합니다. Geocoding API를 사용하기에 최적인 시기와 Places API Place Autocomplete 서비스를 사용하는 것이 유리한 경우를 설명합니다.
일반적으로 전체 주소를 지오코딩할 때는 Geocoding API를 사용합니다 (예: '48 Pirrama Rd, Pyrmont, NSW, Australia'). 모호한 (불완전한) 주소를 지오코딩할 때 또는 사용자 입력에 응답할 때처럼 지연 시간에 민감한 애플리케이션에는 Places API Place Autocomplete 서비스를 사용합니다.
사용 사례 및 API 권장 사항
| 사용 사례 및 API 권장 사항 | |
|---|---|
| 사용자 입력에 실시간으로 응답(모호하거나 완전하지 않거나 형식이 잘못 지정되었거나 사용자가 잘못 입력한 주소 포함) | Places API Place Autocomplete 서비스를 사용하여 장소 ID를 가져온 다음 Geocoding API를 사용하여 장소 ID를 latlng로 지오코딩합니다. |
| 자동화된 완전하고 명확한 우편 주소(예: '48 Pirrama Rd, Pyrmont, NSW, Australia') | Geocoding API 웹 서비스 사용 |
| 모호한 쿼리를 처리하는 자동 시스템(예: 불완전하거나 형식이 잘못되었거나 주소 철자가 틀림) | 자동 시스템에서 Geocoding API 웹 서비스를 사용하는 것이 좋습니다. 그러나 사용자 입력에서 파생된 모호하거나 불완전하거나 맞춤법 오류가 높은 자동화 시스템을 사용하는 경우 대화형 장소 자동 완성 위젯을 추가하여 사용자가 결과를 선택할 수 있으므로 주소를 잘못 입력하는 것을 방지할 수 있습니다. |
| 주소 문자열로 지정된 출발지, 목적지 또는 경유지가 있는 Directions API 또는 Distance Matrix API를 사용한 지연 시간 문제 | Places API Place Autocomplete 서비스를 사용하여 장소 ID를 얻은 다음 지오코딩 지연 시간을 줄이고 장소 ID를 Directions API 또는 Distance Matrix API에 전달합니다. |
사용자 입력에 응답
사용자 입력에 실시간으로 응답하는 애플리케이션에서는 API 선택에 영향을 미치는 두 가지 주요 고려사항이 있습니다.
- 사용자 입력에는 일반적으로 점진적으로 주소를 입력해야 하므로 (예: '123 Main Street') 사용자가 불완전하고 모호한 주소를 지오코딩할 수 있으므로 사용자가 더 빠르게 검색결과를 확인할 수 있습니다.
- 사용자 입력에 응답하는 애플리케이션은 지연 시간에 매우 민감합니다.
이 두 가지 고려사항 때문에 Places API의 Place Autocomplete 서비스는 사용자 입력에 응답하는 사용 사례에 적합합니다. Place Autocomplete는 가능한 여러 옵션을 반환하고 사용자가 이러한 옵션 중에서 선택할 수 있도록 설계되었습니다. Places API는 비즈니스를 제외하고 지오코딩 또는 주소만 검색하도록 제한할 수 있습니다. 또한 자동 완성 조회 함수를 사용하여 특정 위치에 관련된 결과를 반환할 수도 있습니다. Places API는 장소 ID를 확정된 위치로 Geocoding API 웹 서비스에 반환한 후 해당 서비스에서 전체 주소 세부정보를 반환하고 주소를 latlng로 지오코딩합니다. Directions API, Distance Matrix API (아래 참조)와 같은 다른 API에도 장소 ID를 전달할 수 있습니다.
Geocoding API의 주소 지오코딩은 지연 시간이 훨씬 길고 불완전하거나 모호한 쿼리의 결과가 정확하지도 않으므로 사용자 입력에 실시간으로 응답해야 하는 애플리케이션에는 권장되지 않습니다.
Android, iOS, 자바스크립트, Places API의 Place Autocomplete 서비스에 대해 자세히 알아보세요.
자동 시스템
완전하고 명확한 우편 주소를 처리하는 자동 시스템: 전체 주소 주소 문자열과 같은 명확한 쿼리 (예: '48 Pirrama Rd, Pyrmont, NSW, Australia')는 Geocoding API 웹 서비스에서 처리하는 것이 가장 좋습니다. 주소 지오코딩 백엔드는 전 세계 주소를 더 많이 포괄하며, 이러한 유형의 전체 쿼리를 통해 고품질 결과에 최적화되어 있습니다.
자동화된 시스템 처리 모호한 쿼리: 모호한 쿼리는 형식이 잘못 지정된 주소, 불완전한 주소 또는 맞춤법 실수가 포함된 쿼리입니다. 자동화 시스템의 경우 Geocoding API 웹 서비스를 사용하는 것이 좋습니다. 그러나 Geocoding API는 모호한 쿼리를 처리하도록 설계되지 않았으며 모호한 쿼리에 대한 응답으로 정확도가 떨어지거나 결과가 없을 수 있습니다. 자동화 시스템이 사용자 입력에서 파생된 모호한 쿼리를 처리하는 경우, Places API의 Place Autocomplete 서비스를 사용하여 앱에 대화형 요소를 추가하는 것이 좋습니다. 이러한 옵션은 가능한 여러 옵션을 반환하고 사용자가 선택할 수 있도록 하기 때문입니다. Places API는 장소 ID를 완전히 명확한 위치로 전달할 수 있는 Geocoding API 웹 서비스에 반환하며, 그러면 이 서비스에서 전체 주소 세부정보를 반환하고 주소를 latlng로 지오코딩합니다. Android, iOS, 자바스크립트, Places API의 Place Autocomplete 서비스에 대해 자세히 알아보세요.
Directions API 및 Distance Matrix API의 지연 시간 감소
출발지, 목적지 또는 경유지가 주소 문자열로 지정되면 Directions API와 Distance Matrix API는 Geocoding API와 동일한 백엔드를 사용하여 주소를 계산하기 전에 이러한 주소를 지오코딩합니다. 이렇게 하면 latlng 또는 place ID와 같은 위치를 지정할 때보다 지연 시간이 크게 늘어납니다.
애플리케이션에서 사용자 입력에 대한 응답과 같이 지연 시간에 민감한 상황에서 Directions API 또는 Distance Matrix API를 사용하여 출발지, 목적지 또는 경유지를 처음에 주소 문자열로 지정하는 경우 Places API의 Place Autocomplete 서비스를 사용하여 주소 문자열을 장소 ID로 변환한 다음 장소 ID를 Directions API 또는 Distance Matrix API에 전달하는 것이 좋습니다. Android, iOS, 자바스크립트, Places API의 Place Autocomplete 서비스에 대해 자세히 알아보세요. 장소 자동 완성 및 길찾기의 자바스크립트 예도 참조하세요.
결론
주소를 지오코딩할 때 사용 사례에 따라 Geocoding API를 사용하거나 Place Autocomplete 서비스를 Geocoding API와 함께 사용하면 사용자에게 정확한 지오코딩 결과를 제공하고 지연 시간을 줄일 수 있는 애플리케이션을 만들 수 있습니다.
오류 및 재시도 관리
UNKNOWN_ERROR 응답을 수신하는 경우 일시적인 오류로 인해 발생하며 짧은 지연 후에 다시 시도하는 것이 가장 좋습니다. 재시도 로직을 포함하고 Google Maps Platform 프리미엄 플랜 인증을 지원하는 Google Maps Platform 웹 서비스 클라이언트 라이브러리를 사용하는 것이 좋습니다.
Google 지도 서비스의 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 커뮤니티 지원 클라이언트 라이브러리로 GitHub에서 다운로드와 참여가 가능합니다. 이 라이브러리에서 설치 안내와 샘플 코드도 찾을 수 있습니다.
OVER_QUERY_LIMIT 상태 코드가 응답으로 표시되면 API의 사용 한도를 초과한 것입니다. 이 사용 최적화 전략을 시도해 보시기 바랍니다.