Google Maps APIs for Work 사용 대시보드

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

개요

Google Maps APIs for Work 사용 대시보드는 Maps APIs for Work 애플리케이션의 사용량과 상태를 모니터링하는 데 유용한 상세 보고서를 제공합니다. 보고서 데이터는 클라이언트 ID를 사용하는 모든 요청에 대해 제공됩니다.

사용 대시보드에서 애플리케이션에 대한 다음 내용을 신속하고 쉽게 확인할 수 있습니다.

  • 페이지 뷰, 클라이언트 서비스 및 웹 서비스 사용량
  • 웹 서비스의 초당 쿼리(QPS) 사용량
  • 도메인별 페이지 뷰 및 웹 서비스 사용량
  • 웹 서비스의 요청 성공률 및 오류

과거 연도의 아무 시기에나 보고서를 생성하고 파일을 내보내서 자세한 분석과 공유가 가능합니다. 모든 보고서는 동일한 Maps APIs for Work 클라이언트 ID를 사용하는 하나 이상의 애플리케이션 데이터를 보여줍니다.

보고서의 장점

Google Maps APIs for Work 사용 대시보드 에서 제공하는 보고서는 애플리케이션 개발, 마케팅, 구매 시에 유용합니다. 예를 들어 다음과 같이 보고서를 활용합니다.

  • 다양한 시기의 사용량을 비교하고 추세와 최고 사용 시간을 확인합니다.
  • 구매해야 할 페이지 뷰와 QPS 수량을 결정합니다.
  • 도메인 전체의 페이지 뷰 또는 클라이언트측 서비스 요청을 확인하고 브랜드별 사용, 표적 대상 및 기타 요소를 비교합니다.
  • 애플리케이션이 제대로 동작하는지 확인하고 문제를 해결합니다.

보고서에 포함된 항목

데이터 클라이언트/웹 API/서비스 포함
페이지 뷰 클라이언트 JavaScript, Static Maps, 스트리트 뷰
도메인별 페이지 뷰 클라이언트 JavaScript, Static Maps, 스트리트 뷰
서비스 요청 클라이언트 지오코딩, 길찾기, 고도
서비스 요청 지오코딩, 길찾기, 거리 행렬, 고도, 시간대
도메인별 서비스 요청 클라이언트 지오코딩, 길찾기, 고도
초당 쿼리(QPS) 지오코딩, 길찾기, 거리 행렬, 고도, 시간대
서비스 요청 성공률 지오코딩, 길찾기, 고도, 시간대
서비스 요청 오류 지오코딩, 길찾기, 거리 행렬, 고도, 시간대

참고: 사용 대시보드는 Google Places API, Google Maps Geolocation API, Google Maps Roads API 및 Google Maps Mobile SDK for Work 보고서를 포함하지 않습니다.

사용 대시보드 로그인

최초 로그인

처음으로 사용 대시보드에 로그인하기 전에 사용 대시보드의 Google 계정 링크가 필요합니다. Google 계정이 없다면 이 문서에서 계정을 생성하는 방법을 참조하세요.

  1. Google Cloud Support Portal에 로그인합니다.
  2. 왼쪽 패널에서 Maps: Usage Report를 클릭합니다.
  3. Access the new Usage Dashboard를 선택합니다.
  4. 안내에 따라 Google 계정을 선택합니다. 필요하면 계정에 로그인합니다.
  5. 사용 대시보드가 Google 계정에 액세스할 권한을 요청하는 메시지에서 Approve를 클릭합니다. 이를 승인하면 Google 계정을 Support Portal 계정에 연결합니다.

이제 사용 대시보드가 보일 것입니다.

참고: 사용 대시보드에 액세스할 수 없다면 지원에 문의하세요.

최초 설정 후 로그인

Google 계정을 사용 대시보드에 연결한 후 다음 링크에서 사용 대시보드에 직접 액세스할 수 있습니다.

https://maps-dashboard.appspot.com

Google 계정에 아직 로그인하지 않았다면 사용 대시보드에 연결한 계정으로 로그인합니다.

보고서 사용

보고서 그래프 보기

Google Maps APIs for Work 사용 대시보드는 시간에 따른 사용 추세를 시각화하는 데 도움을 주는 그래프 보고서를 제공합니다. 보고서에서 각 API의 데이터를 보려면 마우스 포인터를 그래프 위로 가져갑니다. 예:

보고서의 날짜 범위 변경

보고서의 기본 날짜 범위는 7일이지만 지난 해에 대해서는 날짜 범위를 직접 지정하여 쉽게 사용자 지정 보고서를 생성할 수 있습니다. (그러나 Dashboard 탭의 보고서는 날짜 범위가 고정되어 있습니다.)

참고: Web Services 탭에서 드릴다운하고 3일 이하로 날짜 범위를 선택하면 애플리케이션 요청 성공률 데이터를 시간 단위로 확인할 수 있습니다.

