FAQ

시작하기

서비스 약관 이해

사용 제한 및 결제

Google Maps APIs 사용

Google Maps APIs 서비스

Google Maps SDK for iOS

시작하기

Google Maps APIs란 무엇인가요?

Google Maps APIs는 Google 지도를 웹 페이지에 포함하거나 Google 지도에서 데이터를 검색할 수 있는 여러 가지 방법을 개발자에게 제공하며, 단순한 사용이나 광범위한 사용자 지정을 모두 허용합니다. 다음과 같은 몇 가지 API가 제공됩니다.

Web API:

Web Service API:

모바일 API:

필요에 따라 이러한 API를 하나만 사용하거나 조합하여 사용할 수 있습니다.

기업 또는 상업용 웹사이트를 운영하고 있는 경우에는, Google Maps API 프리미엄 플랜도 관심을 가지실 수 있습니다.

어떤 API가 필요한가요?

본인의 기능적 요구사항에 맞는 올바른 API를 찾으려면, API 선택기를 둘러보세요.

Google Maps APIs에는 어떤 국가가 포함되나요?

Google 지도 팀은 새로운 지도 데이터를 끊임없이 내놓고 있으며 전세계적인 커버리지를 늘려가고 있습니다. 최신 커버리지 정보에 대해서는 Google 지도 커버리지 데이터를 참조하세요. 페이지 상단의 필터 상자로 데이터를 필터링할 수 있습니다. 참고로, 데이터 공급자와의 라이선스 계약이 변경되면 커버리지 데이터가 변경될 수 있습니다.

참고 항목:

Google Maps APIs를 사용하지 않고 제 사이트에 Google 지도를 넣을 수 있나요?

예. 이제 Google 지도는 프로그래밍이나 Google Maps APIs를 사용하지 않고도, 보고 있는 지도를 자신의 웹사이트나 블로그에 포함할 수 있는 기능을 제공합니다. 자세한 내용은 여기에서 찾을 수 있습니다.

모바일 기기에서 지도 애플리케이션을 제공하려면 어떻게 하나요?

지도를 Android 애플리케이션에 통합하려면 Google Maps Android API를 사용하세요.

지도를 네이티브 iOS 애플리케이션에 통합하려면 Google Maps SDK for iOS를 사용하세요.

Google Maps JavaScript API는 모바일 기기에 맞게 개발되었으며, 완벽한 JavaScript 구현의 웹 브라우저가 포함된 기기(예: Apple iPhone)와 데스크톱을 대상으로 하는 브라우저 애플리케이션에 적합합니다.

JavaScript API를 사용하기에 부적합한 기기를 대상으로 하는 애플리케이션의 경우, Google Static Maps API는 마커와 폴리라인이 포함된 GIF, JPG 및 PNG 형식의 지도 이미지를 제공합니다. 참고로, 브라우저 기반의 애플리케이션을 벗어나서 Google Static Maps API를 사용할 경우, 지도 이미지를 Google 지도에 링크해야 합니다.

JavaScript API에서 지도를 인쇄할 수 있나요?

JavaScript API에서 지도 인쇄는 지원되지 않습니다. 그 이유는 흔히 사용되는 브라우저상에서 인쇄 지원이 일관되지 않기 때문입니다. 인쇄 용도에는 Static Maps API를 사용하는 것이 좋습니다.

제 사이트에서 Google Maps APIs 사용을 시작하려면 어떻게 하나요?

예시와 자세한 내용은 Maps Javascript API 문서를 참조하세요.

Google Maps APIs에 변경이 있는 경우 어떻게 알림을 받나요?

다양한 Google Geo 개발자 제품에 대한 뉴스 업데이트를 받으려면, Google Geo Developers Blog를 구독해야 합니다.

서비스 약관 이해

Google Maps APIs의 서비스 약관이란 무엇인가요?

Google Maps APIs의 서비스 약관은 다음 사이트에서 확인할 수 있습니다.

https://developers.google.com/maps/terms

Google Maps API 프리미엄 플랜 고객인 경우, Google Maps APIs의 사용에 대해 기술된 약관의 계약 내용을 참조하세요.

Google Maps APIs의 서비스 약관을 제 사이트가 충족하나요?

고객이 무료로 액세스가 가능한 모든 사이트에서 Maps API를 사용할 수 있습니다. 귀하의 사이트가 서비스 약관을 충족시키는 한, Google Maps APIs를 상업용 및 비영리 웹사이트에서 모두 사용할 수 있습니다.

그러나, 저희가 바라지 않는 Google Maps APIs의 용도가 몇 가지 있습니다(예: 도시에서 불법 약물의 구매 장소를 찾거나 기타 불법 행위를 위해 지도를 사용하는 경우). 저희는 또한 사람들의 개인정보를 존중하므로, 개인의 개인정보를 식별하는 데 Google Maps APIs를 사용해서는 안됩니다.

애플리케이션을 개발하여 출시하기 전에 애플리케이션이 서비스 약관을 준수하는지 여부를 본인 스스로 판단해야 합니다. Google 엔지니어는 기술 지원만을 제공하며 법률적 조언을 제공할 자격이 없습니다. Google은 언제든지 서비스 사용을 보류하거나 종료할 권리를 보유하므로, 서비스 약관을 자세히 읽어보세요.

기업 또는 상업용 웹사이트를 운영하고 있는 경우에는, Google Maps API 프리미엄 플랜도 관심을 가지실 수 있습니다. 이 제품은 귀하의 요구사항에 더욱 적합하도록 서비스 약관을 수정했습니다.

지도와 위성 이미지에 직접 액세스할 수 있나요?

Google Maps APIs를 제외한 다른 메커니즘(예: 자체 매핑 API를 생성하거나 벌크 타일 다운로드 스크립트를 사용하는 경우)을 통해서는 지도 또는 위성 이미지에 액세스하지 못할 수 있습니다. Google Maps APIs를 벗어나서 액세스하는 경우에는 애플리케이션의 타일 액세스가 차단됩니다. 자세한 내용은 Google 지도 서비스 약관의 섹션 10.1.a를 참조하세요.

상업용 웹사이트에서 Google Maps APIs를 사용할 수 있나요?

고객이 여러분 사이트에 무료로 액세스할 수 있는 한은, 여러분이 Google Maps APIs를 사용할 수 있습니다. 예를 들어, 여러분의 웹사이트가 광고의 지원을 받는다면 아마도 이 웹사이트는 Google Maps APIs 서비스 약관에 포함될 것입니다. 정보를 지도에 표시하기 위해 사람들에게 비용을 청구하는 경우(예: 주택 매매 정보 표시), Google Maps APIs를 사용하여 이 정보를 사이트의 무료 부분에 표시한다면, 이 또한 Google Maps APIs 서비스 약관을 충족하는 것입니다.

그러나 모든 상업적 용도가 허용되는 것은 아닙니다. 예를 들어, 귀하의 사이트가 다음 기준을 충족하는 경우에는 적절한 Google Maps API 프리미엄 플랜 라이선스를 구입해야 합니다.

  • 유료 고객만 사이트를 이용할 수 있는 경우.
  • 귀하의 회사 또는 인트라넷 내에서만 사이트에 액세스할 수 있는 경우.
  • 기업 발송, 차량 관리, 비즈니스 자산 추적 또는 이와 유사한 애플리케이션과 관련된 경우.

