Google Maps Platform FAQ

Getting Started

  • What is the Google Maps Platform?
  • How do I get started with Google Maps Platform?
  • Which API do I demand?
  • How practise I outset using the APIs on my site?
  • Which countries does the Google Maps Platform cover?
  • Tin I put Google Maps on my site without using Google Maps Platform products?
  • How exercise I deliver Maps applications on mobile devices?
  • Which web browsers practise the Maps JavaScript API and Maps Embed API support?
  • Tin can I impress maps from the Maps JavaScript API?
  • How tin I be notified when there are changes to Google Maps Platform products?
  • How do I contact technical support?
  • When is technical support bachelor?
  • How do I recover access to my Google Account?
  • How do I recover access to a specific project?
  • Can I apply the Maps and Places SDK for iOS on Arm-based Macs?

Understanding the terms of service

  • What are the terms of service for Google Maps Platform products?
  • Does my site see the Google Maps Platform Terms of Service?
  • Can I directly admission map tiles and satellite imagery?
  • Tin can I use Google Maps Platform products for tracking applications?
  • Tin I utilise Google Maps Platform products in my not-Web application?
  • Tin I use Google Maps Platform products on a site that is password protected?
  • Tin can I create an application that includes Google Maps Platform data in a document?
  • How tin I opt out of including my content in Google search results?
  • Can I generate a map image using the Maps Static API which I store and serve from my website?

Usage limits and billing

  • How do I set billing for my project?
  • How do Google Cloud Platform Complimentary Tier customers upgrade to a paid account?
  • Does the Google Maps Platform take usage limits?
  • How is usage cost calculated?
  • How are map loads counted on the Google Maps Platform?
  • How do I monitor my quota usage?
  • What happens if I exceed the usage limits?
  • My site gets a lot of traffic. Can I use Google Maps Platform products?
  • If my web site or application becomes suddenly popular, will my maps stop working?
  • How volition usage exist calculated and billed?
  • How much does it price to use the Google Maps Platform?
  • Is pricing available in other currencies?
  • I've prepare billing. How exercise I view my pecker?
  • How practise I avoid a large bill if my usage unexpectedly increases?
  • I got a message saying that my project is linked to the "Google Maps Platform Transition Account", only I don't have admission to that business relationship. What do I do?
  • Why is my quota limit fix to 1 request per solar day? How tin I heighten this limit?
  • I received a billing violation notice. How do I resolve this?

Using the Google Maps Platform

  • Which keys or credentials should I use for different Google Maps Platform products?
  • How do I switch my central restriction blazon from an HTTP referer to an IP address restriction?
  • How do I get a new API cardinal?
  • How can I discover the changes introduced in each version of the Google Maps Platform?
  • How tin can I load the API into a folio asynchronously after the page has loaded?
  • How tin I get Google Maps Platform products to display in a linguistic communication other than English?
  • Can the Google Maps Platform be accessed over SSL (HTTPS)?
  • How do I study a bug or asking a new feature in the Google Maps Platform?
  • How do Google Maps Platform APIs utilize site cookies?
  • I can't find the reply to my question. Who should I contact?

Errors and troubleshooting

  • What does this error hateful?
  • My maps appear darker than usual. What'due south happening?
  • How do I resolve the error codes OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
  • How practise I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
  • How exercise I resolve the mistake: "This IP, site or mobile application is not authorized to use this API key."?
  • How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

Google Maps Platform Services

  • I need to convert addresses to latitude/longitude pairs. Tin I do that with the Google Maps Platform?
  • Which countries is geocoding available in?
  • Why exercise the Google Maps Platform Geocoders provide different locations than Google Maps?
  • How should I format my geocoder queries to maximise the number of successful requests?
  • How should I format a U.S. address on a numbered highway for geocoding?
  • When should I employ an API geocoder class and when should I employ the HTTP Geocoding Service?
  • How practice I provide driving directions with the Google Maps Platform?
  • In which countries are driving directions bachelor?
  • In which countries are transit directions available?
  • Which KML and GeoRSS features are supported in the Maps JavaScript API?
  • What are the limits on the size and complication of KML that tin can be displayed using the KmlLayer grade of the Maps JavaScript API?
  • How do I render KML files that are hosted on intranet sites on a map?
  • What is the maximum number of markers or path vertices supported by the Maps Static API?
  • Why can't I access Google Maps Platform products for certain countries?
  • How do I report a trouble on the Google basemap?
  • How is performance monitored for the services used with Maps JavaScript API?

Maps JavaScript API

  • How long will the Maps JavaScript API work later it has been loaded?

Google Maps SDK for iOS

  • In Xcode 12, apps practice non build correctly for the simulator. How tin can I prepare this?
  • How do I resolve the fault: kGMSPlacesRateLimitExceeded?
  • I'grand getting crashes when debugging with an iOS 8.ten device. What should I do?
  • What'south the impact of rounded and wider screens on the Google Maps iOS SDK?

Google Maps SDK for Android

  • How practise I resolve the error: 9001 Operation failed due to exceeding the quota usage limit?
  • My app merely shows bare grayness tiles instead of a map. How can I resolve this?

URL signing

  • Can I sign URLs using JavaScript?
  • Why am I receiving a HTTP 403 Forbidden response to my Maps API spider web service requests?

Getting Started

What is the Google Maps Platform?

The Google Maps Platform is a set of APIs and SDKs that allows developers to embed Google Maps into mobile apps and web pages, or to retrieve data from Google Maps. In that location are several offerings. Depending on your needs, yous may detect yourself using one or a combination of these APIs and SDKs:

Maps:

  • Maps JavaScript API
  • Maps SDK for Android
  • Maps SDK for iOS
  • Maps Static API
  • Street View Static API
  • Maps URLs
  • Maps Embed API

Routes:

  • Directions API
  • Distance Matrix API
  • Roads API

Places:

  • Places API
  • Places SDK for Android
  • Places SDK for iOS
  • Places Library, Maps JavaScript API
  • Geocoding API
  • Geolocation API
  • Time Zone API
How do I get started with Google Maps Platform?

See Get Started with Google Maps Platform.

Which API practise I need?

For aid in finding the right API based on your functional requirements, have a look at the API picker.

How exercise I outset using the APIs on my site?

Encounter the Overview, Developer, and Get Started guides for the specific API or SDK you are interested in. For example, cheque out the guides for Maps SDK for Android or Maps JavaScript API.

Which countries does the Google Maps Platform cover?

The Google Maps squad is constantly pushing new map data out and increasing our international coverage. Consult the Google Maps coverage data for the latest coverage data. Yous can filter the data with the filter box at the top of the folio. Please annotation that coverage data can change if licensing agreements with the information providers change.

Also come across:

  • How can I get Google Maps Platform products to display in a linguistic communication other than English?
  • In which countries are transit directions bachelor?
Tin I put Google Maps on my site without using Google Maps Platform products?

Yes. Google Maps now offers the ability to embed the map that you're viewing into your website or blog, without any programming or use of the Google Maps Platform. More than information is available here.

How do I deliver Maps applications on mobile devices?

To incorporate maps in an Android application, use the Maps SDK for Android.

To incorporate maps in a native iOS application, utilize the Maps SDK for iOS.

The Maps JavaScript API has been adult to cater to mobile devices, and is suitable for browser applications targeted at both the desktop and devices that include a web browser with a full JavaScript implementation, such as the Apple tree iPhone.

For applications targeted at devices not suitable for using the Maps JavaScript API, the Maps Static API delivers map images in GIF, JPG, and PNG formats, including markers and polylines. Annotation that employ of the Maps Static API outside of browser based applications requires that the map image be linked to Google Maps.

Which spider web browsers do the Maps JavaScript API and Maps Embed API support?

The Maps JavaScript API and Maps Embed API support the following spider web browsers:

Desktop
  • The electric current version of Microsoft Border (Windows)
  • The electric current and previous versions of Firefox (Windows, macOS, Linux)
  • The electric current and previous versions of Chrome (Windows, macOS, Linux)
  • The electric current and previous versions of Safari (macOS)

In lodge to free upwardly resource to deliver customer-requested features available to modern browsers, Google Maps Platform is ending back up for Net Explorer eleven. Microsoft ended support for IE11 in 2021 and encouraged migration to Microsoft Edge.

Beginning in August 2021, a alert message started to announced to Internet Explorer 11 users at the top of maps. The last version of the Maps JavaScript API to support Internet Explorer 11 is v3.47. Support for Internet Explorer 11 will be entirely discontinued in November 2022. This likewise applies to the IE fashion in Edge.

Android
  • The electric current version of Chrome on Android 4.1+.
  • Chrome WebView on Android four.4+.
iOS
  • Mobile Safari on the electric current and previous major versions of iOS.
  • UIWebView and WKWebView on the current and previous major versions of iOS.
  • The current version of Chrome for iOS.
Tin can I impress maps from the Maps JavaScript API?

Press from the Maps JavaScript API is not supported. This is considering press support is inconsistent beyond commonly used browsers.

How can I exist notified when at that place are changes to Google Maps Platform products?

You should subscribe to the Google Maps Platform Web log for news updates across the various Google Geo developer offerings.

How do I contact technical back up?

Encounter Google Maps Platform Back up and Resources for data about bachelor support options.

When is technical support available?
The back up squad is available 24x5 (weekdays from Monday nine a.k. Tokyo time to Fri 5 p.grand. Pacific time) excluding regional holidays for "service unusable" issues.
How tin I recover access to my Google Business relationship?

If you lost access to your Google Business relationship (e.g. joe@mycompany.com or joe@gmail.com), yous can try restoring the business relationship access by retrieving or resetting your password. Visit the How to recover your Google Account or Gmail commodity in Google Account Aid.

  • Note: To restore access to a G Suite account, ask your Arrangement admin to undelete the account.
How can I recover access to a specific projection?

If you lost access to the projection where yous manage your Google Maps Platform implementation, you tin can endeavor to recover it.

If you accept admission to your project-associated Google Account:

  • If you know the Project Owner and have access to your Google Account: Ask the Projection Owner to add you every bit a Project Owner or Project Editor.
    • If your project is part of an Organization: Contact your Organisation admins and ask them to add you as a Projection Owner.
  • If you do not know any of the current Projection Owners: If you don't know who the Project Possessor is, or the Project Owner is unavailable, contact the support team to explore additional options to recover the project.

If you lot do not have access to your project-associated Google Account:

  • If y'all lost admission to your Google Business relationship: try to recover your username or countersign for your account.
  • If you cannot recover access to your Google Business relationship: Create a new Google Account, then contact an existing projection owner and ask them to add your new Google Account to the project.
Can I use the Maps and Places SDK for iOS on Arm-based Macs?

Developing on the new Arm-based Macs is possible, nevertheless, it requires edifice and running on a physical iOS device. This is a temporary limitation while we expect into adding more than support for developing on simulators.

Agreement the terms of service

What are the terms of service for Google Maps Platform products?

The Google Maps Platform Terms of Service are available at:

https://cloud.google.com/maps-platform/terms

Does my site run into the Google Maps Platform Terms of Service?