날짜 범위 변경:

  1. Page Views, Client Services 또는 Web Services 탭에서 Calendar 아이콘Calendar 아이콘 이미지을 클릭합니다.
  2. 날짜 필드를 클릭하여 시작 및 종료 날짜를 선택합니다.
  3. 체크 표시 버튼체크 표시 버튼 이미지을 클릭합니다.

새 날짜 범위는 Dashboard 탭을 제외한 모든 탭의 데이터에 적용됩니다.

참고: 사용 대시보드에 표시되는 모든 날짜 한정 타임스탬프(시간을 표시하지 않은 날짜)는 태평양 시간대로 표시됩니다. 짧은 날짜 범위를 선택했을 때 Web Services 탭에 표시되는 더욱 정확한 타임스탬프(시간, 분 또는 초 단위)는 현지 시간대에 따라 표시됩니다.

보고서 데이터 내보내기 및 분석

다른 도구에서 보고서 데이터를 분석하거나 다른 사람과 공유하려면 Page Views, Client ServicesWeb Services 탭의 데이터를 CSV(쉼표로 구분된 값) 파일로 내보낼 수 있습니다.

예를 들어 스프레드시트 프로그램(예: Google 스프레드시트), 분석 도구 플랫폼 또는 비즈니스 인텔리전스 도구에서 데이터 파일을 열어서 추세를 분석하고 전체 웹사이트 트래픽으로 사용량을 비교하고 향후 사용량을 추정하는 등의 분석을 수행합니다.

데이터를 내보내려면:

  1. 선택적으로 보고서의 날짜 범위를 변경합니다.
  2. 보고서 패널의 왼쪽 아래 모서리에서 CSV 다운로드 버튼 이미지을 클릭합니다.
  3. 파일을 저장합니다.

페이지 뷰 보고서

연간 및 월간 데이터 스냅샷 보기

Dashboard 탭의 Page View Consumption 패널에 다음과 같은 애플리케이션 관련 항목이 표시됩니다.

  • 지난 해 페이지 뷰 합계
  • 월평균 페이지 뷰
  • 일일 평균 페이지 뷰

팁: 향후 12개월간 구매해야 할 페이지 뷰를 계산하려면 월평균 실행률에 12를 곱합니다.

Total Request 패널에서 지난 30일간의 애플리케이션 페이지 뷰 사용량 그래프가 보일 것입니다.

페이지 뷰 사용량 세부정보 보기

Page Views 탭을 클릭합니다. Total Requests 패널에는 선택한 날짜 범위에서 각 날짜에 대한 페이지 뷰 요청 합계가 표시됩니다. 오른쪽 패널에서 그래프에 데이터가 보일 것입니다. 선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

도메인별 페이지 뷰 사용량 보기

Page Views 탭을 클릭합니다. By Authorized Domain 패널에 선택한 날짜 범위에서 각 도메인과 API에 대한 페이지 뷰 요청 합계가 표시됩니다. 애플리케이션 요청에 대해 channel 매개변수를 지정했다면 도메인과 채널별로 분석한 사용량 데이터를 볼 수 있습니다.

참고: 보고서는 데이터를 요청한 특정 클라이언트 ID에 대해 Google Cloud Support Portal에 등록된 모든 Google Maps APIs도메인을 표시합니다.

선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

클라이언트 서비스 보고서

클라이언트측 사용량 합계 보기

Client Services 탭을 클릭합니다. Client-Side Services Usage 패널은 선택한 날짜 범위의 각 데이터에 대해 애플리케이션의 JavaScript 구현에 따른 요청 합계를 표시합니다. 오른쪽 패널에서 그래프에 데이터가 보일 것입니다.

선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

도메인별 클라이언트측 사용량 보기

Client Services 탭을 클릭합니다. By Authorized Domain 패널에 선택한 날짜 범위에서 각 도메인의 클라이언트측 서비스 요청이 표시됩니다. 애플리케이션 요청에 대해 channel 매개변수를 지정했다면 도메인과 채널별로 분석한 사용량을 볼 수 있습니다.

참고: 보고서는 특정 클라이언트 ID에 대해 Google Cloud Support Portal에 등록된 모든 도메인을 표시합니다.

선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

웹 서비스 보고서

초당 쿼리(QPS) 데이터 보기

Web Services 탭을 클릭합니다. Queries Per Second 패널에 선택한 날짜 범위에서 각 API에 대한 다음 데이터가 표시됩니다.

  • 애플리케이션이 사용한 평균 QPS
  • 애플리케이션이 사용한 최대 QPS
  • 애플리케이션이 99%의 시간 동안 사용하는 QPS

Distance Matrix API에 대한 보고서는 요청 대신 초당 요소 (출발지-도착지 쌍)를 표시합니다.

선택적으로 보고서 날짜 범위를 변경합니다.

팁: QPS 데이터를 사용하여 구매할 QPS를 결정합니다.

웹 서비스 사용량 세부정보 보기

