자주 묻는 질문(FAQ)

이 FAQ에서는 Google Maps API 프리미엄 플랜에 관련된 질문만을 다룹니다.

모든 Google Maps APIs에 공통된 질문에 대해서는 Google Maps APIs FAQ를 참조하세요.

시작하기

이전 Google Maps APIs for Work 라이선스 및 갱신

Google Maps API 프리미엄 플랜 구매

사용 제한

애플리케이션 개발

KML

URL 서명

스타일 지정

시작하기

Google Maps API 프리미엄 플랜란 무엇인가요?

Google Maps API 프리미엄 플랜(프리미엄 플랜)에서는 여러분이 앱과 사이트에 필요한 지도를 구현할 수 있도록 모든 도구를 제공합니다. 이 지도는 사용자 지정과 확장이 가능하고 모바일을 지원합니다.

어떤 API가 Google Maps API 프리미엄 플랜에 포함됩니까?

다음과 같은 Google 제품이 Google Maps API 프리미엄 플랜에 포함됩니다. 다음 제품을 사용하는 애플리케이션은 Google Maps API 프리미엄 플랜 SLA에 포함되며 기술 지원을 받을 수 있습니다.

* Google Places API는 프리미엄 플랜 자산 추적 라이선스에 포함되지 않습니다. 자산 추적 라이선스를 보유한 경우 Places API를 사용하려면 Google Maps 판매팀에 문의하세요.

다음 API는 Google Maps API 프리미엄 플랜에 포함되지 않습니다. 다음 API를 사용하는 애플리케이션은 해당 API에 게시된 서비스 약관을 준수해야 하며, Google Maps API 프리미엄 플랜 SLA에 포함되지 않거나 기술 지원을 받을 수 없습니다.

Google Maps API 프리미엄 플랜의 기술 지원을 문의하려면 어떻게 하나요?

Google Maps API 프리미엄 플랜 고객은 Google Cloud Support Portal을 사용하여 다음 주소에서 Google 지원을 문의할 수 있습니다.

https://google.secure.force.com/

포털에 액세스하려면 사용자 이름과 암호가 필수입니다. 계정이 없으신 경우 이 양식을 작성해 주세요.

자세한 내용은 지원 및 리소스 가이드를 참조하세요.

Google Cloud Support Portal의 로그인 자격 증명을 재설정하려면 어떻게 하나요?

제 암호를 분실했습니다. 이 링크는 Google Cloud Support Portal 로그인 페이지에서도 사용이 가능합니다.

Google Maps API 프리미엄 플랜의 서비스 약관이란 무엇인가요?

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

이전 Google Maps APIs for Work 라이선스 및 갱신

이전 Google Maps APIs for Work 라이선스에 대한 정보는 어디에서 찾을 수 있나요?

이전 Maps APIs for Work 라이선스가 있는지 여부를 판별하려면: Google Cloud Support Portal에서 왼쪽의 Maps: Usage Report를 클릭합니다. 보고서 상단의 ID가 다음 형식이면, 새 프리미엄 플랜가 있는 것입니다:
gme-[company] & proj-[number] ([type]) 그렇지 않으면 이전 라이선스가 있는 것입니다. 자세한 내용은 Maps APIs for Work 라이선스 가이드를 참조하세요.

새로운 프리미엄 플랜에는 어떤 변경사항이 있나요?

갱신 고객의 변경사항 요약라이선스 갱신에 관한 FAQ를 참조하세요.

Google Maps API 프리미엄 플랜 구매

Google Maps API 프리미엄 플랜를 꼭 구매해야 하는 이유가 있나요?

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

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

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

Google Maps API 프리미엄 플랜에는 Google 계정이 필요한가요?

네, Google API Console에서 사용 가능한 Google Maps APIs에 액세스하려면 Google 계정이 필요합니다.

사용 제한

Google Maps API 프리미엄 플랜 사용량은 어떻게 계산되나요?

이전 Maps APIs for Work 또는 Maps API for Business 라이선스가 있나요? Maps APIs for Work 라이선스 가이드를 참조하세요. 이전 라이선스가 있는지 여부를 판별하려면: Google Cloud Support Portal에서 왼쪽의 Maps: Usage Report를 클릭합니다. 보고서 상단의 ID가 다음 형식이면, 새 프리미엄 플랜가 있는 것입니다:
gme-[company] & proj-[number] ([type])
그렇지 않으면 이전 라이선스가 있는 것입니다.