Google은 언제든지 Google Maps APIs 사용을 보류하거나 종료할 권리를 보유한다는 점을 명심하고, 서비스 약관을 자세히 읽어보세요.

추적 애플리케이션에 Google Maps APIs를 사용할 수 있나요?

애플리케이션을 공공이 무료로 이용할 수 있고 서비스 약관을 준수한다면, Google Maps APIs로 실시간 데이터를 표시(추적)하는 데 제한이 없습니다. 내부 전용 애플리케이션의 경우, Google Maps API 프리미엄 플랜를 사용해야 합니다. 자세한 내용은 서비스 약관의 섹션 10.4를 참조하세요.

웹용이 아닌 애플리케이션에서 Google Maps API를 사용할 수 있나요?

네, 서비스 약관의 기타 제한을 준수하기만 한다면, 이제 Google Maps APIs를 데스크톱 애플리케이션에서 사용할 수 있습니다. 참고로, 데스크톱 애플리케이션이 "공공 액세스 가능"으로 간주되려면, 애플리케이션을 다운로드할 수 있는 공공 액세스 가능 웹 페이지가 있어야 합니다. 자세한 내용은 서비스 약관의 섹션 9.1을 참조하세요.

Google Maps JavaScript API는 지원되는 브라우저 중 하나에서 실행될 때만 지원됩니다.

암호로 보호된 사이트에서 Google Maps APIs를 사용할 수 있나요?

네, 사용할 수 있습니다. 하지만 암호로 보호된 웹사이트에서 Google Maps APIs를 사용하기 전에 서비스 약관을 참조해야 합니다. 소비자가 무료로 쉽게 암호를 신청할 수 있거나 암호로 보호된 지도의 목적이 행정 등 공공 이용 지도를 개선하는 것이라면, 아마도 귀하의 사이트는 서비스 약관 내에 해당할 것입니다. 이 경우가 아니라면 Google Maps API 프리미엄 플랜를 사용해야 합니다.

Google Maps APIs 애플리케이션의 스크린샷을 인쇄 자료 또는 오프라인 미디어에서 사용할 수 있나요?

Google 지도 이미지를 인쇄 자료 및 오프라인 미디어에서 사용할 경우, 다음 주소에 게시된 권한 가이드라인의 적용을 받습니다:

http://www.google.com/permissions/geoguidelines.html

인쇄에 대한 자세한 내용은 JavaScript API에서 지도를 인쇄할 수 있나요?를 참조하세요.

제 콘텐츠가 Google 검색 결과에 포함되지 않도록 선택하려면 어떻게 하나요?

저희는 이 데이터를 더 이상 수집하지 않습니다. indexing 매개변수는 지원이 중단되었으며 영향이 없습니다. 더 이상 명시적으로 거부를 선택할 필요가 없으며, 편리한 시간에 이 매개변수를 빨리 제거하는 것이 좋습니다.

검색 결과에서 자신의 페이지나 사이트를 제거하려면, 웹마스터 도움말 센터에서 제공하는 지침을 따르세요.

Google Maps API 프리미엄 플랜 라이선스에서 클라이언트 ID를 사용 중인 경우, 다음 옵션은 지도에 표시된 Google 로고에서 링크를 제거할 수 있습니다. 로고 링크가 사용자 환경에 악영향을 미치는 경우로만 이 옵션의 사용을 제한해야 합니다. (예를 들어, 모바일 앱이 전체 화면 뷰에 있을 때 이 로고를 클릭하면 사용자가 원래 앱 콘텐츠를 벗어나게 되며 돌아올 방법이 없습니다.) 로고와 저작권 알림은 숨겨지거나 가려지지 않도록 해야 합니다.

map.setOptions({passiveLogo: true});

로고는 보이지만 클릭은 할 수 없습니다.

이 옵션은 클라이언트 ID를 사용하는 모든 프리미엄 플랜 고객이 기본적으로 사용할 수 있습니다. 이 옵션이 작동하지 않을 경우 프리미엄 플랜 지원에 문의하세요.

Maps JavaScript API를 사용할 때 어떤 정보가 Google로 전송되나요?

Maps JavaScript API를 사용 중인 경우, 다음과 같은 정보가 Google로 전송됩니다.

  • 지도 타일과 저작권을 검색하기 위한 지도 크기 및 위치
  • 지오코딩을 위한 주소
  • 길찾기 및 고도 요청
  • 주변의 장소를 검색하려는 위치
  • KmlLayer 사용 시 KML
제 웹사이트에 저장하여 서비스 중인 Google Static Maps API를 사용하여 지도 이미지를 생성할 수 있나요?

귀하의 웹사이트에서 Google Static Maps API를 사용하여 생성된 이미지의 복사본을 저장하고 서비스하지 못할 수 있습니다. 정적 이미지가 필요한 모든 웹 페이지는 HTML img 태그의 src 특성이나 HTML div 태그의 CSS background-image 특성을 Google Static Maps API에 직접 연결해야 하므로, 모든 지도 이미지는 웹 페이지의 HTML 콘텐츠 내에 표시되며, Google에 의해 최종 사용자에게 직접 서비스됩니다.

사용 제한 및 결제

어떤 Google Maps APIs에 사용 제한이 있나요?

Google Maps APIs는 표준 API 사용 시 무료 사용 제한 및 예측 가능한 초과분 가격 책정을 통해 그리고 기업 배포 시 연간 계약을 통해 광범위한 사용 사례에 무료로 제공됩니다.

다음 API는 사용 제한이 없습니다.

다음 Maps API에는 사용 제한이 적용됩니다. 사용 제한 세부정보를 보려면 해당 API를 클릭하세요.

Maps API는 표준 서비스 약관을 준수하여 배포되어야 합니다.

Google Maps APIs의 사용 제한이란 무엇인가요?

대부분의 Google Maps APIs에는 Google API Console에서 설정 가능한 일일 무료 할당량이 있습니다. 일일 기본 쿼리와 최대 쿼리는 API별로 다릅니다. 결제를 활성화하거나 Google Maps API 프리미엄 플랜 라이선스를 구매하여 무료 일일 제한을 늘릴 수 있습니다.

  • Web Service API:

    Google Maps Web Service API에는 하루당 2,500개의 무료 요청이 포함되며, 이것은 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다. 더 높은 일일 할당량(하루당 최대 100,000)에 액세스할 수 있도록, 저희는 선불 가격을 제공합니다.

    선불을 선택할 수 있는 .

  • Web API:

    Google Maps JavaScript API, Google Static Maps API 및 Google Street View Image API에는 하루당 25,000개의 지도 로드 무료 일일 제한이 있습니다. 더 높은 일일 할당량(하루당 최대 100,000)에 액세스할 수 있도록, 저희는 선불 가격을 제공합니다.

    웹사이트가 하루 25,000개의 지도 로드를 초과할 경우, 초과한 사용량에 대해 결제를 활성화하지 않으면 당일 나머지 기간 동안 API가 작동을 중지합니다.

    상황에 따라 할당량 예외가 적용될 수도 있습니다. 자세히 알아보기.

다음 사항의 정확한 정의에 대해서는 구체적 질문을 참조하세요.

