This guide shows Premium Plan customers how to migrate to the Google Maps Platform pay-as-you-go pricing model.
- Starting November 1, 2018, Premium Plan customers can migrate to the Google Maps Platform pay-as-you-go pricing model once their current Premium Plan contract expires. Only contracts whose end date is November 1, 2018, or later, can migrate to Google Maps Platform. Contracts expiring prior to November 1, 2018 must be renewed on Premium Plan.
- Existing Premium Plan customers will not be required to make any code changes to migration (e.g. no changes to Client IDs or API keys are needed).
- To prepare for migration, you must set up a billing account to link to the API project. Upon the Premium Plan contract expiration date, your API project will be "unlocked", allowing a new billing account to be associated within the Console.
- If your usage exceeds 500,000 API calls/month on any API, you may benefit from volume based pricing. We recommend working with a Google Maps partner. Please refer to the Pricing Page and Calculator for more details about pricing.
Premium Plan to Reseller sub-billing on Google Maps Platform
Prior to contract expiration
- Customer: Sign a renewal contract with Partner which includes the Google Maps Platform Terms of Service.
- Partner: Conducts the process for requesting a volume price discount for customer. We recommend performing this step at least 2 weeks prior to your renewal to allow for processing time.
- Partner: Set up a sub-billing account in the reseller billing account.
- Partner: Set permissions and a role for the customer to access their billing account.
- Customer: Ensure that you have access to your Premium Plan project. If you've lost access, see below for further instructions.
On the first few days after the Premium contract expires
- Within three days after your Premium Plan contract expiration date, your project will be "unlocked" allowing the new billing account to be associated.
- Be sure to link the project to the sub-billing account that was created by
your partner as soon as possible. To do this, take the following steps:
- Open the console, select a Premium Plan project (for example "Google Maps -INT"), and select Billing from the upper-left navigation menu.
- Select Manage billing account and click the My projects tab.
- Select the project name, click the three vertical dots, then select Change billing account.
- Click Choose an account, and select your reseller billing account from the list. Then, select SET ACCOUNT.
- For more details, see the example walkthrough.
- We recommend enabling billing on the new account within 7 days. Once billing is enabled, any usage you have during this interim period will be charged on the new billing account.
- If sub-billing is not enabled within 30 days of the Premium Plan contract expiration date, your usage of the Google Maps Platform APIs will be blocked.
Premium Plan to Online billing on Google Maps Platform
Prior to contract expiration
- Familiarize yourself with the process of adding an online payment method.
- Ensure that you have access to your Premium Plan project. If you've lost access, see below for further instructions.
On the first few days after Premium contract expires
- Within three days after your Premium Plan contract expiration date, your project will be "unlocked" allowing the new billing account to be associated. Be sure to add an online payment method for your billing account. We recommend adding a payment method and enabling billing within 7 days. Once billing is enabled, any usage you have during this interim period will be charged on the new billing account.
- If Billing is not enabled within 30 days of the Premium Plan contract expiration date, your usage of the Maps APIs will be blocked.
Premium Plan to Offline billing on Google Maps Platform
Please contact your dedicated Google Account Manager.
Frequently asked questions
To simplify the migration process, we will automatically generate a mapping between Client IDs and Premium Plan projects. That way, you won’t have to make any coding changes.
Yes, we provide deployment support to customers. Please contact your dedicated account manager and/or partner. See the Optimization Guide to learn more.
Anyone assigned the role of Billing Account Administrator can both access and grant access to others (see Overview of Billing roles in Cloud IAM). Please review the billing account and make sure the role has been set appropriately. In case of reseller sub-billing migration, please provide the partner with a customer contact who will get permission to access the sub-billing account.
If you have multiple SKUs (for example Maps-INT, Maps-OEM), multiple billing accounts have been created per SKU (that is, Maps-INT and Maps-OEM each have their own separate account). We recommend consolidating these into a single billing account.
The pay-as-you-go pricing model is not yet available in India. We will contact you prior to it becoming available in your area. In the meantime, your Premium Plan pricing will not change.
Customers and Partners should visit the Google Maps Platform support page in the Google Cloud Console to see the available support options. If customers are affiliated with a partner, the partner provides the first line of technical support.
Customers who had Gold Support on their Premium Plan license will retain access to Gold-equivalent functionality (including 24x7 support) for 12 months after they have migrated to the pay-as-you-go pricing model. Such users should keep using the Support Portal in order to file support cases.
It is critical that you access your Premium Plan project, so that you can enable billing and avoid service interruptions through the renewal. Even if you only use your Client ID, you will need access to your project in order to enable billing. If you lost access to your project, please ask your team members so that they can give you access to your Premium Plan project. If you still can't recover access to your project, please contact support. If you lost access to your Premium Plan billing account it’s not a problem, just switch to a new billing account. Once your Premium Plan contract has ended, you will be able to associate your project to a new billing account.
If your client ID has expired, some of the links will no longer appear in the left menu. To access them, follow this link.
You should keep using the Support Portal Premium Plan usage reports
to view your usage broken down by channels. For customers with a Premium Plan
channel parameter can now be used with either an API
key or Client ID. (This change applies only to APIs that already supported the
use of the
channel parameter with a Client ID; for example, see the
Once you have enabled billing on your project, you will also be able to access your channel data by
exporting your billing activity to BigQuery.
The following example shows how to access your channel data by exporting your billing activity to BigQuery. Prior to running this query, you must:
- Enable billing on your account.
PROJECT_IDwith your actual project ID (e.g. "myWebStore").
BILLING_ACCOUNTIDwith your actual Billing Account ID. In your billing ID, replace all dashes (-) with underscores (). For example, billing account ID
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day, invoice.month AS invoice_month, service.description AS service, sku.description AS sku, ( SELECT l.value FROM Unnest(labels) AS l WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel, Round(Sum(usage.amount), 2) AS usage_amount, usage.unit AS usage_unit, Round(Sum(cost), 2) AS cost, cost_type, currency FROM
PROJECT_ID.billing_export.gcp_billing_export_v1_BILLING_ACCOUNT_IDWHERE invoice.month = '201906' --change invoice month here GROUP BY billing_day, invoice_month, service, sku, channel_maps_googleapis, goog_maps_channel, usage_unit, cost_type, currency ORDER BY billing_day, service, sku limit 1000
We will continue to support channel for Client ID requests and they will be accessible from billing export in the console. We support 1000 channels in the console.
Features specific to the Premium Plan will remain accessible from your existing Premium Plan identifiers (Client ID or project ID). It will not be accessible from new project(s) you may create.
Although we do not plan to discontinue Client ID usage in the foreseeable future, we recommend that you update your applications to use API key authentication instead of Client ID authentication. The API key offers equivalent functionality, and is fully supported in the console.
Yes. If you currently benefit from a QPS increase beyond the Maps Premium Plan default limits, you will retain that QPS limit under Maps Platform (on any API).
Your Client ID usage now appears in the Cloud Console. Because this feature is still under development, there are some issues you should be aware of:
You can now see the usage associated with your Client ID in Google Cloud Platform Console Metrics. On multiple charts (Traffic/Error/Latency by credentials), you will see graphs associated with the Client ID usage annotated with label "project_number: 12345678". The legend under the graph may not always have enough screen space to display that label - in that case, just hover on the graph to see the entire label.
You can also see the Client ID usage on the Metrics page when selecting one of the Maps APIs in the Google Cloud Platform Console API list. Be aware of the following issues:
- The "Traffic - By credential" chart does not show Client ID traffic. Tracked as public issue 112564014.
- It is not easy to focus on Client ID traffic versus API key traffic with the "All API Credentials" filter. Tracked as public issue 126811220.
Client ID traffic is not bound by the quota limits on your Premium Plan projects, so it is not included in the Quotas reports in the Google Cloud Console. Client ID traffic is bound by quota limits that cannot be visualized in the Console.
Google Cloud Console Billing reports now include Client ID usage.