할당량 및 보고

이 페이지는 이전 Maps APIs for Work 또는 Maps API for Business 라이선스가 있는 고객만을 위한 것입니다. 이 페이지는 2016년 1월에 출시된 새 Google Maps API 프리미엄 플랜가 있는 고객에게는 적용되지 않습니다.

할당량

Google Maps APIs for Work 스위트의 클라이언트측 API는 구매한 할당량에 대해 페이지 뷰를 적용합니다. 페이지 뷰 정의:

  • Google Maps JavaScript API의 단일 페이지 로드.
  • Google Street View Image API 이미지 또는 Google Static Maps API 이미지에 대한 단일 요청.
  • Google Earth API의 단일 페이지 로드.

패닝, 확대/축소 또는 지도 유형 변경과 같은 지도와의 사용자 상호작용은 추가 페이지 뷰를 생성하지 않습니다.

API를 지도 표시에 사용하지 않더라도 API가 페이지에 로드되면 페이지 뷰가 생성됩니다. 페이지 템플릿에 API를 로드하는 <script> 태그를 포함하고 선택적 사용자 액티비티에 응답할 때만 지도를 표시하는 페이지에 API를 비동기적으로 로드하는 것이 좋습니다.

구매한 할당량을 모두 사용한 경우 즉시 라이선스를 갱신해야 합니다.

보고

사용량 통계는 두 가지 방법으로 분석할 수 있습니다.

  • 결제와 관련되어 있으므로 Google Maps APIs for Work 사용량에 대한 자세한 내용을 확인하려면 Maps: Usage Report 탭 (Google Cloud Support Portal)에서 제공하는 보고서에 액세스합니다.

  • 고객이 Google Maps JavaScript API 애플리케이션과 어떻게 상호작용하는지 알아보려면 Analytics for Google Maps APIs for Work를 활성화합니다.

사용 보고서

Google Cloud Support Portal는 Google Maps JavaScript API와 Google Maps 이미지 API에 대한 자세한 보고서를 제공합니다.

포털에 로그인하면 왼쪽 내비게이션 패널에서 Maps: Usage Report를 클릭합니다. 채널과 날짜 범위 기준으로 필터링할 수 있습니다.

이 보고서의 데이터는 Google이 사용 기반 결제를 확인할 때 사용하는 데이터와 같습니다.

채널 보고서

동일한 클라이언트 ID를 사용하여 여러 가지 애플리케이션의 사용량을 추적하려면 요청과 함께 선택적 channel 매개변수를 제공할 수 있습니다. 애플리케이션의 여러 가지 측면에서 서로 다른 channel 값을 지정하면 애플리케이션이 어떻게 사용되는지 정확히 알 수 있습니다.

예를 들어 외부에 제공되는 웹사이트는 channelcustomer로 설정하여 API에 액세스할 수 있지만 내부 마케팅 부서는 channelmkting으로 설정하여 사용할 수 있습니다. 보고서에서는 이러한 channel 값을 기준으로 사용 내역을 분석합니다.

채널 보고서는 Google Maps JavaScript API, 이미지 API 또는 Google Maps APIs 웹 서비스를 사용하는 애플리케이션에 제공됩니다.

channel 매개변수는 다음 형식을 사용합니다.

  • ASCII 영숫자 문자열이어야 합니다.
  • Period (.), underscore (_) and hyphen (-) 문자는 허용됩니다.
  • channel 매개변수는 대/소문자를 구분합니다. 대문자, 대/소문자 혼합, 소문자로 된 channel 매개변수는 소문자 매개변수에 병합됩니다. 예를 들어 CUSTOMER 채널의 사용량은 customer 채널의 사용량과 통합됩니다.
  • channel 값은 애플리케이션 인스턴스마다 할당된 고정 값이어야 하고 동적으로 생성되어서는 안 됩니다. 개별 사용자를 추적하는 데는 channel 값을 사용하지 않습니다.

클라이언트 ID당 최대 2,000개의 채널을 사용할 수 있습니다.

channel 매개변수는 다음 스크립트 태그의 src 값에 추가됩니다.

<script src="https://maps.googleapis.com/maps/api/js?v=3&client=gme-yourclientid&channel=YOUR_CHANNEL"></script>

Analytics for Google Maps APIs for Work

Analytics for Google Maps APIs for Work를 사용하면 사람들이 지도와 어떻게 상호작용하는지 확인하고 실시간 사용 통계에 기초하여 애플리케이션을 개선할 수 있습니다. Analytics for Google Maps APIs for Work는 다음과 같은 질문에 답합니다.

  1. 가장 일반적으로 사용하는 확대/축소 수준과 지도 유형은 무엇입니까?
  2. 어느 국가의 사용자가 지오코딩 결과를 요청합니까?
  3. JavaScript 사용 빈도는 어느 정도입니까?

Analytics는 코드를 변경하지 않고도 활성화할 수 있으며 사용자의 개인정보를 보호하기 위해 모든 데이터를 집계하여 익명으로 처리합니다. Google Maps JavaScript API 및 관련 서비스에 보고서가 제공됩니다.

이 *Zoom Interactions* 보고서는 이 클라이언트 ID와 연결된
사이트에서 대부분 사용자가 확대/축소 수준 4~7을
사용한다는 것을 나타냅니다.

Analytics 액세스

Google Cloud Support Portal를 방문하고 Resources 목록에서 Maps: Analytics를 선택합니다. 계정과 연결된 클라이언트 ID가 여러 개 있다면 Analytics에 액세스할 때 사용할 클라이언트 ID와 채널을 선택하라는 메시지가 나올 것입니다.

클라이언트 ID에 대해 Analytics 활성화

Analytics는 기본적으로 비활성화되어 있으며 클라이언트 ID별로 활성화해야 합니다. 각 클라이언트 ID의 보고서에 처음 액세스를 시도할 때 Analytics를 활성화하기를 원하는지 묻는 메시지가 나타날 것입니다. 이 과정을 완료하고 Analytics가 데이터 기록을 시작하기까지 최대 5분이 걸릴 수 있습니다.

채널 기능을 활용하고자 하는데 현재 JavaScript 라이브러리 로딩 시 채널을 지정하지 않았을 경우 외에는 기존 코드를 수정할 필요가 없습니다.