프리미엄 요금제 사용량 보고서

참고: Google Maps Platform 프리미엄 요금제는 신규 가입이 불가능하며 신규 고객에게 제공되지 않습니다.

이 페이지는 2016년 1월에 출시된 새로운 Google Maps Platform 프리미엄 요금제 버전을 보유한 고객만을 위한 페이지입니다.

프리미엄 요금제 또는 이전 라이선스를 이용하고 있나요?
어느 라이선스가 있는지 확인하려면 다음 단계를 따르세요.
> Google Cloud 지원 포털에서 왼쪽의 지도: 사용량 보고서를 클릭합니다.
> 보고서 상단의 ID가 다음과 같은 형식인가요?
   gme-[company] & proj-[number] ([type])
이러한 형식이면 프리미엄 요금제를 이용하고 있는 것입니다.
그렇지 않으면 이전 라이선스(Maps APIs for Work 또는 Maps API for Business)를 보유하고 있는 것입니다.

개요

프리미엄 요금제 고객은 Google 지도 사용량 보고서 도구를 사용하여 애플리케이션의 Google Maps Platform 사용량 및 지도 API 크레딧 사용량을 추적할 수 있습니다. 이 도구를 사용하면 Google Maps Platform 프리미엄 요금제에 포함된 모든 API에 대한 자세한 일일 및 월간 보고서를 확인할 수 있습니다. 보고서 데이터는 클라이언트 ID나 프로젝트 ID가 포함된 API 요청에 대해 제공됩니다.

참고: 사용량 보고서 도구는 Google에서 청구 목적으로 애플리케이션의 사용량을 확인하는 데 사용하는 것과 동일한 정보를 제공합니다.

보고서 유형

성공한 요청 보고서

이 보고서에는 각 API에 대한 애플리케이션의 일일 또는 월간 총 요청이 표시됩니다. 성공한 요청 보고서를 사용하면 여러 기간의 사용량을 비교하고 추세와 최대 사용 시간을 확인할 수 있습니다. 또한 다음과 같은 데이터도 확인할 수 있습니다.

  • 요청 오류: 각 API에 대한 일일 보고서에는 성공한 요청 수와 실패한 요청(오류) 수도 표시됩니다. 애플리케이션에서 클라이언트 ID를 사용하여 액세스하는 웹 서비스 API의 경우에는 보고서에 문제 해결에 유용한 오류 코드도 표시됩니다.
  • 채널 데이터: 요청에 채널 매개변수를 포함하면 동일한 클라이언트 ID를 사용하는 여러 애플리케이션(예: 외부 액세스 및 내부 액세스)에서 애플리케이션 API 요청의 분석을 보여주는 성공한 요청 보고서를 생성할 수 있습니다. 채널을 사용하면 애플리케이션 사용 방식에 관한 더 자세한 데이터가 포함된 보고서를 생성할 수 있습니다.

지도 API 크레딧 보고서

이 보고서에는 모든 API에 대한 애플리케이션의 일일 또는 월간 총 크레딧 사용량이 표시됩니다. 지도 API 크레딧 보고서를 사용하여 크레딧을 얼마나 구매해야 할지 결정할 수 있습니다. 애플리케이션에서 크레딧을 사용하는 방법에 대한 자세한 내용은 사용 요금 및 한도를 참고하세요.

보고서 특징

  • 읽기 쉬운 그래프: 일일 보고서는 시간 경과에 따른 사용량 추세를 시각화한 그래프를 제공합니다. 그래프 위로 마우스 포인터를 가져가면 보고서 세부정보를 확인할 수 있습니다.

  • 이전 데이터: 지난 1년 이내의 원하는 기간에 대한 보고서를 볼 수 있습니다.
  • 다운로드 가능한 데이터: 월간 요청 수 및 크레딧 합계를 CSV(쉼표로 구분된 값) 파일로 다운로드하여 스프레드시트 또는 비즈니스 인텔리전스 도구를 사용하여 추가 분석하거나 다른 사람과 데이터를 공유할 수 있습니다.
  • 데이터 드릴다운: 월간 보고서에서 월간 합계 또는 열 제목을 클릭하여 바로 일일 보고서에 액세스할 수 있습니다. 예를 들면 다음과 같습니다.

사용량 보고서 액세스

Google 지도 사용량 보고서에 액세스하려면 다음 단계를 따르세요.

  1. Google Cloud Support Portal에 로그인합니다.
  2. 왼쪽 패널에서 지도: 사용량 보고서를 클릭합니다.

