모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Geocoding API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Geocoding API 활성화
  3. 적합한 키 생성
계속

주소 지오코딩 시의 모범 사례

지오코딩은 주소(예: 거리 주소)를 지리 좌표(위도 및 경도)로 변환하는 프로세스이며, 이 프로세스를 사용하여 마커를 지도에 넣거나 지도를 배치할 수 있습니다. 이 문서에서는 주소 지오코딩 시에 고려할 사항을 명확히 설명합니다. 이 문서에서는 Google Maps Geocoding API를 사용할 최적의 시기와 Places API 장소 자동완성 서비스 또는 Places API 텍스트 검색 서비스를 사용할 때의 이점에 대해 설명합니다.

일반적으로, Google Maps Geocoding API는 완전한 주소(예: “48 Pirrama Rd, Pyrmont, NSW, Australia”)를 지오코딩할 때 사용됩니다. 모호한(불완전한) 주소를 지오코딩할 때나 지연 시간이 긴 경우(예: 사용자 입력에 응답하는 경우) Places API 장소 자동완성 서비스를 사용하세요. 자동 시스템(자동완성 제안으로부터 항목을 선택할 사용자가 없는 시스템)에서 모호한 주소를 지오코딩할 때는 장소 자동완성 대신 Places API 텍스트 검색 서비스를 사용하세요.

사용 사례 및 API 권장 사항

사용 사례 API 권장 사항
명확한 전체 우편 주소 Google Maps Geocoding API 웹 서비스
사용자가 입력한 모호한 쿼리 (예: 불완전하거나 형식이 잘못된 주소) Places API 장소 자동완성 서비스를 사용하여 장소 ID를 구한 다음, Geocoding API를 사용하여 장소 ID를 latlng로 지오코딩합니다.
자동 시스템의 모호한 쿼리 (예: 불완전하거나 형식이 잘못된 주소) Places API 텍스트 검색 서비스를 사용하여 장소 ID를 구한 다음, Geocoding API를 사용하여 장소 ID를 latlngs로 지오코딩합니다.
사용자 입력에 실시간 응답 Places API 장소 자동완성 서비스를 사용하여 장소 ID를 구한 다음, Geocoding API를 사용하여 장소 ID를 latlng로 지오코딩합니다.
주소 문자열로 지정된 출발지, 목적지 또는 경유지로 Google Maps Directions API 또는 Distance Matrix API 사용 시 지연 시간 문제 Places API 장소 자동완성 서비스를 사용하여 지오코딩 지연 시간을 줄여 장소 ID를 구한 다음, 장소 ID를 Directions API 또는 Distance Matrix API로 전달합니다.

완전한 주소

완전한 우편 주소 문자열(예: “48 Pirrama Rd, Pyrmont, NSW, Australia”)과 같은 명확한 쿼리는 Geocoding API 웹 서비스에 의해 최적으로 처리됩니다. 주소 지오코딩 백엔드는 더 넓은 주소 범위를 전역적으로 제공하며, 이러한 유형의 명확하고 완전한 쿼리에 대해 최적의 결과를 제공합니다.

모호한 쿼리

모호한 쿼리는 형식이 잘못된 주소, 불완전한 주소 또는 불필요한 주소 부분이 포함된 쿼리입니다. Geocoding API 웹 서비스 지오코더는 모호한 쿼리를 처리하기에는 적절치 않으며, 모호한 쿼리(특히 맞춤법 오류나 비표준 용어가 포함된 쿼리의 경우)에 대해서는 결과가 부정확하거나 전혀 검색되지 않을 수 있습니다.

사용자가 모호한 쿼리(예: “123 Main Street”)를 입력하는 경우 Places API의 장소 자동완성 서비스를 사용하는 것이 좋습니다. 이 서비스는 가능한 여러 옵션을 반환하므로 사용자가 그 중에서 선택할 수 있습니다. 사업체를 제외한 채 지오코드나 주소만을 검색하도록 Places API를 제한할 수 있습니다. 또한 특정 위치에 관련된 결과를 반환하도록 자동완성 조회 기능을 편중할 수 있습니다. Places API는 명확한 위치로서 Geocoding API 웹 서비스에 전달할 수 있는 장소 ID를 반환합니다. 그러면 이 웹 서비스가 전체 주소 세부정보를 반환하고 주소를 latlng로 지오코딩합니다. Android, iOS, JavaScript Places API Web Service용 장소 자동완성 서비스에 대해 자세히 알아보세요.

