The purpose of the Usage API is to provide you with information about the amount of data you have sent, received, and stored, and the billable services, such as platform layers and pipelines you have used. It allows you to monitor your actual usage. Once you know your usage, you can estimate your costs, using the pricing at the HERE base plan pricing web page.
Billing varies by the HERE service. As an example, billing for Location services is measured in transactions, data storage in GB-Months, and data transfer in GB. Billable usage is calculated per hour.
In this section, the term "realm" means "organization". See Manage your organization.
Usage information can take up to two hours to arrive for Location Services and up to 48 hours for billable services; this may differ from usage values on your billing statement. Check your invoices and contract for actual billing costs. Dates are based on UTC.
To obtain authorization for the Usage API, your credentials must be generated from the organization where your usage is requested. See the OAuth tokens documentation for more details.
There are several ways to determine your usage:
You can get a quick snapshot of your platform billable usage information by going to the portal launcher > Usage Manager.
You can get billable usage information by accessing the Usage Report.
You can get billable usage information by accessing the Usage API for each organization. You can query additional parameters by appId, projectId, featureId, or billingTag. Billable usage is calculated hourly with a maximum time range of up to 95 days.
For tutorials showing how to use the Usage API, see Get usage by organization, feature, project, app.