보고서 생성

기본 보고서는 지난 12개월의 월간 성공한 요청 보고서입니다. 다른 보고서를 생성하려면 보고서 필터를 사용하세요.

필터 설명
클라이언트 ID
클라이언트 ID가 여러 개 있을 때만 사용할 수 있습니다. 보고서를 보려는 클라이언트 ID를 선택합니다.
채널 ID
성공한 요청 보고서에만 사용할 수 있습니다. 사용 데이터를 보려는 채널을 선택합니다. 모든 채널의 사용 데이터를 보려면 모두 표시를 선택합니다.
시작/종료 보고서의 기간(최대 1년)을 선택합니다. 새 보고서를 생성하려면 업데이트를 클릭합니다.
보고서 유형
성공한 요청 또는 지도 API 크레딧 보고서를 선택합니다.
시간 세부사항 선택 월간 또는 일일 보고서를 선택합니다. 월간 보고서에는 일일 보고서 링크도 포함되어 있습니다. 일일 보고서에는 성공한 요청 및 실패한 요청과 오류 코드가 모두 표시됩니다.
API 유형 일일 보고서에만 사용할 수 있습니다. 보고서를 보려는 API를 선택합니다.

자주 묻는 질문(FAQ)

성공한 요청 보고서

사용 데이터가 보고서에 표시되는 데 얼마나 걸리나요?

보고서 데이터는 실시간으로 제공되지 않습니다. 클라이언트 ID를 사용하는 요청의 사용 데이터는 매일 처리됩니다. 보고서 날짜는 태평양 표준시를 기준으로 하므로 최대 이틀 정도 지연될 수 있습니다. API 키를 사용하는 요청의 데이터는 추가 처리가 필요하므로 보고서에 표시되기까지 최대 4일이 걸릴 수 있습니다.

Maps JavaScript API 지도 로드란 무엇인가요? 페이지 조회와 다른 점은 무엇인가요?

Google Maps Platform 프리미엄 요금제를 이용하는 경우 Maps JavaScript API 사용량은 지도가 실제로 페이지에 표시되는 지도 로드에 따라 결정됩니다. 지도 로드는 이전 Maps API for Business 또는 Maps API for Work 라이선스를 사용하여 Maps JavaScript API 사용량을 계산하는 데 사용된 페이지 조회와 다릅니다. 자세한 내용은 사용 요금 및 한도를 참고하세요.

지도 로드 횟수가 웹 서버의 액세스 통계와 일치하지 않는 이유는 무엇인가요?

페이지의 지도 로드 횟수가 웹 서버의 로그에 있는 해당 URL의 조회수와 다른 이유는 다음과 같습니다.

  • 지도 사용량이 페이지마다 다를 수 있음: 페이지에 google.maps.Map 객체가 생성될 때마다 지도 로드가 생성됩니다. 지도 로드 보고서를 웹 서버의 액세스 통계와 비교하는 경우 각 웹페이지의 지도 사용량을 자세히 분석하여 일치하지 않는 원인을 찾아 보세요. 예를 들면 다음과 같습니다.
    • 페이지에 지도가 2개 이상 있어서 여러 지도 객체가 생성되었습니다.
    • 페이지에는 지도가 표시되지 않았는데 지도 객체가 생성되었습니다. 예를 들어 지도 객체가 숨겨진 HTML div 요소에 첨부된 경우 이러한 상황이 발생할 수 있습니다.
    • 사용자가 작업(예: 버튼 클릭)을 실행해야 페이지에 지도가 표시됩니다. 사용자가 해당 작업을 실행하지 않으면 지도 객체가 생성되지 않습니다.
    • 페이지에 지도가 없어서 지도 객체가 생성되지 않았습니다.
  • 시간대가 다름: 보고서는 태평양 시간대로 설정된 로그에서 파생됩니다. 태평양 시간대를 기준으로 한 서버 로그를 분석하여 현지 시간대로 로깅하여 발생하는 오프셋을 줄일 수 있습니다.
  • HTML이 캐시됨: 지도 로드가 캐시되지 않습니다. 사용자가 페이지를 새로고침하면 세션 토큰을 얻기 위해 새로고침한 페이지에 다른 지도 로드가 생성됩니다. 그러나 이 경우 브라우저가 캐시에서 HTML을 로드하여 지도 로드 횟수가 서버 로그의 조회수보다 많을 수도 있습니다.
Distance Matrix API의 경우 요청이 예상보다 많은 이유는 무엇인가요?