자동화된 시스템(사용자가 가능한 여러 결과 중에서 선택할 수 없는 시스템)에서 주소 지오코딩을 사용해야 하지만 쿼리가 모호하거나 불완전할 수 있는 경우, 장소 자동완성 서비스 대신 Places API 텍스트 검색 서비스를 사용할 수 있습니다. 모호한 쿼리를 처리할 경우에는 장소 검색이 Geocoding API보다 더 뛰어납니다. 장소 검색은 검색 결과를 특정 지역으로 제한하거나 거리별로 순위를 지정할 수 있으며, 모호하거나 불완전한 쿼리 결과에 대해 더욱 정밀한 필터링과 순위 지정이 가능합니다.

사용자 입력에 응답

사용자 입력에 실시간으로 응답하는 애플리케이션의 경우, API 선택에 영향을 미치는 두 가지 고려사항이 있습니다.

  1. 일반적으로 사용자 입력 시에는 주소가 점진적으로 입력되므로 , 불완전하고 모호한 주소를 지오코딩할 수 있다면 사용자가 더 빠르게 결과를 얻을 수 있는 이점이 있습니다.
  2. 사용자 입력에 응답하는 애플리케이션은 지연 시간에 매우 민감합니다.

이러한 두 가지 고려사항 때문에 Places API 장소 자동완성 서비스는 사용자 입력에 응답하는 경우에 이상적인 서비스입니다. Geocoding API에서의 주소 지오코딩은 지연 시간이 훨씬 더 길며 또한 불완전하거나 모호한 쿼리의 경우 그 결과가 부정확하므로, 사용자 입력에 실시간으로 응답해야 하는 애플리케이션에는 적합하지 않습니다. Android, iOS, JavaScript Places API Web Service용 장소 자동완성 서비스에 대해 자세히 알아보세요.

Directions API 및 Distance Matrix API에서 지연 시간 감소

출발지, 목적지 또는 경유지가 주소 문자열로서 지정된 경우 Google Maps Directions API Distance Matrix API는 Geocoding API와 동일한 백엔드를 사용하여 주소를 지오코딩한 다음, 찾아가는 길을 계산합니다. 이 경우 latlng 또는 장소 ID와 동일한 위치를 지정할 때보다 지연 시간이 상당히 늘어납니다.

지연 시간에 민감한 상황(예: 사용자 입력에 응답)에서 애플리케이션이 Directions API 또는 Distance Matrix API를 사용하고 또한 출발지, 목적지 또는 경유지가 주소 문자열로 지정된 경우에는, Places API 장소 자동완성 서비스를 사용하여 주소 문자열을 장소 ID로 변환한 다음, 이 장소 ID를 Directions API 또는 Distance Matrix API로 전달하여 지연 시간을 최소화하는 것이 좋습니다. Android, iOS, JavaScript Places API Web Service용 장소 자동완성 서비스에 대해 자세히 알아보세요. 또한 장소 자동완성 및 길찾기의 JavaScript 예시를 참조하세요.

결론

주소를 지오코딩할 때 사용 사례에 따라 Geocoding API 또는 Places API를 사용하거나 장소 자동완성 서비스 또는 장소 검색 서비스를 Geocoding API와 조합으로 사용하면, 사용자에게 정확한 지오코딩 결과와 단축된 지연 시간을 제공하는 애플리케이션을 만들 수 있습니다.

오류 및 재시도 관리

UNKNOWN_ERROR 응답을 수신하는 경우, 그 원인은 일시적인 오류이며 잠시 후에 재시도하는 것이 최선의 방법입니다. Google Maps APIs 웹 서비스 클라이언트 라이브러리를 사용하도록 권장합니다. 이 라이브러리는 재시도 로직을 포함하며 Google Maps API 프리미엄 플랜 인증을 지원합니다. Google Maps Services용 Java Client, Python Client, Go ClientNode.js Client는 커뮤니티 지원 클라이언트 라이브러리로, GitHub에서 다운로드와 참여가 가능하며 설치 지침과 샘플 코드도 찾을 수 있습니다.

OVER_QUERY_LIMIT 상태 코드가 응답으로 나타나는 경우, API의 사용 제한을 초과한 것입니다. 사용 최적화 전략을 시도해 보세요.

다음에 대한 의견 보내기...

Google Maps Geocoding API
Google Maps Geocoding API
도움이 필요하시나요? 지원 페이지를 방문하세요.