지오코딩 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 Maps API의 주소 지오코딩 블로그 게시물을 참고하세요.

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

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

Geocoding API의 주소 지오코딩은 온라인 양식에 입력한 배송 주소와 같이 완전하고 명확하며 형식이 올바른 주소와 함께 사용하도록 최적화되어 있으므로 Place Autocomplete보다 지연 시간이 더 깁니다. 정방향 지오코더는 범위와 결과 품질이 더 높지만 지연 시간이 약간 더 깁니다.

Directions API와 Distance Matrix API의 지연 시간을 줄이려면 어떻게 해야 하나요?

주소 대신 장소 ID를 사용하여 경유지, 출발지, 목적지를 지정합니다. 장소 ID는 Places API의 장소 자동 완성 기능 또는 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를 사용하여 알려주세요. 그러면 Google에서 결과 품질에 문제를 일으키는 버그나 시스템 문제가 있는지 확인하거나 개발자가 더 나은 결과를 얻도록 돕는 권장사항 가이드를 변경할 수 있습니다.

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

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

  • 우편번호를 특정 국가로 제한하려면 ISO 3166-2 국가 코드를 사용하여 국가 제한을 지정해야 합니다. 예를 들어 components=country:CH|postal_code:8000는 "8000 Zürich, Switzerland'를 반환합니다. 
    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의 지오코딩은 '마드리드, NM 87010, 미국'을 반환하지만 '마드리드'라는 미국 내 다른 도시는 반환되지 않습니다. 
      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를 사용하여 위치 결과가 편향되도록 표시 영역을 지정하면 미국 내 여러 도시인 'Madrid"와 함께 응답이 생성됩니다. 
      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