Maps Platform Migration Guide

This guide shows Premium Plan customers how to migrate to the new pricing plan on Google Maps Platform.

Key points

  • Starting November 1, 2018, Premium Plan customers will be able to migrate to the new Google Maps Platform pricing plan once their current Premium Plan contract expires. Only contracts whose end date is November 1, 2018, or later, are eligible to be migrated to Google Maps Platform. Contracts expiring prior to that date 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.

Migration process

Premium Plan to Reseller sub-billing on Google Maps Platform

Prior to contract expiration

  • Customer: Sign a renewal contract with Partner which includes the new 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

General

How will I benefit by migrating to the new pricing plan?

To simplify the migration process, we will automatically generate a mapping between Client IDs and/or Premium Plan API keys. That way, you won’t have to make any coding changes.

Can we get help with optimizing our usage?

Yes, we provide deployment support to customers. Please contact your dedicated account manager and/or partner. See the Optimization Guide to learn more.

Who can access the billing account and grant access to others?

Please make sure that the role has been correctly set on the billing account. 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.

I have multiple SKUs. What is the best practice to manage them?

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.

Can Premium Plan customers in Brazil, Canada, and India migrate to the new pricing plan after November 1?

The new pricing plan is not yet available in Brazil, Canada, or India. We will contact you prior to it becoming available in your area. In the meantime, your Premium Plan pricing will not change.

Support

How can we contact technical support once we migrate to the new pricing plan?

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 new pricing plan. Such users should keep using the Support Portal in order to file support cases.

I lost access to my Premium Plan project or billing account, what should I do?

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.

Product

Can I keep seeing my usage broken down by channel?

You should keep using the Support Portal Premium Plan usage reports to view your usage broken down by channels. Channels can now be used with an API key (previously it was available only when used with a Client ID). Once you have enabled billing on your project, you will able to access your channel data by exporting your billing activity to BigQuery.

How many channels will be supported in the Google Cloud Console?

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.

Will I retain access to Premium-Plan specific features, like large Static Maps?

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.

Can I create new projects and associate them with my billing account?

You can create new projects, subject to quotas. The new projects will miss some Premium-Plan specific features like large Static Maps.

Should I stop using my Client ID?

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.

Where should I manage my Client ID?

You should keep using the Google Cloud Support Portal to manage your client ID: register authorized URLs and get your private cryptographic signing key.

Will I retain my special quotas?

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).

For Maps JavaScript API services (e.g. Geocoding Service), your QPS will remain unlimited.

Exception: Places API and Places JavaScript service. Once your Premium Plan contract expires, both the Places JavaScript service and the Places API will share a QPS limit, whose default is 100 QPS (while on Premium Plan, the Places JavaScript service was unlimited QPS, and the Places API was limited separately with a default of 50 QPS). In order to ensure that the new shared QPS limit on Places is sufficient, we analyzed your shared traffic, and granted a shared QPS limit which will cover the sum of traffic (rounded to the nearest next hundred QPS). Going forward, as you anticipate growth on the Places JavaScript service, you will need to ensure that the shared QPS limit is set high enough. Contact Support if you need to increase the limit.

For Maps JavaScript API, your QPS on JavaScript services (geocoding, directions, etc.) will remain unlimited.

Exception: Places APIs (Web Service and JavaScript). Once your Premium Plan contract expires, both the Places Library, JavaScript API and the Places API will share a QPS limit, whose default is 100 QPS (while on Premium Plan, the Places JavaScript service offered unlimited QPS, and the Web Service was limited separately with a default of 50 QPS). In order to ensure that the new shared QPS limit on Places is sufficient, we analyzed your shared traffic, and granted a shared QPS limit which will cover the sum of traffic (rounded to the nearest next hundred QPS). Going forward, as you anticipate growth, you must ensure that the shared QPS limit is set high enough. Contact Support if you need to increase this limit.

Can I see usage for my Premium Plan Client ID in the Google Cloud Console?

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:

Usage Reports
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.

This feature is released for all APIs that currently support Client ID authentication, except the Places Library, JavaScript API. See feature request 112585631 for updates.

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 112565114.

Quota Reports
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.

Billing Reports
Google Cloud Console Billing reports now include Client ID usage (feature request 112601621).

Resources