Google Maps API 프리미엄 플랜의 경우 애플리케이션은 어떤 API를 요청했는지에 따라 다른 비율로 할당량을 소모합니다. 여러분이 애플리케이션의 연간 사용량을 추정하여 할당량(Maps API 크레딧)을 일 년 이상 동안 구매합니다. 애플리케이션이 Maps API를 요청할 때마다 여러분이 구매한 크레딧에서 크레딧이 소모됩니다. 예를 들어, 애플리케이션이 Google Maps JavaScript API를 사용하여 지도를 표시하는 경우는 Maps JavaScript API 지도 로드용 크레딧을 소모합니다. 구입한 크레딧을 애플리케이션이 모두 소모한 경우에는 필요한 만큼 크레딧을 추가로 구입할 수 있습니다. 자세한 내용은 프리미엄 플랜사용 요금 및 제한 가이드를 참조하세요.

제 앱의 Google Maps API 프리미엄 플랜 사용량을 어떻게 추적하나요?

애플리케이션의 Maps API 크레딧 사용량을 추적하는 방법에 대한 자세한 내용과 기타 사용 보고서 및 분석에 대해서는 프리미엄 플랜 보고서 가이드를 참조하세요.

제 애플리케이션의 Maps API 크레딧 사용량을 어떻게 추정하나요?

Google Maps API 프리미엄 계산기를 사용하여 애플리케이션의 사용량을 추정할 수 있습니다.

또한 크레딧 계산 예시가 도움이 될 수도 있습니다.

제가 보유한 Maps API 크레딧이 소진되면 어떻게 되나요?

Maps API 크레딧이 소진되더라도 애플리케이션은 정상적으로 요청을 계속 수행하지만, 여러분 계정에 초과 요금이 부과될 수 있습니다. 이 경우 계정 일시 중단을 피하려면 Google Maps API 프리미엄 플랜 라이선스를 가능한 빨리 갱신해야 합니다. 할당량의 85%가 사용되면 Google이 여러분에게 이메일로 알려드립니다.

Google Places API 세부정보 요청의 경우 Maps API 크레딧이 2가 부과되는데 장소 자동완성 요청의 경우 크레딧이 0.1만 부과되는 이유는 무엇인가요?

Google Places API는 사업체 및 기타 장소 데이터의 방대한 데이터베이스를 사용합니다. 사업체들은 개업과 폐업이 빈번하므로, 이 데이터베이스를 정확하게 유지하기 위해서는 많은 시간과 노력이 들어갑니다. 따라서 장소 세부정보 요청에는 더 많은 비용이 부과됩니다. 장소 자동완성의 경우에는 사용자가 장소 검색을 위해 몇 글자만 입력하는 경우가 많으므로, 각 요청에 0.1 크레딧만 부과하는 것입니다.

애플리케이션 개발

저에게 Google API Console 프로젝트 ID와 클라이언트 ID가 모두 발급되나요?

네, 여러분이 받는 환영 편지에는 Google API Console 프로젝트 ID와 클라이언트 ID가 모두 포함됩니다.

저에게 제공된 Google API Console 프로젝트에서 모든 가용 API가 활성화되나요?

네, 프리미엄 플랜의 경우 저희는 동일한 Google API Console 프로젝트에 모든 API를 자동으로 제공합니다. 단일 프로젝트에 있는 모든 API에 액세스할 수 있습니다. 동일한 플랫폼(웹, 웹 서비스, Android 또는 iOS)상의 API는 동일한 API 키를 공유할 수 있습니다. API 키는 실시간 사용 보고서와 과거 사용량 데이터를 최대 30일까지 제공합니다. 30일 이후에도 Maps API 분석, 채널별 사용 보고서, 과거 보고서 데이터와 같은 기능이 필요한 경우, 대부분의 API에 대해 API 키 대신 클라이언트 ID를 사용할 수 있습니다. (클라이언트 ID는 Google Places API, Google Maps Geolocation API, Google Maps Roads API, Google Maps Android API 또는 Google Maps SDK for iOS에서 작동하지 않습니다.)

API 키와 클라이언트 ID의 차이점은 무엇인가요?