Web Services 탭을 클릭합니다. Total Requests 패널에는 선택한 날짜 범위에서 각 날짜에 대한 웹 서비스 요청 합계가 표시됩니다. Distance Matrix API에 대한 보고서는 요청 대신 일일 요소 (출발지-도착지 쌍)를 표시합니다.

선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

참고: 오른쪽 패널은 애플리케이션 웹 서비스 요청의 성공률과 애플리케이션 요청이 수신한 오류를 표시합니다. 자세한 내용은 “애플리케이션 상태 보고서”를 참조하세요.

애플리케이션 상태 보고서

애플리케이션 상태 스냅샷 얻기

Dashboard 탭의 Application Status 패널에서 지난 이틀간의 애플리케이션 성능 스냅샷을 확인할 수 있습니다. 다음 아이콘은 Google Maps APIs 데이터에 대한 애플리케이션 웹 서비스 요청의 성공률을 나타냅니다.

아이콘 설명

우수: 요청의 95% 이상이 성공.

경고: 요청의 80-94%가 성공.

알림: 요청의 80% 미만이 성공.

요청 없음: 애플리케이션이 이 API를 사용하지 않았습니다.

자세한 정보를 보려면 API에 마우스 포인터를 가져가세요.

웹 서비스 요청의 성공률 확인

Web Services 탭을 클릭합니다. % Request Success 패널의 그래프는 선택한 날짜 범위에서 애플리케이션 웹 서비스 요청의 성공률을 표시합니다.

선택적으로 보고서의 날짜 범위를 변경하고 데이터를 내보내서 자세히 분석합니다.

웹 서비스 요청 오류 확인

Web Services 탭을 클릭합니다. % Request Success 패널의 그래프에서 선택한 날짜 범위에 대해 애플리케이션 웹 서비스 성공률이 100% 미만이라면 애플리케이션이 수신한 오류 코드를 모두 확인할 수 있습니다. 선택적으로 보고서 날짜 범위를 변경합니다. 분 단위 타임스탬프가 있는 시간별 데이터를 보려면 3일 이하의 날짜 범위를 선택합니다. 자세히 오류를 분석하고 문제를 해결하려면 데이터를 파일로 내보냅니다.

사용 대시보드는 Google Maps APIs 웹 서비스를 요청할 때 애플리케이션이 수신할 수 있는 다음의 오류 유형을 표시합니다. 해결 방법에 대해서는 개발자 사이트의 Google Maps APIs 웹 서비스 섹션을 참조하세요.

오류 코드 설명
OVER_DAILY_LIMIT 애플리케이션 요청이 일일 제한을 초과하였습니다. 이 오류가 발생하면 더 많은 사용량이 허용될 때까지 웹 서비스가 데이터 반환을 중단합니다.
OVER_QPS_LIMIT 웹 서비스의 애플리케이션 초당 쿼리(QPS)가 초당 제한을 초과했습니다. 이 오류가 발생하면더 많은 사용량이 허용될 때까지 웹 서비스가 데이터 반환을 중단합니다.
INVALID_SIGNATURE 애플리케이션 요청에 잘못된 디지털 서명이 있습니다. 서명과 서명 생성 방법에 대한 자세한 내용은 인증 및 승인 페이지의 디지털 서명 섹션을 참조하세요.
INVALID_REQUEST 웹 서비스가 애플리케이션 요청을 파싱하지 못했습니다. 일반적으로 이 오류는 요청에 정보가 누락되었을 때 발생합니다.
INTERNAL_ERROR 애플리케이션 요청을 처리하던 중 오류가 발생했지만 웹 서비스가 이유를 반환하지 않았습니다.

지원 및 피드백

기술 지원 받기

Google Maps APIs for Work 사용 대시보드에 대한 도움이 필요하다면 Google Cloud Support Portal에서 케이스를 작성할 수 있습니다.

  1. Google Cloud Support Portal에 로그인합니다.
    참고: 로그인 자격 증명이 없으면 포털에 액세스를 요청할 수 있습니다.
  2. Cases 탭을 클릭합니다.
  3. Create New Case를 클릭합니다.
  4. 제품 이름의 경우 My product isn’t listed를 클릭합니다. 그런 다음 드롭다운 목록에서 Google Maps를 선택합니다.
  5. 그룹과 케이스 구성 요소의 경우 Other를 선택합니다.
  6. 우선순위 지정에 따라 우선순위를 설정합니다.
  7. 설명에 문제 요약 및 문제 재현 방법이 포함됩니다. 문제가 Google Maps APIs for Work 사용 대시보드와 관련된 것인지 확인합니다.

피드백 제공

Google Maps APIs for Work 사용 대시보드에 대해 기능을 제안하거나 문제를 보고하거나 다른 피드백을 제공할 수 있습니다. 개인적 답변은 불가능하지만 피드백을 사용하여 사용 대시보드 경험을 개선할 것입니다.

  1. Dashboard 탭 오른쪽 아래 모서리에서 Send Feedback 버튼Feedback 버튼 이미지을 클릭합니다.
  2. 화면상의 지시를 따릅니다.