You can use the Google Maps Platform within your applications as long as your site meets the Google Maps Platform Terms of Service.

However, there are some uses of the Google Maps Platform that we simply don't want to run into: maps that identify the places to buy illegal drugs in a city, for example, or any other illegal activity. We also respect people's privacy, so the Google Maps Platform shouldn't be used to identify private information almost individuals.

You lot should employ your own counsel to determine whether your application complies with the Google Maps Platform Terms of Service before you develop and launch it. Google engineers can only offer technical help and are not qualified to offer legal advice. Google reserves the right to append or terminate your employ of the service at whatever time, so please read the Maps APIs Terms carefully.

Can I directly access map tiles and satellite imagery?

You may not access map tiles or satellite imagery through any mechanism besides the Google Maps Platform (such as the creation of your ain mapping API or the use of a bulk tile download script). Your application's access to the tiles will be blocked if it accesses them outside of the Google Maps Platform. Come across the Google Maps Platform Terms of Service for more than details.

Tin I utilize Google Maps Platform products for tracking applications?

In that location is no restriction on displaying real-time data (tracking) with Google Maps Platform products provided that the application complies with the Google Maps Platform Terms of Service.

Can I utilise Google Maps in my non-Web application?

Aye, Google Maps Platform products can now be used in not-Web applications, provided that they adhere to the other restrictions of the Google Maps Platform Terms of Service.

The Maps JavaScript API is merely supported when run in 1 of the supported browsers.

Can I utilise Google Maps Platform products on a site that is password protected?

Yes, Google Maps, Routes, Places services can be used with individual-access applications. See the Google Maps Platform Terms of Service for more details.

Tin I create an application that includes Google Maps Platform data in a document?

If your application generates a document, either in electronic or printed grade, no data from Google Maps Platform, including images, may be included in the document. Please meet the Google Maps Platform Terms of Service "No Scraping" section for more details.

How can I opt out of including my content in Google search results?

We are no longer collecting this data. The utilise of the indexing parameter has been deprecated and has no upshot. You lot no longer demand to opt out explicitly, only we encourage you to remove this parameter at your earliest convenience.

To remove your page or site from search results, follow the instructions provided in our webmaster aid center.

Can I generate a map image using the Maps Static API which I store and serve from my website?

You lot may not store and serve copies of images generated using the Maps Static API from your website. All spider web pages that crave static images must link the src aspect of an HTML img tag or the CSS background-paradigm attribute of an HTML div tag directly to the Maps Static API then that all map images are displayed within the HTML content of the web page and served directly to terminate users by Google.

Usage limits and billing

How do I set up billing for my project?
See Get Started with Google Maps Platform.
How do Google Deject Platform Free Tier customers upgrade to a paid account?
The Google Deject Platform Free Tier program provides customers a no-charge trial with a $300 credit to employ with any Google Cloud Platform (GCP) service, including the Google Maps Platform (GMP) APIs. When the no-charge trial ends, you must upgrade to a paid account to continue using these services. To upgrade to a paid account, visit the Cloud Console.
Does the Google Maps Platform have usage limits?

At that place are no maximum daily limits on the number of requests you tin can brand to Google Maps Platform products, and the simply usage limits are related to the maximum number of queries per second (QPS). (For Distance Matrix, the limit is set in events per 2nd (EPS) calculated as the sum of client-side and server-side queries.) The following tabular array shows the usage limit for each API.

API Usage limit
Directions fifty QPS
Altitude Matrix m EPS
Meridian 100 QPS
Geocoding l QPS
Geolocation 100 QPS
Dynamic Maps 500 QPS
Static Maps 500 QPS
Street View Prototype API 500 QPS
Fourth dimension Zone 500 QPS
Places (except for mobile) 100 QPS
Roads 500 QPS

In order to govern expenditures, you can monitor your API usage, and ready daily limits to all requests to any billable API.

Google Maps Platform products must be deployed in compliance with the standard Google Maps Platform Terms of Service.

How is usage cost calculated?

For an overview of pricing for the Google Maps Platform products, delight see the Pricing Sheet.

To learn more about how Google Maps Platform APIs are billed, please see Understanding billing for Maps, Routes, and Places.

How are map loads counted on the Google Maps Platform?

A unmarried map load is charged when whatever of the following occur:

  • A web page or application displays a map using the Maps JavaScript API.
  • An awarding requests a single map image from the Maps Static API.

Street View panoramas are charged separately from map loads:

  • A static Street View panorama is charged for each request to the Street View Static API to embed a static (non-interactive) Street View panorama.
  • A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOS awarding.

After a web folio or application loads a map, or a static map prototype, or a Street View panorama, any user interactions with it, such as panning, zooming, or switching map layers, do not generate additional map loads or affect usage limits.

How do I monitor my usage?

You can monitor the usage of private APIs in the Google Cloud Console.

  1. Select the project that contains the API you want to review.
  2. From the list of APIs on the Dashboard, click the name of the API.
  3. Near the peak of the page, click Metrics or Quotas.

To run into a traffic report and billing information for an entire project, follow these steps:

  1. If yous haven't already done and then, ready billing.
  2. Get to the Cloud Panel billing page.
  3. Select a projection.
  4. In the left sidebar, click Reports. Use the filters on the right sidebar to view reports on your billing account.

To learn more, see Google Maps Platform Reporting as well as Monitoring your API Usage and Capping API Usage.

What happens if I exceed the asking rate (QPS) limits?

If y'all exceed the QPS limits of a given Google Maps Platform product, the API will return an error message. If y'all repeatedly exceed the limits, your admission to the API may be temporarily blocked.

If you lot exceed the request QPS limits or otherwise abuse the service, requests will return a specific error message. If you go along to exceed limits, your access to the Google Maps Platform may be blocked.