프로젝트 ID로는 Google API Console에서 API 키를 생성할 수 있습니다. 다음은 API 키와 클라이언트 ID의 주요 차이점입니다.

  • API 지원: API 키는 모든 Maps API와 사용이 가능합니다. 한편, 클라이언트 ID는 Google Places API, Google Maps Geolocation API, Google Maps Roads API, Google Maps Android API 및 Google Maps SDK for iOS를 제외한 모든 API와 사용이 가능합니다.
  • 보고: API 키는 실시간 사용 보고서와 과거 사용량 데이터를 최대 30일까지 제공합니다. 30일 이후에도 Maps API 분석, 채널별 사용 보고서, 과거 보고서 데이터와 같은 기능이 필요한 경우, 그 사용이 지원되는 API에 대해 클라이언트 ID를 사용하세요.
  • 오류 코드: API 키를 사용하는 경우 여러분은 HTTP 상태 코드 클래스에 따른 오류 메시지를 수신하며(예: 3xx 및 4xx 오류), 이 오류 메시지는 일반적인 정보만을 제공합니다. 클라이언트 ID를 사용하는 경우 여러분은 문제 해결에 도움이 되는 보다 상세한 API별 오류 코드를 Google Cloud Support Portal 보고서로 수신합니다.
  • 보안: 다음 가이드라인을 준수하신다면 API 키와 클라이언트 ID가 똑같이 안전합니다.
    • API 키를 사용하는 경우 이 키를 비밀로 유지하세요. Maps API에 대한 모든 요청은 HTTPS를 사용하므로, 누군가가 트래픽을 가로챌 위험이 제한됩니다. 그러나 누군가가 여러분의 키를 획득했다면 이 키를 사용하여 Maps API에 요청을 수행할 수 있습니다. 클라이언트측 API에서 이러한 위험을 예방하려면 키 사용이 가능한 도메인을 제한할 수 있습니다. 서버측 API의 경우에는 서버의 원본 IP 주소에서만 요청이 허용되도록 키를 제한하세요. 안전한 API 키 사용에 대한 자세한 내용은 콘솔 도움말 센터를 참조하세요.
    • 클라이언트 ID를 사용하는 경우, 디지털 서명 생성에 사용되는 암호화 키를 비밀로 유지하세요. 또한 절대로 암호화 키를 API 요청에 사용하지 마시고 JavaScript를 사용하여 URL에 서명하는 데 사용하지 마세요.
제 테스트 환경에서 제 Google Maps API 프리미엄 플랜 자격 증명을 사용해야 하나요?

모든 Google Maps APIs에는 API 키나 클라이언트 ID로 인증이 필요합니다. 테스트 환경에서 애플리케이션을 개발 중인 경우 다음 사항을 고려하세요.

  • 테스트 환경의 기술 지원에 액세스해야 하는 경우 프리미엄 플랜의 자격 증명(클라이언트 ID 또는 API 키)을 사용해야 합니다. 참고로, Maps API 사용 시에는 여러분 플랜의 사용 요금 및 제한에 따라 Maps API 크레딧을 소모합니다.
  • 테스트 환경에서 Maps API 크레딧이 소모되는 것을 원치 않으면, 표준 자격 증명(Google API Console에 설정된 API 키)을 사용할 수도 있지만, 이 경우에는 테스트 환경이 기술 지원을 받을 수 없습니다. 표준 자격 증명을 사용하기로 선택한 경우, 여러분의 앱이나 웹사이트에는 각 API의 표준 사용 제한이 적용됩니다. 표준 사용 제한에 대한 자세한 내용은 가격 및 플랜을 참조하세요.
  • 테스트 환경에서 상당한 볼륨이 발생할 것으로 예상되고 또한 테스트 환경의 기술 지원에 액세스하고 싶지만 프리미엄 플랜의 Maps API 크레딧은 소모하고 싶지 않다면, 개발 전용의 라이선스를 고려해 보세요. 이 라이선스는 비용이 저렴한 옵션이며 기술 지원을 제공합니다. 자세한 내용은 Google Maps 계정 관리자에게 문의하세요.
  • 앱에서 로드 테스트를 수행 중인 경우, 모의 API에 대해 이 테스트를 수행할 수 있습니다. 출시 전 검사 목록에서 앱에서 로드 테스트 수행을 참조하세요.
Google Maps API 프리미엄 플랜의 경우 Zagat 기능에 액세스하려면 어떻게 하나요?

프리미엄 플랜의 경우, API 키를 포함한 Google Places API Web Service 요청은 프리미엄 Zagat 콘텐츠를 반환합니다. Zagat 콘텐츠에 대한 액세스 권한이 있는지 확인하려면, 등록 중에 생성된 프로젝트의 키와 함께 Google Places API Web Service로 요청을 보내세요. 예시 URL:

https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants+in+mountain+View,+ca&key=YOUR_API_KEY
Google Maps API 프리미엄 플랜의 경우 프리미엄 모바일 기능에 액세스하려면 어떻게 하나요?

