지오코딩 FAQ

이 FAQ에서는 Geocoding API에 관한 질문을 다룹니다. 모든 Google Maps Platform에 공통된 질문은 Google Maps Platform FAQ를 참고하세요. 주소 지오코딩 시 권장사항도 참고하세요.

문제 해결

문제 해결

지오코더에서 ZERO_RESULTS를 반환하는 쿼리가 더 많아지고 있습니다. 어떻게 된 건가요?

지오코더에서는 모호하고 불완전하거나 형식이 잘못된 쿼리(예: 맞춤법이 틀렸거나 존재하지 않는 주소)가 ZERO_RESULTS를 생성할 수 있습니다. 주소를 찾을 수 없으면 부분 결과보다 ZERO_RESULTS가 더 좋습니다 (예: 주소 대신 교외만 반환).

애플리케이션에서 사용자가 입력한 주소를 처리하는 경우 Places API의 Place Autocomplete 기능을 사용하면 더 나은 품질의 결과가 생성될 수 있습니다. Place Autocomplete을 사용하면 사용자가 입력한 내용에 따라 검색결과 집합에서 선택할 수 있으므로 비슷한 이름의 검색결과 중에서 선택하고 주소의 철자가 틀린 경우 쿼리를 조정할 수 있습니다.

애플리케이션에서 모호하거나 불완전한 쿼리 또는 오류가 포함된 쿼리를 처리하는 경우 Geocoding API에서 사용할 수 있는 정방향 지오코더 대신 Places API의 Place Autocomplete 기능을 사용하는 것이 좋습니다. 자세한 내용은 주소 지오코딩 시 권장사항 및 Google 지도 API의 주소 지오코딩 블로그 게시물을 참고하세요.

저는 빠른 응답이 필요한데 지오코더가 제 애플리케이션에서 너무 느립니다. 더 빠른 응답을 위해 무엇을 사용할 수 있나요?

사용자 입력에 반응하여 지연 시간에 매우 민감한 애플리케이션은 주소 지오코딩 대신 Places API의 Place Autocomplete 기능 (JavaScript, Android 또는 iOS에서도 사용 가능)을 사용하는 것이 좋습니다. 장소 자동완성은 대화형 방식으로 사용이 최적화되기 때문에, 지연 시간이 매우 짧습니다.

Geocoding API의 주소 지오코딩은 완전하고 분명하며 형식이 올바른 주소(예: 온라인 양식에 입력된 배송지 주소)에 사용하도록 최적화되어 있으므로 Place Autocomplete보다 지연 시간이 깁니다. 정방향 지오코더는 적용 범위가 더 넓고 결과 품질이 우수하지만 지연 시간이 다소 더 깁니다.

Directions API 및 Distance Matrix API의 지연 시간을 완화하려면 어떻게 해야 하나요?

주소 대신 장소 ID를 사용하여 경유지, 출발지, 목적지를 지정하세요. 장소 ID는 Places API의 Place Autocomplete 기능 또는 Maps JavaScript API의 장소 라이브러리에서 가져오는 것이 가장 좋습니다. Place Autocomplete 비용을 줄이는 데 사용할 수 있는 placeIdOnly 옵션에 관한 정보도 참고하세요.

Directions API 또는 Distance Matrix API를 장소 ID 또는 latlng 대신 주소 문자열로 쿼리하는 경우 경로를 계산하기 전에 Geocoding API와 동일한 백엔드를 사용하여 해당 주소를 장소 ID로 변환합니다. Place Autocomplete은 주소 지오코딩보다 빠릅니다. 사용자 입력에 응답과 같이 지연 시간에 매우 민감한 상황에서 Directions API 또는 Distance Matrix API를 사용하는 애플리케이션의 경우 Place Autocomplete을 사용하여 해당 주소에 해당하는 장소 ID를 가져오고 Directions API 또는 Distance Matrix API에 장소 ID를 전달하는 것이 좋습니다. 이 접근 방식은 지연 시간을 크게 줄여줍니다. 경로와 함께 Place Autocomplete를 사용하는 방법의 예는 문서를 참고하세요.

지오코더에서 버그를 신고하려면 어떻게 해야 하나요?

정방향 지오코더 서비스에 대한 버그 신고 또는 기능 요청이 있는 경우 공개 Issue Tracker를 사용하여 알려주시기 바랍니다.

지오코더가 생성하는 결과가 제 사용 사례에 적합치 않습니다. 어떤 도움을 받을 수 있나요?

공개 Issue Tracker를 통해 몇 가지 구체적인 쿼리를 공유해 주시면 조사하여 결과 품질 문제를 일으키는 버그나 시스템 문제가 있는지, 또는 개발자가 더 나은 결과를 얻을 수 있도록 권장사항 가이드를 변경해 드릴 수 있습니다.

구성 요소 필터링을 사용하여 지오코더에서 최상의 결과를 얻으려면 어떻게 해야 하나요?

지오코더에서 구성요소 필터링은 postal_code 및 country 제한사항만 적용합니다. 다음 예에서는 필요한 결과에 따라 구성요소 필터링을 가장 잘 사용하는 방법을 보여줍니다. 샘플 요청 URL에서 ‘YOUR_API_KEY’를 실제 API 키로 대체해야 합니다.

  • 우편번호를 특정 국가로 제한하려면 ISO 3166-2 국가 코드를 사용하여 국가 제한을 지정해야 합니다. 예를 들어 components=country:CH|postal_code:8000은 '8000 Zürich, Swiss'를 반환합니다. 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • 쿼리를 특정 국가로 제한하려면 ISO 3166-2 국가 코드를 사용하여 국가 제한을 지정해야 합니다. 국가 이름 및 기타 약어를 사용해도 국가 코드와 동일한 결과가 생성되지 않을 수 있습니다.

    예:

    • components=country:FRA|locality:gallus의 지오코딩은 독일 프랑크푸르트암마인에 있는 갈루스의 하위 지역을 반환합니다. 이는 프랑스의 3자리 국가 코드 (FRA)가 지원되지 않아 모든 국가의 결과가 허용되고 결과가 프랑스보다 프랑크푸르트에 더 적합하기 때문입니다. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • 모호한 쿼리에 대해 Geocoding API가 반드시 여러 개의 결과를 반환하지는 않습니다. 이러한 쿼리는 Place Autocomplete에서 더 잘 답변됩니다.

    예:

    • components=country:US|locality:madrid의 지오코딩은 'Madrid, NM 87010, USA'를 반환하지만 미국 내 'Madrid'라는 다른 도시는 반환하지 않습니다. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • input=madrid&components=country:us&types=(regions)에 Place Autocomplete를 사용하고 location 및 radius를 사용하여 표시 영역을 지정하여 위치 결과를 편중하면 미국 내 '마드리드'라는 이름의 여러 도시가 포함된 응답이 생성됩니다. 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY