Client-side APIs in the Google Maps API for Work suite apply page views against the purchased quota. A page view is defined as:
- A single request for a Google Street View Image API image or Google Static Maps API image.
- A single load of the Google Earth API into a page.
User interactions with a map, such as panning, zooming, or changing map types, do not generate additional page views.
A page view is generated if the API is loaded into the page even if the API is
not then used to display a map. We therefore recommend against including the
<script> tag that loads the API in page templates, and recommend loading the
API asynchronously on pages where maps are only displayed in response to
optional user activity.
When you have used all of your purchased quota, you will need to renew your license promptly.
You can analyze your usage statistics in two different ways:
To get detailed information about your Google Maps API for Work usage as it pertains to billing, access the reports available from the Maps: Usage Report tab of the Enterprise Support Portal.
Once logged in to the portal, click Maps: Usage Report from the left navigation panel. You can filter by channel and by date range.
The data in these reports is the same data that Google uses when determining your usage-based billing.
To track usage across different applications using the same client ID,
you may provide an optional
channel parameter with your requests. By
channel values for different aspects of your
application, you can determine precisely how your application is used.
For example, your externally-facing website may access the API using a
channel set to
customer while your internal marketing department may
channel set to
mkting. Your reports will break down usage by
channel parameter must use the following format:
- Must be an ASCII alphanumeric string.
- Period (
.), underscore (
_) and hyphen (
-) characters are allowed.
channelparameter is case-insensitive; upper-case, mixed-case, and lower-cased
channelparameters will be merged into their lower-case equivalent. For example, usage on the
CUSTOMERchannel will be combined with the usage on the
channelvalue must be a static value assigned per application instance, and must not be generated dynamically. You may not use
channelvalues to track individual users, for example.
Up to 2,000 distinct channels can be used, per client ID.
channel parameter should be appended to the
src value of your
Analytics for Google Maps API for Work
With Analytics for Maps API for Work you can learn how people are interacting with your maps so that you can improve your application based on real usage statistics. Analytics for Maps API for Work answers such questions as:
- What zoom level and map type are most common?
- For which countries are users requesting geocoding results?
Visit the Google Enterprise Support Portal and select Maps: Analytics from the Resources list. If you have multiple client IDs associated with your account you will be asked to select the client ID and channel you wish to use each time you access Analytics.
Enable Analytics for your Client ID
Analytics is disabled by default and must be enabled on a per client ID basis. You will be asked to confirm that you want to enable Analytics the first time you try to access the reports for each client ID. It can take up to 5 minutes for Analytics to start recording data after this process has been completed.