표준 API(Google Maps SDK for iOSGoogle Maps Android API)의 사용자에게 제공되는 동일한 SDK를 사용하여 프리미엄 모바일 기능에 액세스할 수 있습니다. 프리미엄 기능에 액세스하려면 등록 중에 생성된 프로젝트의 API 키를 사용해야 합니다. 프리미엄 모바일 기능에 대한 액세스 권한이 있는지 확인하려면, 정적 라이브러리를 사용하여 지도를 로드하세요. 자세한 내용은 AndroidiOS에서 프리미엄 플랜 시작 가이드를 참조하세요.

Android용 동적 라이브러리를 Google Maps API 프리미엄 플랜에 사용할 수 있나요?

네, 프리미엄 플랜에서는 또한 정적 라이브러리 대신 동적 라이브러리를 Google Maps Android API에 사용할 수 있습니다. 자세한 내용은 Android에서 프리미엄 플랜 시작 가이드를 참조하세요.

HTTPS(SSL)를 통해 로드되는 페이지로부터 Google Maps API 프리미엄 플랜 클라이언트 ID를 사용하여 Google Maps JavaScript API에 액세스하려면 어떻게 하나요?

HTTPS를 통해 로드되는 페이지로부터 Google Maps JavaScript API에 액세스하려면 API를 사용하려는 HTTPS URL을 먼저 인증해야 합니다.

Common Loader base_domain 매개변수를 사용할 때 HTTPS(SSL)를 통해 Google Maps JavaScript API를 로드하려면 어떻게 하나요?

base_domain 매개변수가 설정된 Common Loader를 사용할 때 SSL을 통해 Maps JavaScript API를 로드하는 것은 불가능합니다.

base_domain 매개변수는 애플리케이션의 성능에 영향을 미치지 않습니다. 어떤 도메인에서 API가 로드되는지에 상관없이, 특정 사용자의 위치에 대한 API 요청은 언제나 최적의 지도 서버에 의해 처리됩니다.

base_domain은 지오코딩 결과를 특정 지역으로 편중시킵니다. base_domain이 없이도 동일한 효과를 얻으려면 지오코딩 서비스의 region 매개변수를 설정하세요.

KML

인트라넷 사이트에 호스팅되는 KML 파일을 지도상에 렌더링하려면 어떻게 하나요?

KML 오버레이를 Google Maps JavaScript API에 생성하는 KmlLayer 클래스는 렌더링할 KML 파일을 검색하고 분석하기 위해 Google 호스팅 서비스를 사용합니다. 따라서 공개 액세스가 불가능한 URL에 호스팅된 KML 파일이나 액세스 인증이 요구되는 KML 파일은 표시될 수 없습니다.

인트라넷 사이트상에 호스팅된 KML 파일을 사용하는 애플리케이션을 개발하려는 경우, 타사 JavaScript 라이브러리를 사용하여 KML 파일을 클라이언트측에 렌더링하는 것이 좋습니다. KML 파일은 브라우저에 의해 분석되므로, KmlLayer 클래스를 사용할 때보다 성능이 더 저하될 수도 있습니다.

URL 서명

JavaScript를 사용하여 URL에 서명할 수 있나요?

암호화 키가 최종 사용자들에게 노출될 수 있으므로, JavaScript를 사용하여 URL에 서명하는 것은 권장하지 않습니다. 따라서 서버측 구성 요소에 의해서만 서명이 생성되어야 합니다.

저의 Maps API 웹 서비스 요청에 대해 HTTP 403 Forbidden 응답이 수신되는 이유가 무엇인가요?

HTTP 403 응답은 권한 문제를 나타내며, 아마도 이 요청의 서명을 확인할 수 없기 때문일 수 있습니다. 가능한 원인:

  1. 서명이 지정되었지만 이 요청에 올바르지 않습니다.
  2. 이 요청이 Google Maps API 프리미엄 플랜 클라이언트 ID는 지정하지만 서명은 지정하지 않으며, 호출 중인 웹 서비스의 요구사항에 따르면 클라이언트 ID로 수행된 모든 요청에는 올바른 서명이 포함되어야 합니다.
  3. 서명이 지정되었지만 연결된 Google Maps API 프리미엄 플랜 클라이언트 ID는 지정되지 않았습니다.

스타일 지정

제 지도에 사업체가 나타나지 않는 이유가 무엇인가요?

Google Maps JavaScript API를 사용하여 지도를 로드할 때 client 매개변수를 포함시키면, 지도상의 사업체 목록이 기본적으로 꺼집니다. 사업체 목록을 켜려면 스타일 지정 코드를 지도에 포함시켜야 합니다.

var styles = [
  {
    featureType: 'poi.business',
    stylers: [
      { visibility: 'on' }
    ]
  }
];

map.setOptions({styles: styles});