Google Maps APIs for Work Usage Dashboard

This page is only for customers with a previous Maps APIs for Work or Maps API for Business license. This page is not applicable to customers with the new Google Maps APIs Premium Plan, which became available in January 2016.

Overview

The Google Maps APIs for Work Usage Dashboard provides detailed reports that help you monitor the usage and health of your Maps APIs for Work application. Report data is available for all requests that use a client ID.

With the Usage Dashboard, you can quickly and easily see your application’s:

  • Page views, client services, and web services usage
  • Queries per second (QPS) usage for web services
  • Page views and web services usage by domain
  • Request success rate and errors for web services

You can create reports for any time period in the past year, and export the data to a file for further analysis and sharing. All reports show data for one or more applications that use the same Maps APIs for Work client ID.

Benefits of the reports

The reports available in the Google Maps APIs for Work Usage Dashboard are useful for purposes such as application development, marketing, and purchasing. For example, use the reports to:

  • Compare usage across different time periods to identify trends and peak usage times.
  • Determine how many page views and QPS to purchase.
  • See page views or client-side service requests across your domains to compare usage by brand, target audience, and other factors.
  • Check to see if your application is working properly and troubleshoot issues.

What’s included in the reports

Data Client/Web APIs/Services Included
Page views Client JavaScript, Static Maps, Street View
Page views by domain Client JavaScript, Static Maps, Street View
Service requests Client Geocoding, Directions, Elevation
Service requests Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Service requests by domain Client Geocoding, Directions, Elevation
Queries per second (QPS) Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Service request success rate Web Geocoding, Directions, Elevation, Time Zone
Service request errors Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone

Note: The Usage Dashboard does not include reports for the Places SDK, Geolocation API, Roads API, and Google Maps Mobile SDK for Work.

Sign in to the Usage Dashboard

Signing in for the first time

Before you can sign in to the Usage Dashboard for the first time, you’ll need to link your Google Account to the Usage Dashboard. If you don’t yet have a Google Account, see this article for instructions on creating one.

  1. Log in to the Google Cloud Support Portal.
  2. In the panel on the left, click Maps: Usage Report.
  3. Select Access the new Usage Dashboard.
  4. Follow the prompts to select a Google Account, signing in to one if needed.
  5. In the message asking for permission to let the Usage Dashboard access your Google Account, click Approve. This approval links your Google Account to your Support Portal account.

You’ll now see the Usage Dashboard.

Note: If you’re unable to access the Usage Dashboard, contact Support.

Signing in after initial setup

After you’ve linked your Google Account to the Usage Dashboard, you can access the Usage Dashboard directly at:

https://maps-dashboard.appspot.com

If you’re not already signed in to your Google Account, sign in with the account you linked to the Usage Dashboard.

Using the reports

Viewing report graphs

The Google Maps APIs for Work Usage Dashboard provides graphical reports to help you visualize usage trends over time. To view the data for each API in a report, just hover your mouse pointer over the graph. For example:

Changing the date range for reports

The default date range for reports is 7 days, but you can easily create custom reports for any date range within the past year. (Reports on the Dashboard tab, however, have fixed date ranges.)

Note: On the Web Services tab, you can drill down even further to see hourly data for your application’s request success rate, by selecting a date range of 3 days or fewer.

To change the date range:

  1. On the Page Views, Client Services, or Web Services tab, click the Calendar icon image of Calendar icon.
  2. Click in the date fields to select the starting and ending dates.
  3. Click the checkmark button image of checkmark button.

The new date range is applied to data on all tabs, except the Dashboard tab.

Note: All date-only timestamps (dates without an indication of the time of the day) displayed in the Usage Dashboard are expressed in the Pacific Time time zone. More precise timestamps (with hour, minute, or second precision) displayed in the Web Services tab when a short date range is choosen are expressed in your local time zone.

Exporting and analyzing report data

If you’d like to analyze report data in other tools or share it with others, you can export any of the data on the Page Views, Client Services, and Web Services tabs to a comma-separated values (CSV) file.

For example, you can open data files in a spreadsheet program (such as Google Sheets), an analytics platform, or a business intelligence tool to analyze trends, compare usage with overall website traffic, estimate future usage, and more.

To export data:

  1. Optionally, change the date range for the report.
  2. In the lower-left corner of a report panel, click image of CSV download button.
  3. Save the file.

Page view reports

View a snapshot of yearly and monthly data

On the Dashboard tab, the Page View Consumption panel shows your application’s:

  • Total page views for the past year
  • Average monthly page views
  • Average daily page views

Tip: To calculate how many page views you’ll likely need to purchase for the next 12 months, multiply the average monthly run rate by 12.

In the Total Request panel, you’ll see a graph of your application’s page view usage over the past 30 days.

View page view usage details