참고: 공공의 이익에 부합한다고 여겨지는 애플리케이션(Google의 판단에 따라 결정)에는 이러한 사용 제한이 적용되지 않습니다. 예:

  • 일반적으로 재해 구조용 지도는 상업적 조직에 의해 개발되고 호스팅되더라도 사용 제한이 적용되지 않습니다. 위기 대응 조직은 더 늘어난 할당량 제한을 신청할 수도 있습니다. 자세히 알아보고 신청하세요.
  • Google Maps APIs의 지오코딩 제한이나 내부 사용량을 더 많이 필요로 하는 비영리 조직이 자격을 갖춘 경우에는 Google Earth Outreach 보조금 프로그램을 통해 Google Maps API 프리미엄 플랜 라이선스를 신청할 수가 있습니다.
  • 기본 플랜을 사용하고 자격을 갖춘 언론 기관은 더 늘어난 할당량 제한을 신청할 수도 있습니다. 자세히 알아보고 신청하세요.

사용 할당량은 어떻게 계산되나요?

사용 할당량의 계산 방식은 API에 따라 다릅니다. Web Service API는 요청 수를 사용합니다(참고로, Google Maps Distance Matrix API는 요소 수를 사용합니다). Web API지도 로드를 사용하여 사용 할당량을 계산합니다.

Google Maps Distance Matrix API의 경우, API로 전송되는 각 쿼리는 허용된 요소 수로 제한되며, 여기에서 출발지 수에 목적지 수를 곱하면 요소 수가 됩니다.

Google Maps APIs Web Services의 사용을 제한하는 할당량 유형은 장기간(하루당 할당량) 및 단기간(요청 속도 할당량)의 두 가지가 있습니다. 이러한 사용 제한은 Maps Web Service API를 통해 서버측에서 요청이 수행되는지 아니면 Directions, Distance Matrix, Elevation 또는 Geocoding의 경우 JavaScript 서비스를 통해 클라이언트측에서 요청이 수행되는지에 따라 적용됩니다.

참고: 또한 추가적인 제한을 API에 설정할 수도 있습니다. 예를 들어, Elevation API는 요청 제한당 위치가 하나 있습니다. 또한 하루당 할당량 외에도 Image API에는 최대 이미지 해상도가 포함됩니다. 자세한 내용은 각 Google Maps APIs의 사용 제한 페이지를 참조하세요.

웹용 Google Maps APIs에서 지도 로드의 사용 제한은 어떻게 적용되나요?

다음 경우가 발생하면 단일 지도 로드에 대해 비용이 부과됩니다.

  • 웹페이지 또는 애플리케이션이 Google Maps JavaScript API를 사용하여 지도를 표시합니다.
  • 웹페이지 또는 애플리케이션이 Google Maps JavaScript API를 사용하여 Google Street View Image API 파노라마를 표시합니다. 스트리트 뷰 파노라마가 동일 div 요소에 있는 지도를 대체하는 경우, 이 파노라마는 요금이 부과되지 않습니다.
  • 애플리케이션은 Google Static Maps API에서 단일 지도 이미지를 요청합니다.
  • 애플리케이션은 Google Street View Image API에서 단일 파노라마 이미지를 요청합니다.

웹페이지 또는 애플리케이션이 지도, 정적 지도 이미지 또는 스트리트 뷰 파노라마를 로드한 후의 모든 사용자 상호작용(예: 패닝, 확대/축소 또는 지도 계층 전환)은 추가적인 지도 로드를 생성하지 않으며 사용 제한에 영향을 미치지 않습니다.

Google Maps API 프리미엄 플랜 애플리케이션은 Maps API 크레딧으로 환산된 할당량을 소모합니다. 자세한 내용은 프리미엄 플랜 사용 요금 및 제한을 참조하세요.

제 사용 할당량을 어떻게 모니터링하나요?

Google API Console에서 개별 API의 사용 할당량을 모니터링할 수 있습니다.

  1. 검토하려는 API가 포함된 프로젝트를 선택합니다.
  2. 대시보드의 API 목록에서 API의 이름을 클릭합니다.
  3. 페이지 상단 부근에서 할당량 또는 사용량을 클릭합니다.

참고: 전체 프로젝트에 대한 트래픽 보고서와 결제 정보를 보려면, 먼저 결제를 활성화하십시오.

사용 제한을 초과하면 어떻게 되나요?

해당 Maps API의 사용 제한을 초과하면 API에서 오류 메시지를 반환합니다. 이 제한을 반복해서 초과할 경우, API에 대한 액세스 권한이 일시적으로 차단될 수 있습니다.

  • Web Service API

    Google Maps APIs Web Services의 경우, 사용을 제한하는 할당량 유형은 장기간(일일 할당량) 및 단기간(요청 속도 할당량)의 두 가지가 있습니다. 사용 제한을 초과했거나 서비스를 남용한 경우, 웹 서비스에서 특정한 오류 메시지를 반환합니다. 제한을 계속 초과할 경우, 웹 서비스에 대한 액세스 권한이 차단될 수 있습니다.

    다음과 같은 경우 Google Maps APIs Web Services의 사용 제한을 초과할 수 있습니다.

    • 하루당 너무 많은 요청을 전송하는 경우.
    • 너무 빨리 즉, 초당 너무 많은 요청을 전송하는 경우.
    • 너무 오랫동안 너무 빨리 요청을 전송하거나 웹 서비스를 남용하는 경우.
    • 다른 사용 제한(예: Elevation API의 요청당 위치 수 제한)을 초과하는 경우.

    참고: 다음의 네 가지 Web Service API에는 JavaScript API에서 사용 가능한 것과 동일한 클라이언트측 서비스가 있습니다: Directions, Distance Matrix, ElevationGeocoding.

    요청이 클라이언트측에서 수행되든 서버측에서 수행되든 간에, 모든 사용 제한(장기간 및 단기간)이 서비스에 의해 공유됩니다. 예를 들어, 웹 서비스의 일일 무료 할당량은 하루당 2,500개 요청으로 설정되며, 클라이언트측 서비스와 서버측 요청 간에 공유됩니다. JavaScript API 길찾기 서비스를 사용하여 하루당 1,500개 요청을 수행하고 또한 서버측 Google Maps Directions API를 사용하여 하루당 2,000개 요청을 수행하는 경우, 하루의 길찾기 요청이 3,500개가 되어 일일 무료 할당량을 1,000개만큼 초과합니다.

  • Web API

    Web API는 Google Maps JavaScript API v3, Google Static Maps API 및 Google Street View Image API이며 지도 로드의 하루당 무료 제한은 각각 25,000개입니다.

    일부 고객의 경우 할당량 예외가 적용될 수 있습니다. 자세히 알아보기.

사용 제한 초과됨

사용 제한을 초과하면 OVER_QUERY_LIMIT 상태 코드가 응답으로 나타납니다.

즉, 웹 서비스는 정상적인 응답 제공을 중단하고, 더 많은 사용량이 다시 허용될 때까지 상태 코드 OVER_QUERY_LIMIT만을 반환합니다. 이 상황은 다음과 같은 경우에 발생할 수 있습니다.

  • 애플리케이션이 초당 너무 많은 요청을 전송하여 오류가 수신되고 몇 초 이내의 경우.
  • 애플리케이션이 하루당 너무 많은 요청을 전송하여 오류가 수신되고 향후 24시간 이내의 경우. 일일 할당량은 태평양 시간으로 자정에 재설정됩니다.

하루당 사용 제한을 정기적으로 초과하는 경우, 다음 사항을 고려하세요.

  • Google Maps API를 더 효율적으로 사용하도록 애플리케이션을 최적화하여 사용량을 낮춥니다.
  • 프로젝트에서 결제 활성화를 수행하여 사용 제한을 늘립니다.
  • Google Maps API 프리미엄 플랜 라이선스를 구매합니다.
