지오코딩 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 또는 위도/경도가 아닌 주소 문자열로 쿼리되면 Geocoding API와 동일한 백엔드를 사용하여 해당 주소를 장소 ID로 변환한 후 경로를 계산합니다. Place Autocomplete은 주소 지오코딩보다 빠릅니다. 사용자 입력에 응답하는 등 지연 시간에 매우 민감한 상황에서 Directions API (기존) 또는 Distance Matrix API (기존)를 사용하는 애플리케이션의 경우 Place Autocomplete를 사용하여 해당 주소에 해당하는 장소 ID를 가져오고 장소 ID를 Directions API (기존) 또는 Distance Matrix API (기존)에 전달하는 것이 좋습니다. 이 접근 방식은 지연 시간을 크게 줄여줍니다. 경로와 함께 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, 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의 지오코딩은 '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