지오코딩 FAQ

이 FAQ에는 Geocoding API와 관련된 질문이 포함되어 있습니다. 궁금한 점이 있으면 Google Maps Platform FAQ를 참고하세요. 공통으로 사용됩니다. 참고 항목 주소 지오코딩 시 권장사항

문제 해결

문제 해결

지오코더에서 더 많은 쿼리가 ZERO_RESULTS를 반환합니다. 어떻게 된 건가요?

지오코더에서 모호하고 불완전하며 형식이 잘못된 쿼리(예: 철자가 잘못되었거나 존재하지 않는 주소는 ZERO_RESULTS가 발생할 가능성이 큽니다. 주소를 찾을 수 없는 경우에는 부분 주소보다 ZERO_RESULTS를 사용하는 것이 좋습니다. 결과 (예: 주소 대신 교외 지역만 반환)를 반환합니다.

애플리케이션이 주소의 사용자 입력을 처리하는 경우, Place Autocomplete 기능 를 사용하면 더 나은 품질 결과를 얻을 수 있습니다. 사용자는 Place Autocomplete을 통해 사용자가 입력한 내용을 기반으로 사용자는 비슷한 이름의 검색결과 중에서 선택할 수 있고 주소를 잘못 입력한 경우 검색어를 조정할 수 있습니다.

모호하거나 불완전한 쿼리 또는 쿼리를 처리하는 애플리케이션이 있는 경우 오류가 있을 수 있는 경우 Place Autocomplete 기능 정방향 지오코더가 아닌 Places API에서 Geocoding API에서 사용할 수 있습니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 주소 지오코딩 시 권장사항 및 <ph type="x-smartling-placeholder"></ph> Google Maps API 블로그 게시물의 주소 지오코딩

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

사용자 입력에 반응하는 애플리케이션이므로 지연 시간에 민감한 경우 Place Autocomplete 사용 Places API의 기능( JavaScript, Android 또는 iOS)에서 사용할 수 있습니다. 장소 자동완성은 대화형 방식으로 사용이 최적화되기 때문에, 지연 시간이 매우 짧습니다.

Geocoding API의 주소 지오코딩은 완전하고 분명하며 형식이 올바른 주소(예: 온라인 양식이므로 Place Autocomplete보다 지연 시간이 깁니다. 정방향 지오코더 커버리지가 더 넓고 결과 품질이 더 우수하지만 지연 시간이 다소 깁니다.

Directions API에서 지연 시간을 줄이고 Distance Matrix API?

주소 대신 장소 ID를 사용하여 다음을 수행합니다. 경유지, 출발지 및 목적지를 지정합니다. 장소 ID는 Place Autocomplete 기능을 사용하거나 장소 라이브러리는 Maps JavaScript API를 사용할 수 있습니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> placeIdOnly 옵션을 사용할 수 있습니다. 이 옵션을 사용하면 Place Autocomplete

Directions API 또는 Distance Matrix API 가 장소 ID 또는 latlng 대신 주소 문자열로 쿼리되는 경우 백엔드를 사용하여 해당 주소를 장소 ID를 반환합니다. Place Autocomplete이 주소보다 빠름 사용됩니다. Directions API 또는 다음과 같이 지연 시간에 매우 민감한 상황에서의 Distance Matrix API 응답하려면 Place Autocomplete을 사용하여 장소 ID를 가져오는 것이 좋습니다. 이를 사용하고 장소 ID를 Directions API 또는 Distance Matrix API. 이 접근 방식은 지연 시간을 크게 줄여줍니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> Place Autocomplete을 경로에 사용하는 방법의 예

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

혹시 <ph type="x-smartling-placeholder"></ph> 버그 신고 또는 <ph type="x-smartling-placeholder"></ph> 기능 요청이 있으면 공개 지오코더 서비스를 사용해 Issue Tracker를 사용합니다.

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

공개 <ph type="x-smartling-placeholder"></ph> Issue Tracker를 사용하여 몇 가지 특정 문의를 공유하여 문제를 조사합니다. 결과에 문제를 일으키는 버그나 시스템 문제가 있는지 확인 또는 동영상 품질을 변경할 수 있는지 권장사항 가이드 개발자가 더 나은 결과를 얻을 수 있도록 지원합니다

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

지오코더에서 구성요소 필터링은 postal_code 및 country 제한. 다음 예는 구성요소를 사용하는 가장 좋은 방법을 보여줍니다. 필요한 결과에 따라 다른 필터를 설정할 수 있습니다. 샘플 요청 URL에서 'YOUR_API_KEY'를 실제 API 키로 바꾸세요.

  • 우편번호를 특정 국가로 제한하려면 국가 제한을 지정해야 합니다. ISO 3166-2 국가 코드를 사용합니다. 예를 들면 다음과 같습니다. components=country:CH|postal_code:8000는 '8000 취리히, 스위스'를 반환합니다. 
    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 반환의 지오코딩 독일 프랑크푸르트암마인 갈루스 하위 지구입니다. 이는 세 글자로 된 프랑스 (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" 미국 내 다른 도시 중에 '마드리드'라는 도시는 없습니다. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • 다음에 대해 Place Autocomplete 사용 input=madrid&components=country:us&types=(regions) 및 다음 지정 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