제 사이트에 트래픽이 너무 많습니다. Maps API를 사용할 수 있나요?

예. 그러나, 애플리케이션이 사용하는 Google Maps APIs의 사용 제한에 친숙해 지는 것이 좋습니다.

Google Maps API 프리미엄 플랜를 꼭 구매해야 하나요?

귀하의 회사 또는 조직에 다음 사항이 필요할 경우 Google Maps API 프리미엄 플랜를 구매해야 합니다.

  • 24시간 기술 지원을 포함한 SLA
  • Google 지도가 포함된 제품 또는 서비스를 판매하기 위한 역량
  • 내부 애플리케이션 또는 웹사이트에 Google Maps APIs를 사용하기 위한 역량
  • 특정한 크기의 할당량
  • 자산 추적 애플리케이션에 Google Maps APIs(Places API 제외)를 사용하기 위한 역량
  • 기존 Maps APIs for Work 라이선스로 사용이 가능한 프리미엄 플랜 기능

Google Maps API 프리미엄 플랜를 구매하려면 어떻게 하나요?

Google Maps API 프리미엄 플랜를 구매하기 위한 자세한 내용과 애플리케이션의 예상 사용량에 따른 가격 견적을 받아보시려면, Google 영업 담당자에게 문의하세요.

  • Web Service API

    Web Service API를 사용 중인 경우 하루당 2,500개의 무료 요청이 허용되며, 이것은 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다. 자동 결제에 등록하면 무료 할당량 초과 시에, 하루당 최대 100,000건의 요청까지 선불 할당량에 액세스할 수 있습니다.

  • Web API

    Google Maps Web API(Maps JavaScript API, Static Maps API 또는 Street View Image API)를 사용 중인 경우, 하루당 25,000개의 무료 지도 로드가 허용됩니다. 자동 결제에 등록하면 무료 할당량 초과 시에, 일일 최대 100,000건의 지도 로드까지는 선불 할당량에 액세스할 수 있습니다.

    상황에 따라 할당량 예외가 적용될 수도 있습니다. 자세히 알아보기.

일일 무료 할당량을 초과하는데 결제가 활성화되지 않은 경우 당일 나머지 기간 동안 API가 작동을 중단합니다.

초과 사용량은 어떻게 계산하고 결제하나요?

각 Maps API 서비스의 무료 할당량을 초과하는 초과 사용량은 하루가 끝날 때 계산됩니다.

  • Web Service API

    Web Service API는 하루당 2,500개의 무료 요청을 제공하며, 이것은 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다. 결제 활성화를 수행하여 더 높은 할당량에 액세스한 경우, 일일 2,500건의 요청을 초과하면, 하루 최대 100,000건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다.

  • Web API

    Google Maps Web API(Maps JavaScript API, Static Maps API 또는 Street View Image API)는 하루당 25,000개의 무료 지도 로드를 제공합니다. 결제 활성화를 수행하여 더 높은 할당량에 액세스한 경우, 일일 25,000건의 한도를 초과하면, 하루 최대 100,000건의 지도 로드까지 1,000건의 지도 로드당 $0.50 USD의 비용이 청구됩니다.

    상황에 따라 할당량 예외가 적용될 수도 있습니다. 자세히 알아보기.

사용 제한을 초과하면 어떻게 되는지에 대해 자세히 알아봅니다.

결제 활성화를 선택하면 신용 카드 세부정보를 제공해야 합니다. 귀하의 초과 사용량은 하루가 끝날 때마다 계속해서 계산되며, 제공된 신용 카드에 청구된 총 금액이 매달 말에 계산됩니다. 가격은 아래와 같습니다.

Google Maps APIs를 사용하는 비용은 얼마나 되나요?

사용 제한을 넘지 않는 요청 또는 지도 로드 볼륨을 생성하는 애플리케이션은, Google Maps APIs 서비스 약관요구사항을 충족하면, 무료로 Google Maps APIs를 사용할 수 있습니다.

Web Service API의 경우, Maps API 서비스가 일일 사용 제한을 초과하고 여러분이 Google API Console을 사용하여 초과 할당량 구매를 온라인으로 선택하면, 아래 나타난 해당 서비스 요금이 초과 사용량에 부과됩니다. 일일 사용량은 프로젝트별로 추적되며 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다.

Google Maps JavaScript API v3, Google Static Maps API 및 Google Street View Image API의 경우, Maps API 서비스가 일일 사용 제한을 초과하고 여러분이 Google API Console을 사용하여 초과 지도 로드 구매를 온라인으로 선택하면, 아래 나타난 해당 서비스 요금이 초과 사용량에 부과됩니다. 일일 사용량은 프로젝트별로 추적됩니다.

참고로, 귀하의 사이트가 하루당 많은 볼륨의 요청이나 지도 로드를 꾸준히 생성하는 경우에는, Google Maps API 프리미엄 플랜 라이선스가 더욱 비용 효과적일 수 있습니다. 자세한 내용은 Google Maps API 프리미엄 플랜 영업팀에 문의하세요.

Web Service API 무료 제한
(하루당)
1000개의 초과 요청
(미화 달러 단위)
Directions API + 길찾기 클라이언트측 서비스 2,5002 $0.50
Distance Matrix API + 거리 행렬 클라이언트측 서비스 1 2,5002 $0.50
Elevation API + 고도 클라이언트측 서비스 2,5002 $0.50
Geocoding API + 지오코딩 클라이언트측 서비스 2,5002 $0.50
Geolocation API 2,500 $0.50
Roads API 2,500 $0.50
Time Zone API 2,500 $0.50
1 Google Maps Distance Matrix API 및 거리 행렬 클라이언트측 서비스 사용량은 하루당 요소의 수로 측정됩니다.
2 일일 무료 할당량은 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다.
Web API 무료 제한
(하루당)
1000개의 초과 지도 로드
(미화 달러 단위)
Google Maps JavaScript API 25,000* $0.50
Google Static Maps API 25,000* $0.50
Google Street View Image API 25,000* $0.50
* 할당량 예외가 적용될 수 있습니다. 자세히 알아보기.

참고로, 초과 할당량을 온라인으로 구매한다고 해서, 기존 서비스 약관에 따라 Google Maps APIs를 계속 사용할 수 있는 권한 이외의 다른 추가 권한이나 혜택을 부여하지는 않습니다.

가격을 다른 통화로도 볼 수 있나요?

현재는 미화 달러로만 가격을 보실 수 있습니다.

결제를 활성화했습니다. 제 청구서를 보려면 어떻게 하나요?

Google은 이전 달의 활동에 대해 매월 초에 지정된 결제 방법을 사용하여 귀하에게 비용을 청구합니다.

예상치 못한 사용량 증가로 많은 금액의 청구서를 받지 않으려면 어떻게 해야 하나요?

Google Maps APIs는 무료 일일 할당량을 제공하며, 일일 결제 가능 한도를 설정합니다. 예상치 못한 사용량 증가를 방지하려면 일일 최대 사용량 한도를 설정하면 됩니다. 또한 결제 계좌의 청구액이 설정 한도에 도달하는 경우, 이메일 알림을 받을 수 있는 결제 알림을 설정할 수도 있습니다.