Note: Four of the web service APIs have an equivalent client-side service available in the Maps JavaScript API: Directions, Distance Matrix, Elevation, and Geocoding.

Usage limits exceeded

If y'all exceed the usage limits you volition go an OVER_QUERY_LIMIT condition lawmaking as a response.

This ways that the web service will stop providing normal responses and switch to returning merely condition lawmaking OVER_QUERY_LIMIT until more than usage is allowed over again. This can happen inside a few seconds, if the error was received because your application sent besides many requests per second.

If you regularly exceed your QPS usage limits, consider lowering usage, by optimizing applications to use Google Maps Platform products more efficiently. See the Optimization Guide for more than information.

My site gets a lot of traffic. Tin can I use Google Maps Platform products?

Yes. Yet nosotros recommend that you familiarize yourself with the usage limits for any of the Google Maps Platform that your application relies on.

Once yous take a billing account, if you exceed the no-charge, $200-monthly usage limit and y'all do not take a valid payment method on your billing business relationship (credit card, bank transfer, ...), the API ceases to function until you add a valid payment method.

How will usage be calculated and billed?

Usage is calculated at the finish of each day, and priced as shown in the Pricing Sheet. At the end of every month, the total usage is charged to the payment method associated with your billing account. For more than information, meet Google Maps Platform Billing.

How much does information technology toll to use the Google Maps Platform?

See the Pricing Sheet for an overview of cost per API. If your application generates requests or map load volumes below the complimentary $200 per calendar month usage, your usage is not charged. Usage that exceeds the $200 monthly credit will exist charged to your billing business relationship. For more details, see our guide to agreement Google Maps Platform billing.

Is pricing available in other currencies?

Boosted currencies may exist available inside the console. When you select a unlike currency, rates will convert from the USD equivalent listed on our Pricing Sheet.

I've gear up billing. How do I view my nib?

Google charges you at the beginning of each month for the previous calendar month'southward activity, using your specified payment method. For details nigh your pecker, see our guide to agreement Google Maps Platform billing.

Additional resources:

  • Acquire how to view your cost and payment history.
  • Learn how to go an invoice or payment receipt.
  • Acquire how to set and manage billing alerts.
How exercise I avoid a large bill if my usage unexpectedly increases?

The Google Maps Platform provides ways to set daily request limits and fix maximum daily billable limits. You tin cap the maximum daily limit on usage to protect confronting unexpected increases. You can as well ready upkeep alerts to receive email notifications when the charges on the billing account reach a threshold y'all ready.

Capping the maximum daily billable limit:

To avoid a big beak, you can set a daily cap on usage to protect against unexpected increases in use. You lot can modify this limit in the Deject Console past taking the following steps:

  1. Become to the APIs & Services Dashboard.
  2. Select a project if prompted.
  3. Select an API from the list, so click the Quotas tab.
  4. Click the edit icon next to the "requests per twenty-four hours" quota.

Alternatively, you can edit multiple quotas for multiple APIs using the IAM & admin Quotas dashboard.

Setting and managing budget alerts:

Fix upkeep alerts to send e-mail notifications to billing administrators when the charges on the billing account reach a threshold you set. Billing administrators will be sent email notifications when the estimated charges on the billing account exceed 50%, 90%, and 100% of the threshold.

I got a message maxim that my project is linked to the "Google Maps Platform Transition Business relationship", but I don't have access to that business relationship. What do I practise?

The "Google Maps Platform Transition Account" was created to help certain customers transition to our new pay-as-y'all-go pricing plan. This transition account enabled Google to provide these customers with a one-fourth dimension credit, so that they could continue using Google Maps Platform upwardly to the limit of the $200 no-charge tier. In one case this limit is exceeded, the billing account will close down and you will lose admission to the service. To avoid service interruptions, we urge you to set up your own billing account, and go along to enjoy the $200 monthly no-charge tier. To change the billing account for your project:

  1. Create a new billing account (if you already have a billing account, you tin can skip this stride).
  2. Associate the billing account with your project.
Why is my quota limit prepare to 1 request per day? How can I raise this limit?

If you have not created and attached a billing account to your project, your Maps Platform APIs will be limited to 1 request per day. Yous can become higher quota by creating and attaching a billing account. To exercise this, see Get Started with Google Maps Platform.

In one case you have created and attached a billing account, your daily quota limit will be removed. Yous tin decide to set a limit to prevent unexpected spend, in the Cloud Console.

I received a billing violation notice. How do I resolve this?

Y'all accept received this notice because Google has determined that your account has been using multiple billing accounts. This is a violation of Google's terms, every bit defined in section 3.2.4 of the Google Maps Platform Terms of Service. Under these terms, it is forbidden to create multiple billing accounts. To learn more, come across the Billing Account Violation FAQ.

Using the Google Maps Platform

Which keys or credentials should I use for dissimilar Maps products?

Each time you utilise Google Maps Platform products, you must include an API key to validate your asking. The Google Maps Platform is available for Android, iOS or Web apps, and via HTTP web services.

API Cardinal:

  • An API key is a unique identifier that yous generate using the Cloud Panel.
  • Instance of loading an API with a key: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Digital Signature:

  • A digital signature is generated using a URL signing undercover provided to you by Google. Digital signatures are used with the Maps Static API and Street View Static API.