Click the Page Views tab. The Total Requests panel shows the total page view requests for each date in the date range selected. In the panel to the right, you’ll see the data on a graph. Optionally, change the date range for the report and export data for further analysis.

View page view usage by domain

Click the Page Views tab. The By Authorized Domain panel shows the total page view requests for each of your domains and for each API for the date range selected. If you’ve specified channel parameters for your application’s requests, you’ll see usage data broken down by both domain and channel.

Note: The report shows all domains registered in the Google Cloud Support Portal for a given client ID that requested Google Maps Platform Data.

Optionally, change the date range for the report and export data for further analysis.

Client services reports

View total client-side usage

Click the Client Services tab. For each date in the date range selected, the Client-Side Services Usage panel shows the total requests your application’s JavaScript implementation made. In the panel to the right, you’ll see the data on a graph.

Optionally, change the date range for the report and export data for further analysis.

View client-side usage by domain

Click the Client Services tab. The By Authorized Domain panel shows the client-side service requests for each of your domains, for the date range selected. If you’ve specified channel parameters for your application’s requests, you’ll see usage broken down by both domain and channel.

Note: The report shows all the domains registered in the Google Cloud Support Portal for a given client ID.

Optionally, change the date range for the report and export data for further analysis.

Web services reports

View queries-per-second (QPS) data

Click the Web Services tab. The Queries Per Second panel shows the following data for each API for the date range selected:

  • Average QPS your application used
  • Maximum QPS your application used
  • QPS your application uses 99% of the time

Note that for the Distance Matrix API, the report shows elements (origin-destination pairs) per second instead of requests.

Optionally, change the date range for the report.

Tip: Use the QPS data to determine how many QPS to purchase.

View web services usage details

Click the Web Services tab. The Total Requests panel shows the total web service requests for each date in the date range selected. Note that for the Distance Matrix API, the report shows elements (origin-destination pairs) per day instead of requests.

Optionally, change the date range for the report and export data for further analysis.

Note: The panel on the right shows the success rate of your application’s web service requests and any errors your application’s requests have received. For details, see “Application health reports.”

Application health reports

Get a snapshot of your application’s health

On the Dashboard tab, you’ll find a snapshot of your application’s performance over the past 2 days in the Application Status panel. The following icons indicate the success rate of your application’s web service requests for Google Maps Platform data:

Icon Description

Good: At least 95% of requests were successful.

Warning: Between 80-94% of requests were successful.

Alert: Fewer than 80% of requests were successful.

No requests: Your application hasn’t used this API.

Hover your mouse pointer over an API to see more information.

Check success rate of web service requests

Click the Web Services tab. The graph in the % Request Success panel shows the success rate of your application’s web service requests for the date range selected.

Optionally, change the date range for the report and export data for further analysis.

Check for web service request errors

Click the Web Services tab. Below the graph in the % Request Success panel, you’ll see any error codes your application has received, if your application’s web service success rate is less than 100% for the date range you selected. Optionally, change the date range for the report. To see hourly data, with minute-level timestamps, select a date range of 3 days or fewer. To analyze and troubleshoot the errors further, export data to a file.

The Usage Dashboard shows the following types of errors your application might receive when requesting Google Maps Platform web services. For solutions, see the Google Maps Platform web services section of the Developers site.

Error code Description
OVER_DAILY_LIMIT Your application’s request was over the daily limit. When this error occurs, the web service stops returning data until more usage is allowed.
OVER_QPS_LIMIT Your application’s queries per second (QPS) for web services was over the per-second limit. When this error occurs, the web service stops returning data until more usage is allowed.
INVALID_SIGNATURE Your application’s request had an invalid digital signature. For more information about signatures and how to generate signatures, see the digital signatures sectionon the authentication and authorization page.
INVALID_REQUEST The web service was unable to parse your application’s request. This error typically occurs when a request is missing information.
INTERNAL_ERROR There was an error processing your application’s request, but the web service did not return a reason.

Support and feedback

Get technical support

If you need help with the Google Maps APIs for Work Usage Dashboard, you can create a case in the Google Cloud Support Portal.

  1. Log in to the Google Cloud Support Portal.
    Note: If you don't have your login credentials, you can request access to the portal.
  2. Click the Cases tab.
  3. Click the Create New Case.
  4. For the Product Name, click My product isn’t listed. Then choose Google Maps from the drop-down list.
  5. For Group and case Components, select Other.
  6. Set the Priority according to the priority designations.
  7. In the description, include a summary of the issue and the steps to reproduce it. Make sure you indicate that your issue is with the Google Maps APIs for Work Usage Dashboard.

Send us feedback

You can suggest a feature, report an issue, or send other feedback about the Google Maps APIs for Work Usage Dashboard. Although we're not able to personally reply, we'll use your feedback to improve the Usage Dashboard experience.

  1. In the lower-right corner of any Dashboard tab, click the Send Feedback button image of Feedback button.
  2. Follow the on-screen instructions.