일일 결제 가능한 최대 한도 설정:

  • Web Service API의 경우:

    표준 Web Service API는 매일 100,000개까지 요청 또는 요소를 지원합니다. 프로젝트에서 결제 활성화를 수행할 때까지는, 프로젝트에서 하루당 무료 한도가 2,500개로 제한됩니다. 결제가 활성화된 경우, 일일 2,500건의 요청을 초과하면, 하루 최대 100,000건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다. 사용량은 (Google Maps JavaScript API 서비스를 통해 수행되는) 클라이언트측 요청과 서버측 요청의 합계로 계산됩니다.

    많은 금액의 청구서를 받지 않으려면, 사용량에 일일 한도를 설정하여 예상치 못한 사용량 증가를 방지할 수 있습니다. 현재, 결제 가능한 최대 한도는 기본적으로 하루당 100,000개 요청입니다. Google API Console에서 이 제한을 변경할 수 있습니다. API의 Quotas 페이지에서 "requests per day" 할당량 옆의 편집 아이콘을 클릭합니다.

    참고: 해당 날짜에 API 사용량이 결제 가능 한도에 도달하면, 이 날짜의 남은 시간 동안 애플리케이션이 API에 액세스할 수 없습니다. 사용 제한을 초과하면 어떻게 되는지에 대해 자세히 알아보세요.

  • Web API의 경우:

    Google Maps JavaScript API v3, Google Static Maps APIGoogle Street View Image API의 경우 표준 Google Maps Web API 사용 시에 무료 사용 제한을 초과하면, 프로젝트에서 결제 활성화를 수행하여 초과 지도 로드를 온라인으로 구입할 수 있습니다. 결제가 활성화된 경우, 무료 사용 제한을 초과하면, 하루 최대 100,000건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다.

    결제가 시작된 후에 많은 금액의 청구서를 받지 않으려면, 사용량에 일일 한도를 설정하여 예상치 못한 사용량 증가를 방지할 수 있습니다. 현재, 결제 가능한 최대 한도는 기본적으로 하루당 100,000개 요청입니다. Google API Console에서 이 제한을 변경할 수 있습니다. API의 Quotas 페이지에서 "requests per day" 할당량 옆의 편집 아이콘을 클릭합니다.

    참고: 해당 날짜에 API 사용량이 결제 가능 한도에 도달하면, 이 날짜의 남은 시간 동안 애플리케이션이 API에 액세스할 수 없습니다. 사용 제한을 초과하면 어떻게 되는지에 대해 자세히 알아보세요.

    참고: 일부 고객의 경우 할당량 예외가 적용될 수 있습니다. 자세히 알아보기.

결제 알림 설정 및 관리:

결제 계좌의 청구액이 설정 한도에 도달하는 경우, 이메일 알림을 결제 관리자에게 전송하도록 결제 알림을 설정하세요. 결제 계좌의 예상 청구액이 한도의 50%, 90% 및 100%를 초과할 때, 결제 관리자에게 이메일 알림이 전송됩니다.

권장 사항: 귀하의 사이트가 하루당 많은 볼륨의 지도 로드를 꾸준히 생성하는 경우에는, Google Maps API 프리미엄 플랜 라이선스가 더욱 비용 효과적일 수 있습니다. 자세한 내용은 Google Maps API 프리미엄 플랜 영업팀에 문의하세요.

Enabling billing

To enable billing and unlock higher quotas for the Google Maps APIs, we'll guide you through the Google Developers Console to complete a few tasks:

  1. Create or choose a project
  2. Set up or choose your billing profile
  3. Enable billing on your project
Continue

Google Maps APIs 사용

다른 지도 제품에는 어떤 키나 자격 증명을 사용해야 하나요?

Google Maps APIs를 사용할 때마다 요청을 검증하기 위해 키 또는 기타 자격 증명을 포함해야 합니다. Google Maps APIs는 Android, iOS 또는 웹 앱과 HTTP 웹 서비스를 통해 이용할 수 있습니다. 필요한 자격 증명의 유형은 API에 따라 다르며, 표준 또는 프리미엄 라이선스 보유 여부에 따라 다릅니다.

이 섹션의 정보는 기본 플랜 고객과 2016년 1월에 제공된 새로운 Google Maps API 프리미엄 플랜를 보유한 고객에게 적용됩니다. 이전 Maps APIs for Work 또는 Maps API for Business 라이선스를 보유한 경우에는 필수 자격 증명이 아래 나열된 것과 다를 수도 있습니다.

  • API 키: API 키는 Google API Console을 사용하여 생성되는 고유 식별자입니다. API 키는 일반적으로 표준 API와 함께 사용됩니다. 프리미엄 플랜 고객1은 대개 클라이언트 ID나 API 키를 사용하도록 선택할 수 있습니다.

    제한이 적용되지 않은 API 키(“일반적인 API 키”)를 사용하거나 더 나은 보안을 위해 제한이 적용된 키를 사용하도록 선택할 수 있습니다. 모든 플랫폼의 API는 일반적인 API 키를 사용할 수 있습니다.

    선택적으로 하나의 제한(예: IP 주소)을 API 키에 추가할 수 있습니다. 제한된 경우, 해당 유형의 제한을 지원하는 플랫폼에서만 키가 작동합니다. 네 가지 유형의 API 키 제한을 사용할 수 있습니다.

    • 서버 제한(IP 주소별) - Web Service API에 사용.
    • 브라우저 제한(HTTP 참조 페이지별) - Web API에 사용.
    • Android 앱 제한(패키지 이름 및 지문별) - Android API에 사용.
    • iOS 앱 제한(iOS 번들 식별자별) - iOS API에 사용.

    동일한 플랫폼의 API는 제한된 동일한 키를 사용할 수 있습니다.

    Google Maps API 프리미엄 플랜 및 Google Maps APIs for Work 고객의 경우 참고: Google API Console에서 키를 생성할 경우, 등록 시 생성된 프로젝트를 선택해야 합니다. 프로젝트 이름은 Google Maps APIs for Business 또는 Google Maps for Work 또는 Google Maps로 시작합니다.

    키로 API 로드 예시: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

  • 클라이언트 ID: 여러분이 Google Maps API 프리미엄 플랜 또는 Google Maps APIs for Work 고객으로 등록할 때 클라이언트 ID가 여러분에게 부여됩니다. 프리미엄 플랜 고객은 대개 클라이언트 ID나 API 키를 사용하도록 선택할 수 있습니다.

    클라이언트 ID로 API 로드 예시: &client=gme-companyname

  • 디지털 서명: 디지털 서명은 클라이언트 ID로 인증할 때 Google Maps API 프리미엄 플랜 및 Google Maps APIs for Work 고객에 의해 일반적으로 사용됩니다. 디지털 서명은 Google이 귀하에게 제공한 암호화 키를 사용하여 생성됩니다. 또한 디지털 서명은 Google Static Maps API 및 Google Street View Image API에서 사용됩니다. 표준 Google Static Maps API 및 Google Street View Image API를 사용 중이고 청구가 활성화된 경우, 지도 로드가 일일 무료 할당량을 초과한다면 디지털 서명이 필수입니다.

아래 표는 각 Maps API 제품에 사용되어야 하는 키/자격 증명을 나타냅니다. (위에 언급했듯이 API 키 제한의 유형은 서버, 브라우저, Android 및 iOS입니다.)