Restrictions:

  • API cardinal restrictions are optional, only we strongly recommend you restrict all API keys for greater security. See API security all-time practices for more than details.
  • Yous can add an application restriction to the API central. One time restricted, a cardinal will just piece of work on platforms that back up that type of restriction. Four types of application restrictions are bachelor. APIs enforcing the same brake type can use the same restricted key.
    • IP addresses (individual servers) - for apply with the web service APIs.
    • HTTP referrers (web sites) - for utilize with the web APIs.
    • Android app restriction (by package proper noun and fingerprint) - for employ with the Maps SDK for Android.
    • iOS app brake (past iOS bundle identifier) - for use with the Maps SDK for iOS.
  • You can besides add an API restriction to the API key. For more information, meet Get, add together, and restrict an API key.

The table below indicates the central/credential and application restriction for each Google Maps Platform API/SDK.

API/SDK Credential & Awarding Restriction
Maps SDK for Android API key with Android restriction1
Places SDK for Android API key with Android restrictionane
Maps SDK for iOS API cardinal with iOS restrictioni
Places SDK for iOS API key with iOS brake1
Maps JavaScript API API cardinal with HTTP referer restriction1
Maps Static API API key with HTTP referer restrictioni + Digital Signature2
Street View Static API API key with HTTP referer restrictionane + Digital Signature2
Maps Embed API API key with HTTP referer restriction1
Directions API API key with IP accost brakei
Distance Matrix API API central with IP address restriction1
Superlative API API key with IP address restriction1
Geocoding API API central with IP address brakei
Geolocation API API key with IP accost restriction1
Roads API API key with IP address restriction1
Time Zone API API cardinal with IP address restriction1
Places API API primal with IP address restriction1

1 API primal restrictions are optional, but nosotros strongly recommend yous restrict all API keys for greater security.

ii Depending on usage, a digital signature may be required for the Maps Static API and Street View Static API. Regardless of usage, we strongly recommend that you utilise both an API key and a digital signature to cosign your requests.

How do I switch my key restriction blazon from an HTTP referer to an IP address brake?

Of import: If yous are using whatsoever of the web service APIs with an API key that has referer restrictions, your requests will neglect with the mistake message: "API keys cannot take referer restrictions when used with this API." You lot should switch to using an API primal with IP address restrictions.

Before you switch the API cardinal brake type from HTTP referer to IP address, ensure that all the APIs that use the API key support the IP brake blazon. APIs of the aforementioned restriction type can utilise the same restricted key. If y'all demand to enforce more than than one brake, add together a dissever key with the required restriction. See how to add a new API key.

Larn more near API key restrictions associated with Google Maps Platform products.

To switch an API key with HTTP referer restriction to IP address brake, practise the following:

  1. Go to the Credentials page of the Deject Console.
  2. Select the project that contains the API key you want to edit.
  3. On the Credentials page, from the list of API keys, select the name of the API key to edit the details of the cardinal.
  4. In the Central brake department of the page, select "IP addresses (web servers, cron jobs, etc.)" and insert the appropriate server IP addresses, then click Save.
How do I get a new API key?
See Get Started with Google Maps Platform.
How can I find the changes introduced in each version of the Google Maps APIs?

Version change data for many of the Maps APIs are available at the following links:

  • Maps JavaScript API
  • Directions API
  • Distance Matrix API
  • Maps SDK for Android
  • Places SDK for Android
  • Maps SDK for iOS
  • Places SDK for iOS

You can also check which version of the Google Maps Platform a detail problems was introduced and fixed in using the Google Maps Platform Event Tracker at:

https://issuetracker.google.com/bookmark-groups/76561

How tin I load the API into a page asynchronously later on the page has loaded?

But specify the callback parameter when loading the API. More information and sample lawmaking can be institute in the Getting Started affiliate of the Maps JavaScript API documentation.

How tin can I get Google Maps Platform products to display in a language other than English?

By default the API will attempt to load the most advisable linguistic communication based on the users location or browser settings. Some APIs allow yous to explicitly gear up a linguistic communication when you make a request. More information on how to prepare the language is available in the documentation for each API:

  • Maps JavaScript API
  • Geocoding API
  • Directions API
  • Distance Matrix API
  • Places API
Supported Languages:

Google often updates supported languages. This list may non be exhaustive and is subject field to modify.

Language Code Linguistic communication Language Code Language
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Arabic km Khmer
hy Armenian ko Korean
az Azeri ky Kyrgyz
eu Basque lo Lao
be Belarusian lv Latvian
bn Bengali lt Lithuanian
bs Bosnian mk Macedonian
bg Bulgarian ms Malay
my Burmese ml Malayalam
ca Catalan mr Marathi
zh Chinese mn Mongolian
zh-CN Chinese (Simplified) ne Nepali
zh-HK Chinese (Hong Kong) no Norwegian
zh-TW Chinese (Traditional) pl Shine
hr Croation pt Portuguese
cs Czech pt-BR Portuguese (Brazil)
da Danish pt-PT Portuguese (Portugal)
nl Dutch pa Punjabi
en English ro Romanaian
en-AU English (Australian) ru Russian
en-GB English (Great U.k.) sr Serbian
et Estonian si Sinhalese
fa Farsi sk Slovak
fi Finnish sl Slovenian
fil Filipino es Spanish
fr French es-419 Spanish (Latin America)
fr-CA French (Canada) sw Swahili
gl Galician sv Swedish
ka Georgian ta Tamil
de German te Telugu
el Greek th Thai
gu Gujarati tr Turkish
iw Hebrew united kingdom of great britain and northern ireland Ukrainian
hi Hindi ur Urdu
hu Hungarian uz Uzbek
is Icelandic vi Vietnamese
id Indonesian zu Zulu
information technology Italian

Yous tin meet what the map will wait like in any of the languages listed above in this sample application.

Tin the Google Maps Platform exist accessed over SSL (HTTPS)?