Distance Matrix API 보고서에는 요청 대신 요소(출발지-목적지 쌍) 수가 표시됩니다. 요소에 대한 자세한 내용은 개발자 가이드를 참고하세요.

요청 오류

애플리케이션의 요청 오류를 보려면 어떻게 해야 하나요?

성공한 요청 일일 보고서를 생성한 다음 API 유형 목록에서 API를 선택합니다. 애플리케이션의 성공한 요청 수와 실패한 요청 수를 보여주는 그래프와 표가 표시됩니다. 애플리케이션이 클라이언트 ID를 사용하여 액세스하는 웹 서비스 API의 경우 해당 요청에서 반환한 상태 코드도 표시됩니다.

상태 코드는 무엇을 의미하나요?

사용량 보고서 도구에는 애플리케이션이 클라이언트 ID를 사용하여 액세스하는 웹 서비스 API의 상태 코드가 표시됩니다. 각 API의 개발자 가이드에서 코드의 설명을 확인할 수 있습니다.

Geolocation API, Places API, Roads API에는 항상 API 키가 필요합니다. 이 API 및 애플리케이션에서 키를 사용하여 액세스하는 다른 API의 경우 Developers Console에서 상태 코드를 확인하세요.

오류가 지도 API의 크레딧을 사용하나요?

아니요. 오류 코드를 수신하는 요청은 크레딧을 사용하지 않습니다. 하지만 OK 또는 ZERO_RESULTS 코드를 수신하는 요청은 크레딧을 사용합니다.

채널 데이터

채널이란 무엇인가요?

동일한 클라이언트 ID 또는 API 키를 사용하는 여러 애플리케이션의 사용량을 추적하는 데 API 요청과 함께 channel 매개변수를 사용할 수 있습니다. 애플리케이션의 여러 측면에 대해 다른 channel 값을 지정하면 애플리케이션이 사용되는 방법을 정확히 파악할 수 있습니다.

예를 들어 외부 웹사이트에서는 customer로 설정된 channel을 사용하여 API에 액세스할 수 있지만 내부 마케팅 부서에서는 mkting으로 설정된 channel을 사용할 수도 있습니다. 보고서에서는 이 채널 값을 기준으로 API의 사용량을 분석합니다.

어느 API에서 채널을 지원하나요?

Maps JavaScript API, Maps Static API, Street View Static API, Google Maps Platform 웹 서비스를 사용하는 애플리케이션에서 채널 보고서를 이용할 수 있습니다. Geolocation API, Places API, Roads API, 지도 모바일 SDK에는 채널을 사용할 수 없습니다.

몇 개의 채널을 사용할 수 있나요?

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

애플리케이션 요청에 대한 채널을 설정하려면 어떻게 해야 하나요?

요청의 channel 값이 다음 요건을 충족하는지 확인합니다.

  • ASCII 영숫자 문자열이어야 합니다.
  • 밑줄(_) 및 하이픈(-) 문자를 포함할 수 있습니다.
  • 대소문자를 구분하지 않습니다. 대문자 및 대/소문자가 혼합된 channel 매개변수는 동일한 소문자로 이루어진 매개변수에 병합됩니다. 예를 들어 CUSTOMER 채널의 사용량은 customer 채널의 사용량에 통합됩니다.
  • 정적이어야 하고 애플리케이션 인스턴스별로 할당되어야 합니다(동적으로 생성될 수 없음). 예를 들어 개별 사용자를 추적하는 데 채널 값을 사용할 수 없습니다.

다음과 같이 요청에 채널 매개변수를 추가합니다.

클라이언트 측 API

스크립트 태그의 src 값에 채널 매개변수를 추가합니다.

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

Maps Static API 및 Street View Static API

요청 URL에 다음 채널 매개변수를 포함합니다.

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

웹 서비스

요청 URL에 다음 채널 매개변수를 포함합니다.

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

지도 API 크레딧 보고서

지도 API 크레딧이란 무엇인가요?

애플리케이션의 API 요청에서는 Google Maps Platform 프리미엄 요금제로 구매한 크레딧 풀의 지도 API 크레딧을 사용합니다. 크레딧 및 애플리케이션의 크레딧 사용 방법에 대한 자세한 내용은 사용 요금 및 한도를 참고하세요.

크레딧 데이터가 보고서에 표시되는 데 얼마나 걸리나요?

Google 지도 사용량 보고서의 크레딧 사용 데이터는 처리가 필요하므로 보고서에 표시되기까지 최대 3일이 걸릴 수 있습니다.