API 표준 API 사용자 프리미엄 플랜 사용자1
Google Maps Android API Android 제한이 있는 API 키2 Android 제한이 있는 API 키2
Google Places API for Android Android 제한이 있는 API 키2 사용할 수 없음
Google Maps SDK for iOS iOS 제한이 있는 API 키2 iOS 제한이 있는 API 키2
Google Places API for iOS iOS 제한이 있는 API 키2 사용할 수 없음
Google Maps JavaScript API 브라우저 제한이 있는 API 키2 브라우저 제한이 있는 API 키2
또는
클라이언트 ID
Google Static Maps API 브라우저 제한이 있는 API 키2 + 선택 항목3 디지털 서명 브라우저 제한이 있는 API 키 2 + 디지털 서명
또는
클라이언트 ID + 디지털 서명
Google Street View Image API 브라우저 제한이 있는 API 키2 + 선택 항목2 디지털 서명 브라우저 제한이 있는 API 키 2 + 디지털 서명
또는
클라이언트 ID + 디지털 서명
Google Maps Embed API 브라우저 제한이 있는 API 키2 사용할 수 없음
Google Maps Directions API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
또는
클라이언트 ID + 디지털 서명
Google Maps Distance Matrix API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
또는
클라이언트 ID + 디지털 서명
Google Maps Elevation API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
또는
클라이언트 ID + 디지털 서명
Google Maps Geocoding API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
또는
클라이언트 ID + 디지털 서명
Google Maps Geolocation API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
Google Maps Roads API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
Google Maps Time Zone API 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
또는
클라이언트 ID + 디지털 서명
Google Places API Web Service 서버 제한이 있는 API 키2 서버 제한이 있는 API 키2
1 프리미엄 플랜2016년 1월에 제공된 새로운 Google Maps API 프리미엄 플랜를 나타냅니다. 이전 Maps APIs for Work 또는 Maps API for Business 라이선스를 보유한 경우에는 필수 자격 증명이 위에 나열된 것과 다를 수도 있습니다. 어떤 플랜을 구매했는지 잘 모르시나요? 라이선스 유형을 확인하는 방법에 대해 알아보세요.
2 개발과 프로토타입 생성 중에는 Maps 또는 Places API에 일반적인 API 키(제한이 없는 키)를 사용할 수도 있습니다. API 키를 프로덕션 환경에 사용하기 전에, 제한을 사용하여 API 키를 보호하는 것이 좋습니다. 안전한 API 키 사용을 위한 모범 사례에 대해 알아보세요.
3 Google Static Maps API 및 Google Street View Image API에서 표준 API를 사용 중이고 또한 결제를 활성화한 경우, 25,000건의 지도 로드 일일 무료 할당량을 초과한다면, 결제 가능한 모든 지도 로드에 대해 디지털 서명이 필수입니다.
키 제한 유형을 브라우저 제한에서 서버 제한으로 전환하려면 어떻게 하나요?

중요: 참조 페이지 제한이 있는 API 키와 함께 Web Service API 중 하나를 사용 중인 경우, 다음 오류 메시지와 함께 요청이 실패합니다. "이 API 키와 사용할 경우에는 API 키에 참조자 제한이 있으면 안됩니다." 서버 제한 사용으로 전환해야 합니다.

API 키 제한 유형을 브라우저에서 서버로 전환하기 전에, API 키를 사용하는 모든 API가 Web Service API인지 확인하세요. 동일한 플랫폼의 API는 제한된 동일한 키를 사용할 수 있습니다. 둘 이상의 플랫폼에 맞춰야 하는 경우에는, 필요한 플랫폼 제한과 함께 별도의 키를 추가하세요. 새 API 키를 추가하는 방법을 참조하세요.

브라우저 제한 API 키를 서버 제한 키로 전환하려면 다음 작업을 수행하세요.

  1. Google API Console의 Credentials 페이지로 이동합니다.
  2. 편집하려는 API 키가 포함된 프로젝트를 선택합니다.
  3. Credentials 페이지의 API 키 목록에서, 세부정보를 편집할 API 키의 이름을 선택합니다.
  4. 페이지의 Restrictions 섹션에서 “IP addresses (web servers, cron jobs, etc.)”를 선택하고 적절한 서버 IP 주소를 삽입한 다음, Save를 클릭합니다.
새 API 키를 구하려면 어떻게 하나요?

새 API 키를 만들려면 다음 작업을 수행하세요.

  1. Google API Console로 이동합니다.
  2. 프로젝트를 선택하거나 생성합니다.
  3. 새로운 API 키를 생성하려면 Create credentials 버튼을 클릭합니다.
  4. 자격 증명 유형의 목록에서 API key를 선택합니다.
  5. 새 키가 생성되고 팝업 창에 표시됩니다.
  6. 원하는 키 제한을 설정하려면(선택 항목) Restrict key를 선택한 다음, 페이지의 지시에 따라 제한을 설정합니다.
  7. API 키가 자격 증명 페이지에 나열됩니다. 참고로, 목록에 있는 키는 제한 유형별로 구분됩니다. 제한이 없는 API 키는 일반적인 키이며 모든 API에 사용될 수 있습니다.

API 키를 요청에 지정

API 키를 요청에 지정하려면 해당 키를 key 매개변수의 값으로 포함합니다.

예:

Elevation API의 경우:

https://maps.googleapis.com/maps/api/elevation/json?locations=39.739,-104.984&key=YOUR_API_KEY

Geolocation API의 경우:

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

다음 오류를 어떻게 해결하나요? "이 IP, 사이트 또는 모바일 애플리케이션은 이 API 키를 사용할 권한이 없습니다."

이 오류를 유발할 수 있는 다음과 같은 다양한 상황이 있습니다.

  • API 키에 대해 IP 주소 (서버) 제한을 활성화했으며, 불법 IP 주소가 요청을 시도 중입니다.
  • API 키에 대해 HTTP 참조 페이지 (브라우저) 제한을 활성화했으며, 불법 참조 페이지가 요청을 시도 중입니다.
  • 패키지 이름과 지문을 설정하여 Android 앱의 사용을 제한했으며, 불법 Android 앱이 요청을 시도 중입니다.
  • 번들 식별자를 지정하여 iOS 앱에서의 요청을 제한했으며, 불법 iOS 앱이 요청 전송을 시도 중입니다.
  • 이 오류는 브라우저 제한 API 키와 함께 Web Service API 중 하나를 사용한 경우 발생했었습니다. Web Service API에 대한 요청은 서버 제한 API 키로 식별되어야 합니다. 키 제한 유형을 브라우저 제한 키에서 서버 제한 키로 전환합니다.

API 키 자격 증명 보기 및 편집

API 키를 확인하고 제한을 관리하려면 다음을 수행하세요.

  1. Google API Console로 이동합니다.
  2. 검토하려는 API 키가 포함된 프로젝트를 선택합니다.
  3. 키에 설정된 모든 제한을 비롯한 자격 증명 세부정보를 보려면, API 키 목록에서 키의 이름을 클릭합니다.
  4. 키에 설정된 모든 제한을 비롯하여 선택한 API 키의 전체 자격 증명이 표시됩니다. 여기서부터는, 필요에 따라 제한을 변경하거나 삭제하거나 업데이트할 수 있습니다.

다음 오류를 어떻게 해결하나요? "이 API 키와 사용할 경우에는 API 키에 참조자 제한이 있으면 안됩니다."

브라우저 제한 API 키와 함께 Web Service API 중 하나를 사용 중입니다. 보안상의 이유로, Web Service API는 서버 제한 API 키를 사용해야 합니다. 키 제한 유형을 브라우저 제한에서 서버 제한으로 전환합니다.