The Maps JavaScript API, Maps Static API, and Web Service APIs can be accessed over secure (HTTPS) connections. Please come across the documentation for the API concerned for data on how to access the API over SSL.

Note that the Maps Static API does not support custom icon URLs that use HTTPS; the default icon will be displayed.

How do I report a problems or request a new feature in the Google Maps Platform?

If you lot feel behavior that you believe may be a bug, please begin by raising it in the relevant forum. This will allow other developers to validate the bug, and rule out any potential issues with your code.

If you lot wish to request a characteristic, delight also starting time raise it in the relevant forum to ostend that a solution that meets your requirements is not already available.

Once you take confirmed that you have identified a new bug, or that your requirements cannot be met past the existing functionality of the Google Maps Platform products, please report your bug or feature request using the Google Maps Platform Issue Tracker.

Before adding a bug or feature request to the Issue Tracker please be sure to bank check that the bug or feature concerned has not already been added. If it has, y'all can star the event to register your involvement and be notified of updates.

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS use cookies subject field to Google's Privacy Policy, such every bit calculating daily and seven-day active users and service abuse prevention. These cookies are not associated with any signed-in Google Account and are not logged with the rest of the information collected from the API calls.

I can't detect the answer to my question. Who should I contact?

Google's Developer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and answer site for programmers. It's a bully place to ask technical questions virtually developing and maintaining Google Maps applications. More data about asking questions on Stack Overflow is available on the Support page.

For best results when requesting aid, delight keep the following in mind:

  • Search the current discussions. Chances are someone else has experienced a like event and plant a fix.
  • Submit a link to your site if possible. Only post code snippets if the code is not easily viewable online.
  • Provide all relevant data including browser versions, errors, and all other facts that may be useful in troubleshooting this problem.

Errors and troubleshooting

What does this error mean?

If you encounter an error while loading or running the Google Maps APIs, please see the following links to find explanations for the error codes:

  • Maps JavaScript API
  • Maps Static API
  • Street View Static API
  • Maps Embed API
  • Tiptop API
  • Geocoding API
  • Geolocation API
  • Directions API
  • Distance Matrix API
  • Roads API
  • Fourth dimension Zone API
  • Places API
My maps appear darker than usual. What's happening?

Nether certain circumstances, a darkened map, or 'negative' Street View image, watermarked with the text "for development purposes only", may be displayed. This behavior typically indicates issues with either an API central or billing. To employ Google Maps Platform products, you must have a billing business relationship and all requests must include a valid API fundamental. The following menstruation will aid troubleshoot this:


How practise I resolve the error codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
These error codes can exist returned for any of the following reasons:
  • An API cardinal is missing from the asking.
  • The provided API key is invalid.
  • The project does not have a billing account attached.
  • A self-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for example, a credit card has expired).
  • Yous accept exceeded the QPS limits for a given API.

To use Google Maps Platform products, you must take a billing account, and all requests must include a valid API central. To fix this, have the following steps:

  • Set up up a billing account.
  • Become a new API central.
  • Adjust your usage cap to increase your daily limit (if applicative).
How practice I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If yous are seeing kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED, y'all may be using a deprecated version of the Places SDK for Android or Places SDK for iOS. Acquire more and observe the new SDKs at https://goo.gle/places-sdk-deprecation.
How do I resolve the error: "This IP, site or mobile application is not authorized to utilise this API key."?

At that place are various scenarios which may cause this mistake:

  • You've enabled IP address (server) restrictions on your API key, and an unauthorized IP address is attempting a request.
  • Yous've enabled HTTP referrer (website) restrictions on your API primal, and an unauthorized referrer is attempting a asking.
  • Y'all've restricted usage to your Android apps by setting a parcel name and fingerprint, and an unauthorized Android app is attempting a asking.
  • Y'all've restricted requests from iOS apps by specifying bundle identifiers and an unrecognized iOS app is attemting to send a request.
  • It used to be possible to get this error if you used any of the web service APIs, with an API key with HTTP referer restrictions. Requests to those APIs should be identified with an API key with IP address restrictions. Switch your key restriction blazon from an HTTP referer brake to an IP accost brake. For more information nearly restricting API keys, encounter API Key Best Practices.

View and Edit your API Fundamental Credentials

To view your API keys and manage whatsoever restrictions, do the post-obit:

  1. Go to the Credentials page of the Cloud Console.
  2. Select the project that contains the API key you want to review.
  3. To view credential details, including any restrictions set for the key, from the list of API keys, click the name of the fundamental.
  4. The full credentials of the selected API fundamental are displayed, including any restrictions fix upwards for the central. From hither, the restrictions can be inverse, deleted, or updated as needed.
How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

You lot are using whatever of the web service APIs with an API fundamental restricted to an HTTP referer. For security reasons, spider web service APIs need to use API keys restricted to IP addresses. Switch your primal restriction type from an HTTP referer brake to an IP address restriction, or create a new API key if your key is already used with the Maps JavaScript API.

Google Maps Platform Services

I need to convert addresses to latitude/longitude pairs. Can I practise that with the Google Maps Platform?

Yes, this process is called "geocoding." The Maps JavaScript API includes a grade for performing a geocoding service. The grade is: google.maps.Geocoder.

Alternatively, Google too provides the Geocoding API, which offers a Remainder interface that can respond in JSON and XML formats.

Which countries is geocoding bachelor in?

To come across countries currently supported by the Google Maps Platform geocoders, please consult the Google Maps coverage data.

The accuracy of geocoded locations may vary per country, and so you lot should consider using the returned location_type field to determine if a good enough match has been institute for the purposes of your application. Please note that the availability of geocoding information depends on our contracts with data providers, so it is subject to change.

