Google Maps 사용 보고서

이 페이지는 2016년 1월에 사용 가능해진 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 사용 보고서 도구는 Google Maps APIs의 애플리케이션 사용량과 Maps API 크레딧 사용량을 추적하도록 도와줍니다. 이 도구를 사용하면 Google Maps API 프리미엄 플랜에 포함된 모든 API에 대한 상세한 일일 및 월간 보고서를 확인할 수 있습니다. 보고서 데이터는 클라이언트 ID나 프로젝트 ID를 포함하는 API 요청에 제공됩니다.

참고: 사용 보고서 도구는 Google이 결제 용도로 애플리케이션 사용량을 확인하는 데 사용하는 것과 같은 정보를 제공합니다.

보고서 유형

성공한 요청 보고서

이 보고서는 각 API에 대해 애플리케이션의 일일 또는 월간 요청 합계를 보여줍니다. 이 보고서를 사용하여 다양한 시기의 사용량을 비교하고 추세와 최대 사용 시간을 확인할 수 있습니다. 또한, 성공한 요청 보고서에서 다음 데이터를 확인할 수 있습니다.

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

Maps API 크레딧 보고서

이 보고서는 모든 API에 대한 일일 또는 월간 애플리케이션 크레딧 소모량 합계를 보여줍니다. 이 보고서를 사용하여 크레딧을 얼마나 구매할지 결정할 수 있습니다. 애플리케이션의 크레딧 소모 방식에 대한 자세한 내용은 사용 요금 및 제한을 참조하세요.

보고서 기능

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

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

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;">

사용 보고서 액세스

Google Maps 사용 보고서 액세스:

  1. Google Cloud Support Portal에 로그인합니다.
  2. 왼쪽 패널에서 Maps: Usage Report를 클릭합니다.

보고서 생성

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

필터 설명
클라이언트 ID
여러 클라이언트 ID가 있을 때만 사용 가능합니다. 보고서를 보려면 클라이언트 ID를 선택합니다.
채널 ID
성공한 요청 보고서에만 제공됩니다. 사용 데이터를 보려는 채널을 선택합니다. 또는 모든 채널의 사용 데이터를 보려면 Show all을 선택합니다.
발신/수신 보고서에서 최대 1년까지 날짜 범위를 선택합니다. Update를 클릭하여 새 보고서를 생성합니다.
보고서 유형
Successful Requests 또는 Maps APIs Credits 보고서를 선택합니다.
시 세분성 선택 Monthly 또는 Daily 보고서를 선택합니다. 월간 보고서에는 일일 보고서 링크가 포함되어 있습니다. 일일 보고서는 성공/실패한 요청과 오류 코드가 모두 표시됩니다.
API 유형 일일 보고서에만 제공됩니다. 보고서를 확인하려는 API를 선택합니다.

자주 묻는 질문(FAQ)

성공한 요청 보고서

사용 데이터가 보고서에 나타나려면 얼마나 걸리나요?

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

Google Maps JavaScript API 지도 로드는 무엇인가요? 페이지 뷰와는 어떤 차이가 있나요?

Google Maps API 프리미엄 플랜에서 Google Maps JavaScript API 사용량은 지도 로드에 따라 결정됩니다. 즉, 지도가 실제로 페이지에 표시되었을 때입니다. 지도 로드는 페이지 뷰와는 다릅니다. 페이지 뷰는 Maps API for Business 또는 Maps APIs for Work 라이선스로 Maps JavaScript API 사용량을 계산하는 데 사용되었습니다. 자세한 내용은 사용 요금 및 제한 사항을 참조하세요.

지도 로드 횟수가 웹 서버 액세스 통계와 일치하지 않나요?

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

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

Google Maps Distance Matrix API 보고서는 요청이 아니라 요소 개수(출발지-도착지 쌍)를 표시합니다. 요소에 대한 자세한 내용은 개발자 가이드를 참조하세요.

요청 오류

제 애플리케이션의 요청 오류는 어떻게 보나요?

성공한 요청 일일 보고서를 생성한 다음 API type 목록에서 API를 선택합니다. 애플리케이션의 성공한/실패한 요청 개수가 있는 그래프와 표를 볼 수 있습니다. 애플리케이션이 클라이언트 ID를 사용하여 액세스하는 웹 서비스 API는 해당 요청이 반환한 상태 코드도 확인할 수 있습니다.

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

사용 보고서 도구는 애플리케이션이 클라이언트 ID를 사용하여 액세스하는 Web Service API의 상태 코드를 보여줍니다. 각 API 개발자 가이드에서 코드에 대한 설명을 찾을 수 있습니다.

Geolocation API, Places API 및 Roads API는 언제나 API 키가 필요합니다. 이 API 및 키를 사용하여 애플리케이션에서 액세스하는 다른 API의 경우, 개발자 콘솔에서 상태 코드를 확인하세요.

오류가 Maps API 크레딧을 소모하나요?

아니요. 오류를 수신한 요청은 크레딧을 소모하지 않습니다. 그러나 OK 또는 ZERO_RESULTS 코드를 수신한 요청은 크레딧을 소모합니다.

채널 데이터:

채널은 무엇인가요?

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

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

채널을 지원하는 API는 무엇인가요?

채널 보고서는Maps JavaScript API, Static Maps API, Street View Image API 및Google Maps APIs 웹 서비스를 사용하는 애플리케이션에 제공됩니다. 채널은 Geolocation API, Places API, Roads API 및 Maps Mobile SDK에는 제공되지 않습니다.

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

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

애플리케이션 요청에 채널을 어떻게 설정하나요?

요청의 channel 값이 다음 요구사항을 준수하는지 확인하세요.

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

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

클라이언트측 API

script 태그의 src 값에 channel 매개변수를 추가합니다.

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

정적 지도 및 스트리트 뷰 API

요청 URL에 channel 매개변수를 포함합니다.

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에 channel 매개변수를 포함합니다.

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

Maps API 크레딧 보고서

Maps API 크레딧은 무엇인가요?

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

크레딧 데이터가 보고서에 나타나려면 얼마나 걸리나요?

Google Maps 사용 보고서의 크레딧 데이터는 처리가 필요하므로 보고서에 나타나기까지 최대 3일이 소요될 수 있습니다.