Google Maps API의 각 버전에 소개되는 변경사항을 어떻게 찾을 수 있나요?

Google Maps JavaScript API 버전 간의 변경사항에 대한 목록은 다음 주소에서 유지 관리됩니다:

https://developers.google.com/maps/documentation/javascript/releases

또한 어떤 버전의 Google Maps APIs에서 특정 버그가 발생했는지 그리고 Google Maps APIs Issue Tracker를 사용하여 이 버그가 수정되었는지를 다음 주소에서 확인할 수 있습니다.

http://code.google.com/p/gmaps-api-issues/issues/list

페이지가 로드된 후 이 페이지에 API를 비동기식으로 로드하려면 어떻게 하나요?

API를 로드할 때 콜백 매개변수만 지정합니다. 자세한 내용과 샘플 코드는 Maps JavaScript API 문서의 시작하기 장을 참조하세요.

영어 이외의 다른 언어로 Google Maps APIs를 표시하려면 어떻게 하나요?

기본적으로 API는 사용자 위치나 브라우저 설정에 따라 가장 적절한 언어를 로드하려고 시도합니다. 일부 API에서는 요청을 수행할 때 명시적으로 언어를 설정할 수 있습니다. 각 API의 문서에 사용 가능한 언어를 설정하는 자세한 방법:

지원되는 언어
언어 코드 언어 언어 코드 언어
ar 아랍어 kn 칸나다어
bg 불가리아어 ko 한국어
bn 벵골어 lt 리투아니아어
ca 카탈로니아어 lv 라트비아어
cs 체코어 ml 말라얄람어
da 덴마크어 mr 마라티어
de 독일어 nl 네덜란드어
el 그리스어 no 노르웨이어
en 영어 pl 폴란드어
en-AU 영어(호주) pt 포르투갈어
en-GB 영어(영국) pt-BR 포르투갈어(브라질)
es 스페인어 pt-PT 포르투갈어(포르투갈)
eu 바스크어 ro 루마니아어
eu 바스크어 ru 러시아어
fa 페르시아어 sk 슬로바키아어
fi 핀란드어 sl 슬로베니아어
fil 필리핀어 sr 세르비아어
fr 프랑스어 sv 스웨덴어
gl 갈라시아어 ta 타밀어
gu 구자라트어 te 텔루구어
hi 힌디어 th 타이어
hr 크로아티아어 tl 타갈로그어
hu 헝가리어 tr 터키어
id 인도네시아어 uk 우크라이나어
it 이탈리아어 vi 베트남어
iw 히브리어 zh-CN 중국어 간체
ja 일본어 zh-TW 중국어 번체

샘플 애플리케이션에서는 귀하의 언어에서 지도가 어떻게 보이는지를 아실 수 있습니다.

SSL(HTTPS)를 통해 Google Maps APIs에 액세스할 수 있나요?

Google Maps JavaScript API, Google Static Maps API 및 Google Maps APIs Web Services는 이러한 API의 무료 버전 또는 Google Maps API 프리미엄 플랜를 사용하는 개발자가 보안(HTTPS) 연결을 통해 액세스할 수 있습니다. SSL을 통해 API에 액세스하는 방법에 대한 정보는 해당 API의 문서를 참조하세요.

참고로, Google Static Maps API는 HTTPS를 사용하는 사용자 지정 아이콘 URL을 지원하지 않으며, 기본 아이콘이 표시됩니다.

Google Maps APIs에서 버그를 신고하거나 새로운 기능을 요청하려면 어떻게 하나요?

버그로 의심될 수 있는 동작이 발생하는 경우, 먼저 이 동작을 관련 포럼에 올리세요. 이렇게 하면 다른 개발자가 버그를 검증하고 귀하의 코드에서 잠재적인 문제를 제외시킬 것입니다.

특정한 기능을 요청하려면, 이 또한 관련 포럼에 먼저 올려서, 귀하의 요구사항을 충족시키는 솔루션이 이미 있지 않은지 확인하세요.

새로운 버그를 식별했거나 Google Maps API의 기존 기능으로는 요구사항을 충족할 수 없는 것으로 확인되면, Google Maps APIs Issue Tracker를 사용하여 버그 또는 기능 요청을 보고해 주세요.

버그 또는 기능 요청을 Issue Tracker에 추가하기 전에, 해당 버그 또는 기능이 이미 추가되지 않았는지 확인하세요. 이미 추가된 경우, 해당 문제에 별점을 주어 관심을 표시하고 업데이트 알림을 받으실 수 있습니다.

이 오류는 무엇을 의미하나요?

Google Maps JavaScript API를 로드하는 중에 오류가 발생하면, 오류 메시지를 참조하여 해당 오류 코드의 설명을 찾아보세요.

다른 질문/문제가 있습니다. 누구에게 연락해야 하나요?

Google Developer Relations 팀은 공동으로 편집된 질문과 답변을 제공하는 사이트인 Stack Overflow를 프로그래머용으로 유지관리하고 있습니다. 이 사이트는 Google 지도 애플리케이션의 개발 및 유지관리에 대한 기술적인 질문을 올리는 데 적합한 사이트입니다. Stack Overflow에 질문을 올리는 방법에 대한 자세한 내용은지원 페이지에서 보실 수 있습니다.

도움을 요청할 때 최적의 결과를 얻으려면, 다음 사항을 명심하세요.

  • 최신 논의를 검색하세요. 다른 누군가나 비슷한 문제를 겪었고 해결책을 찾아냈을 수도 있습니다.
  • 가능하면 본인의 사이트 링크를 제출하세요. 코드를 온라인으로 보기가 쉽지 않은 경우, 코드 스니펫만 게시하세요.
  • 이 문제의 해결에 도움이 될 수 있는 모든 관련 정보(브라우저 버전, 오류 및 기타 정보)를 제공하세요.

Google Maps API 프리미엄 플랜 고객은 프리미엄 플랜 지원에 문의할 수도 있습니다.

Google Maps APIs 서비스

주소를 위도/경도 쌍으로 변환해야 합니다. Google Maps APIs에서 변환할 수 있나요?

네, 이 프로세스를 "지오코딩"이라고 합니다. Google Maps JavaScript API에는 지오코딩 서비스를 수행하기 위한 클래스가 포함됩니다. 이 클래스는 google.maps.Geocoder입니다.

또한 Google은 Google Maps Geocoding API도 제공하며, 이 서비스는 JSON 및 XML 형식으로 응답할 수 있는 REST 인터페이스를 제공합니다.

지오코더 요청에 적용되는 사용 제한을 숙지하고, Google Maps APIs를 사용하여 표시될 위치를 구할 목적이 아닌 다른 목적으로 지오코더를 사용하는 것은 서비스 약관을 위반하는 것임에 유의하십시오. Maps API 애플리케이션을 벗어나는 주소를 지오코딩하는 경우, 이 주소를 캐시에 저장했다가 나중에 Google Maps APIs 중 하나를 사용하여 표시할 수 있도록 HTTP 지오코더를 사용할 수는 있지만, Google Maps Geocoding API 또는 지오코딩 서비스를 사용하여 획득한 위치를 다른 애플리케이션에서 사용하거나, 다른 수단으로 배포하거나 재판매할 수는 없습니다.

지오코딩을 사용할 수 있는 국가는 어디인가요?