Why do the Google Maps Platform Geocoders provide unlike locations than Google Maps?

The API geocoder and Google Maps geocoder sometimes utilise different information sets (depending on the country). The API geocoder occasionally gets updated with new data, so yous can expect to see results changing or improving over fourth dimension.

How should I format my geocoder queries to maximise the number of successful requests?

The geocoder is designed to map street addresses to geographical coordinates. We therefore recommend that you lot format geocoder requests in accordance with the post-obit guidelines to maximize the likelihood of a successful query:

  • Specify addresses in accordance with the format used by the national postal service of the country concerned.
  • Practice non specify additional address elements such as business organisation names, unit numbers, floor numbers, or suite numbers that are non included in the address as divers by the mail of the state concerned. Doing and so may outcome in responses with ZERO_RESULTS.
  • Format plus codes equally shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %20):
    • global code is a four graphic symbol area lawmaking and 6 character or longer local code (849VCWC8+R9 is 849VCWC8%2BR9).
    • compound lawmaking is a half-dozen character or longer local code with an explicit location (CWC8+R9 Mountain View, CA, USA is CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Use the street number of a premise in preference to the building name where possible.
  • Use street number addressing in preference to specifying cross streets where possible.
  • Practice non provide 'hints' such as nearby landmarks.
How should I format a U.S. address on a numbered highway for geocoding?

The Google Maps Platform geocoder requires that U.S. numbered highways be specified in addresses as follows:

  • Canton Roads: "Co Route NNN" where NNN is the route number. eg. "Co Road 82"
  • Land Highways: "State NNN" where State is the full proper noun of the state and NNN is the highway number. eg. "California 82"
  • U.S. Highways: "U.S. NNN" where NNN is the highway number. eg. "U.South. 101"
  • U.S. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
When should I use an API geocoder class and when should I use the HTTP Geocoding Service?

See the document: Geocoding Strategies, which details the pros and cons of different geocoding strategies.

How do I provide driving directions with the Google Maps Platform?

The Directions API allows you to provide driving directions for single and multi-leg journeys. Routing options help y'all shape directions with a travel mode (driving), a single or a set of routes, and restrictions (no toll roads). The service is bachelor in the post-obit forms:

  • HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps spider web services. See the Directions API for more data.
  • JavaScript API, for customer-side applications, allows y'all to provide driving directions via the google.maps.DirectionsService form. The DirectionsRenderer form tin automatically create the overlays and directions console for you. Additional examples are provided in the documentation.
  • Coffee, Python, go, and Node.js client interfaces, for server-side applications, provide the same functionality. Reference documentation is bachelor at these links: Java Customer for Google Maps Services, Python Client for Google Maps Services, Get Customer for Google Maps Services, and Node.js Client for Google Maps Services.
In which countries are driving directions bachelor?

To meet countries currently supported by Driving Directions in the Google Maps Platform products, consult the Google Maps coverage data. Delight notation that the availability of driving directions data depends on our contracts with data providers, and is subject to change.

In which countries are transit directions available?

The Directions API and Distance Matrix API back up all Google Transit partners, except those in Nihon.

Which KML and GeoRSS features are supported in the Maps JavaScript API?

The KmlLayer form in the Maps JavaScript API enables developers to overlay KML/KMZ and GeoRSS files on summit of the map. Documentation and examples tin can be found here.

What are the limits on the size and complication of KML that tin be displayed using the KmlLayer class of the Maps JavaScript API?

The size and complexity limits on the brandish of KML using the KmlLayer course are documented here.

How do I render KML files that are hosted on intranet sites on a map?

The KmlLayer class that generates KML overlays in the Maps JavaScript API uses a Google hosted service to recollect and parse KML files for rendering. Consequently it is not possible to display KML files that are not hosted at a URL that is available publicly accessible, or that require authentication to admission.

If you lot demand to develop applications that use KML files hosted on intranet sites we recommend that you render the KML on the customer side by using 3rd-party JavaScript libraries. Equally the KML file is analyzed by the browser, performance may be lower than by using the KmlLayer class.

What is the maximum number of markers or path vertices supported by the Maps Static API?

There is no limit to the number of markers or path vertices supported by the Maps Static API. When using custom icons, upwardly to five unique icons can exist specified per request, only each can be used multiple times within the map.

Annotation that Maps Static API URLs can comprise a maximum of approximately 8,192 characters which constrains the number of markers and path vertices that can be specified based on the number of decimal places used when specifying each latitude/longitude pair. For data on how the number of decimal places used relates to the accuracy on the Globe meet the Wikipedia article on Decimal Degrees.

Why can't I access Google Maps Platform products for certain countries?

Maps APIs may non be used in Prohibited Territories. Refer as well to the Terms of Service.

How exercise I written report a problem on the Google basemap?
Send feedback through Google Maps for wrong or missing map data such equally:
  • Wrong addresses or marker locations
  • Incorrect road names
  • Wrong information about one-fashion and two-manner roads
  • Incorrectly fatigued road
  • Closed roads
  • Roads that don't be

For correction of a place or business concern listing, suggest an edit.

If Maps content needs to be removed for legal reasons, submit a legal asking.

For critical or time-sensitive requests, file a support case with specific details on what needs to be fixed.

How is performance monitored for the services used with Maps JavaScript API?

Some client-side features are instrumented to study success or failure for the purpose of computing the SLO (Service Level Objective). This information is sent to Google at maps.googleapis.com/maps_api_js_slo/log in calls that log SLO information. This information includes success status, latency, and version/channel of the Maps JavaScript API in use. The calls may be batched for performance. Please notation that you may need to allow maps.googleapis.com in your Content Security Policy to ensure these calls are not blocked at browser-level. For example: Content-Security-Policy: default-src 'cocky' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> with HTML Meta Tags.

Maps JavaScript API

How long will the Maps JavaScript API work later on it has been loaded?

You need to refresh the folio that loads the Maps JavaScript API at least once every 5 days.

Google Maps SDK for iOS

In Xcode 12, apps exercise not build correctly for the simulator. How can I fix this?

To fix this consequence, open your Xcode projection Build Settings, and add arm64 to the Excluded Architectures for "iOS Simulator" builds only.

For more than data, see the following StackOverflow thread.

How do I resolve the error: kGMSPlacesRateLimitExceeded?
If you are seeing this mistake, yous may exist using a deprecated version of the Places SDK for iOS. Version 2.7.0 of the Places SDK for iOS has been turned off, and is no longer available. Please update your app to use the latest version equally soon every bit possible. Run across the migration guide for details.
I'm getting crashes when debugging with an iOS 8.ten device. What should I do?

If yous feel issues when debugging with devices running iOS 8.ten, follow these steps to disable GPU frame capture in the XCode scheme you are running:

  1. In XCode, choose Production, Scheme, Manage Schemes.
  2. Select a scheme and choose Edit....
  3. Set the GPU Frame Capture option to Disabled. Annotation that this option may not be present for all devices.
What'south the impact of rounded and wider screens on the Google Maps iOS SDK?

Showtime with the iPhone X, iPhones have a screen shape featuring rounded corners, a notch at the top for the device's sensor housing, and an indicator at the bottom of the screen for accessing the Home screen. Every bit of iOS 11.0 SDK, Apple added the Safe Expanse API assuasive developers to position elements in an area which is safe from being clipped by the new screen shape.

The Google Maps iOS SDK has many visual elements and controls, such as an indoor picker and the study a problem link. With version 2.4, these visual elements and controls could be clipped by the new screen shape. In mural mode, the indoor floor picker may be clipped past either the notch or the home button indicator.

With the Google Maps iOS SDK 2.5 release these layout bug are fixed automatically. When your app is used on an iPhone 10 or later, the padding on GMSMapView and GMSPanoramaView are increased so that the visual elements aren't clipped.

By default, we volition always include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the rubber area. If yous design your interface with the assumption that everything is positioned within the safe area, this will piece of work without whatsoever extra effort.

If y'all have designed an interface which doesn't work with our default adjustment, we have introduced a new holding to GMSMapView, called paddingAdjustmentBehavior. GMSMapView now allows you to pick from i of three padding adjustments behaviors: 'Always' (default), 'Automatic', and 'Never'.

If GMSMapView is gear up to employ the 'Always' padding beliefs, it will always add the safety surface area insets to the padding. This allows y'all to design your interface with the supposition that all placement is from the edges of the safe area. This is the default value.

If GMSMapView is gear up to use the 'Automated' padding behavior, it will e'er choose the larger of padding or safe area inset. This will allow y'all to add padding from the screen edge while always ensuring that all elements stay within the safety area.

If GMSMapView is prepare to utilize the 'Never' padding beliefs, it will never add the condom surface area insets to the padding. This is the beliefs prior to the two.5 release and may be useful if your padding already takes into consideration the prophylactic area, or if our other behaviors don't act well with your interface. It is your responsibility to ensure that the Google logo and copyright notices are e'er visible, as specified in the Google Maps Platform Terms of Service.

In contrast, GMSPanoramaView doesn't have an optional padding property. This means that in that location is no padding to adapt and GMSPanoramaView will always employ any necessary padding to ensure that all visual elements are within the prophylactic area.

Google Maps SDK for Android

How do I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If yous are seeing this error, you lot may be using a deprecated version of the Places SDK for Android. The Google Play services version of the Places SDK for Android has been turned off, and is no longer bachelor. Delight update your app to employ the latest version as soon as possible. See the migration guide for details.
My app but shows blank greyness tiles instead of a map. How can I resolve this?

A common reason that a blank grey tiles are shown instead of a map is authentication issues. You can follow the steps below to troubleshoot those issues by using adb logcat.

  1. Make sure you accept adb installed. If not, you can follow the guide hither.
  2. Install the app that shows the trouble on a device or an Android emulator. If you lot utilize Android emulator, make sure the emulator settings has Play Store included.
  3. In Android Studio terminal, run adb logcat -eastward "Google Maps Android API". This will just print lines where the log message matches "Google Maps Android API" (Optionally, yous can output the log to a text file by appending: > logcat.txt)
  4. Reproduce the issue on your device and cheque for common errors such as:
    • The wrong/unintended API Fundamental is existence referenced in Manifest.
    • Billing isn't enabled on Projection.
    • The SDK isn't enabled on project APIs.
    • The incorrect SHA1 fingerprint is added to the API Key restrictions.
    • The Google Play Service dependencies is non included in the build.gradle file.

URL signing

Can I sign URLs using JavaScript?

We strongly recommend against signing URLs using JavaScript as this would betrayal your URL signing clandestine to end users. Therefore signatures should only be generated by server side components.

Why am I receiving a HTTP 403 Forbidden response to my Maps API web service requests?

An HTTP 403 response indicates a permission issue, likely considering the signature could not be verified for this asking. This could exist considering:

  1. A signature has been specified merely is wrong for this request.
  2. The request specifies a Google Maps Platform Premium Plan an API cardinal but does not specify a signature, and the service being chosen requires that requests fabricated using an API fundamental include a valid signature.
  3. A signature has been specified but the associated Google Maps Platform Premium Plan API key has not been specified.