현재 Google Maps APIs 지오코더에서 지원하는 국가를 보려면, Google 지도 커버리지 데이터를 참조하세요.

지오코딩된 위치의 정확성은 국가마다 다를 수 있으므로, 애플리케이션의 목적에 맞는 충분히 정확한 일치 항목이 발견되었는지 여부를 판별하려면, 반환된 location_type 필드를 사용해야 합니다. 참고로, 지오코딩 데이터의 가용성은 저희와 데이터 공급자와의 접촉에 따라 달라지므로, 가용성이 변경될 수가 있습니다.

현재 Google Maps APIs가 지원하는 않는 국가에서 지오코딩을 수행하려면, 이 목록의 다른 지오코딩 서비스를 찾아보세요.

Google Maps APIs 지오코더가 Google 지도와 다른 위치를 제공하는 이유는 무엇인가요?

API 지오코더와 Google 지도 지오코더는 (국가에 따라) 다른 데이터 집합을 사용하는 경우가 있습니다. API 지오코더는 가끔씩 새로운 데이터로 업데이트되므로, 시간이 지남에 따라 결과가 변경되거나 개선되는 것을 보실 수 있습니다.

요청 성공 횟수를 극대화하려면, 지오코더 쿼리의 형식을 어떻게 지정해야 하나요?

지오코더는 거리 주소를 지리 좌표로 매핑하도록 설계되었습니다. 따라서, 쿼리의 성공 가능성을 극대화하려면 다음의 지침에 따라 지오코더 요청의 형식을 지정하는 것이 좋습니다.

  • 해당 국가의 국내 우편 서비스에서 사용되는 형식에 따라 주소를 지정합니다.
  • 해당 국가의 우편 서비스에서 정의되는 형식의 주소에 포함되지 않는 추가적인 주소 요소(예: 사업체 이름, 부서 번호, 방 번호 또는 스위트 번호)는 지정하지 마십시오.
  • 가능한 경우 건물 이름보다는 구역의 번지를 사용합니다.
  • 가능한 경우 교차로를 지정하기보다는 번지 주소를 사용합니다.
  • 주변 랜드마크와 같은 '힌트'를 제공하지 마십시오.

지오코딩을 위해, 번호가 있는 고속도로에서 미국 주소를 어떤 형식으로 지정해야 하나요?

Google Maps APIs 지오코더에서는 번호가 있는 미국 고속도로의 주소를 다음과 같이 지정해야 합니다.

  • 카운티 도로: "Co Road NNN", 여기서 NNN은 도로 번호입니다. 예: "Co Road 82"
  • 주 고속도로: "State NNN", 여기서 State는 주의 전체 이름이고 NNN은 고속도로 번호입니다. 예: "California 82"
  • 미국 고속도로: "U.S. NNN", 여기서 NNN은 고속도로 번호입니다. 예: "U.S. 101"
  • 미국 주간 고속도로: "Interstate NNN", 여기서 NNN은 주간 고속도로 번호입니다. 예: "Interstate 280"

언제 API 지오코더 클래스를 사용하고 언제 HTTP 지오코딩 서비스를 사용해야 하나요?

다음 문서를 참조하세요. Geocoding Strategies: 서로 다른 지오코딩 전략의 장점과 단점을 상세히 설명합니다.

Google Maps APIs로 자동차 길찾기를 제공하려면 어떻게 하나요?

Google Maps JavaScript API에서는 google.maps.DirectionsService 클래스를 통해 자동차 길찾기를 제공할 수 있습니다. 이 클래스는 기본 및 다중 지점 자동차 길찾기에 대한 단계별 액세스를 제공합니다. DirectionsRenderer 클래스는 오버레이와 길찾기 패널을 자동으로 생성할 수 있습니다. 추가 예시가 문서에 제공됩니다.

또한 자동차 길찾기를 위해 Google 지도에 쉽게 링크할 수 있습니다. Google 지도에서 자동차 길찾기에 대해 다음 형식을 사용하도록 제안합니다:

http://maps.google.com/maps?saddr={start_address}&daddr={destination_address}

어떤 국가에서 자동차 길찾기를 사용할 수 있나요?

현재 Maps API에서 자동차 길찾기가 지원되는 국가를 보려면, Google 지도 커버리지 데이터를 참조하세요. 참고로, 자동차 길찾기 데이터의 가용성은 저희와 데이터 공급자와의 접촉에 따라 달라지므로, 가용성이 변경될 수가 있습니다.

대중교통 길찾기를 사용할 수 있는 국가는 어디인가요?

Google Maps 길찾기 서비스는 Transit Coverage List에 나열된 모든 대중교통 공급자를 지원합니다(일본의 공급자는 제외).

Google Maps JavaScript API에서 지원되는 KML & GeoRSS의 기능은 무엇인가요?

Javascript API의 KmlLayer 클래스를 사용하여 개발자가 KML/KMZ 및 GeoRSS 파일을 지도 상단에 중첩되게 배치할 수 있습니다. 문서와 예시는 여기를 참조하세요.

Google Maps JavaScript API의 KmlLayer 클래스를 사용하여 표시할 수 있는 KML의 크기 및 복잡성에 대한 제한은 무엇인가요?

KmlLayer 클래스를 사용하여 KML을 표시할 때의 크기 및 복잡성 제한이 여기에 설명되어 있습니다.

Google Static Maps API에서 지원되는 마커 또는 경로 교점의 최대 수는 몇 개인가요?

Google Static Maps API에서 지원되는 마커 또는 경로 교점의 수는 제한이 없습니다. 사용자 지정 아이콘을 사용 중인 경우, 요청당 최대 5개의 고유 아이콘을 지정할 수 있지만, 각 아이콘을 지도 내에서 여러 번 사용할 수는 있습니다.

참고로, Google Static Maps API URL에는 최대 약 2,000자가 포함될 수 있으며, 이 때문에 각 위도/경도 쌍을 지정할 때 사용되는 소수점 자리 수에 따라 지정이 가능한 마커 및 경로 교점의 수가 제한됩니다. 사용되는 소수점 자리수와 지구상의 정확도 사이에 어떤 관계가 있는지에 대해서는 Decimal Degrees에 대한 Wikipedia 문서를 참조하세요.

중국에서는 Google Maps APIs에 액세스할 수 없는 이유가 무엇인가요?

Google Maps APIs는 중국 내의 도메인 maps.google.cn에서 서비스됩니다. 이 도메인은 https를 지원하지 않습니다. 중국에서 Google Maps APIs에 요청을 하는 경우, https://maps.googleapis.comhttp://maps.google.cn으로 바꿔 주세요.

예:

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

다음과 같이 변경:

http://maps.google.cn/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

Google Maps JavaScript API는 다음과 같은 부트스트랩으로 로드될 수 있습니다.

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY"
type="text/javascript">
</script>

Google Maps SDK for iOS

iOS 8.x 기기로 디버깅 시에 다운이 발생합니다. 어떻게 해야 하나요?

iOS 8.x가 실행되는 기기로 디버깅 시에 문제가 발생하면, 다음 단계에 따라 실행 중인 XCode 구성표에서 GPU 프레임 캡처를 비활성화합니다.

  1. XCode에서 Product, Scheme, Manage Schemes를 선택합니다.
  2. 구성표를 선택하고 Edit...를 선택합니다.

  3. GPU Frame Capture 옵션을 Disabled로 설정합니다. 참고로, 일부 기기에는 이 옵션이 없을 수도 있습니다.

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