Google Maps Platform FAQ

Getting Started

  • What is the Google Maps Platform?
  • How do I go started with Google Maps Platform?
  • Which API do I need?
  • How exercise I offset using the APIs on my site?
  • Which countries does the Google Maps Platform comprehend?
  • Tin I put Google Maps on my site without using Google Maps Platform products?
  • How practice I deliver Maps applications on mobile devices?
  • Which web browsers exercise the Maps JavaScript API and Maps Embed API support?
  • Tin I print maps from the Maps JavaScript API?
  • How can I be notified when there are changes to Google Maps Platform products?
  • How do I contact technical support?
  • When is technical back up bachelor?
  • How do I recover access to my Google Account?
  • How practice I recover access to a specific project?
  • Can I use 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 meet the Google Maps Platform Terms of Service?
  • Tin can I directly admission map tiles and satellite imagery?
  • Can I use Google Maps Platform products for tracking applications?
  • Can I use Google Maps Platform products in my non-Web awarding?
  • Tin I utilise Google Maps Platform products on a site that is password protected?
  • Can I create an application that includes Google Maps Platform information in a document?
  • How can I opt out of including my content in Google search results?
  • Tin can I generate a map image using the Maps Static API which I shop and serve from my website?

Usage limits and billing

  • How practise I ready upwards billing for my project?
  • How do Google Cloud Platform Free Tier customers upgrade to a paid account?
  • Does the Google Maps Platform have usage limits?
  • How is usage cost calculated?
  • How are map loads counted on the Google Maps Platform?
  • How practice I monitor my quota usage?
  • What happens if I exceed the usage limits?
  • My site gets a lot of traffic. Tin can I utilize Google Maps Platform products?
  • If my web site or application becomes all of a sudden popular, will my maps stop working?
  • How will usage be calculated and billed?
  • How much does it cost to use the Google Maps Platform?
  • Is pricing bachelor in other currencies?
  • I've ready upwardly billing. How do I view my bill?
  • How do I avert a large nib if my usage unexpectedly increases?
  • I got a message proverb that my project is linked to the "Google Maps Platform Transition Account", but I don't have access to that business relationship. What do I practise?
  • Why is my quota limit set to i request per day? How can I raise this limit?
  • I received a billing violation detect. How practice I resolve this?

Using the Google Maps Platform

  • Which keys or credentials should I employ for dissimilar Google Maps Platform products?
  • How exercise I switch my key restriction type from an HTTP referer to an IP address restriction?
  • How exercise I go a new API primal?
  • How can I find the changes introduced in each version of the Google Maps Platform?
  • How can I load the API into a folio asynchronously after the page has loaded?
  • How can I become Google Maps Platform products to display in a language other than English?
  • Tin can the Google Maps Platform be accessed over SSL (HTTPS)?
  • How do I report a bug or request a new feature in the Google Maps Platform?
  • How do Google Maps Platform APIs utilize site cookies?
  • I tin can't find the respond to my question. Who should I contact?

Errors and troubleshooting

  • What does this error hateful?
  • My maps appear darker than usual. What's happening?
  • How do I resolve the error codes OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
  • How do I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
  • How do I resolve the error: "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. Can I do that with the Google Maps Platform?
  • Which countries is geocoding bachelor in?
  • Why do the Google Maps Platform Geocoders provide unlike 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. accost on a numbered highway for geocoding?
  • When should I use an API geocoder form and when should I use the HTTP Geocoding Service?
  • How do I provide driving directions with the Google Maps Platform?
  • In which countries are driving directions available?
  • In which countries are transit directions bachelor?
  • Which KML and GeoRSS features are supported in the Maps JavaScript API?
  • What are the limits on the size and complexity of KML that can be displayed using the KmlLayer form of the Maps JavaScript API?
  • How practice 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 tin't I access Google Maps Platform products for sure countries?
  • How do I report a trouble on the Google basemap?
  • How is performance monitored for the services used with Maps JavaScript API?

Google Maps SDK for iOS

  • In Xcode 12, apps do not build correctly for the simulator. How can I gear up this?
  • How do I resolve the mistake: kGMSPlacesRateLimitExceeded?
  • I'grand getting crashes when debugging with an iOS 8.x device. What should I do?
  • What's the impact of rounded and wider screens on the Google Maps iOS SDK?

Google Maps SDK for Android

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

URL signing

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

Getting Started

What is the Google Maps Platform?

The Google Maps Platform is a fix of APIs and SDKs that allows developers to embed Google Maps into mobile apps and web pages, or to retrieve information from Google Maps. There are several offerings. Depending on your needs, yous may find 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 exercise I go started with Google Maps Platform?

Meet Go Started with Google Maps Platform.

Which API practise I need?

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

How do I offset using the APIs on my site?

See the Overview, Programmer, and Get Started guides for the specific API or SDK y'all are interested in. For example, check out the guides for Maps SDK for Android or Maps JavaScript API.

Which countries does the Google Maps Platform comprehend?

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

Likewise see:

  • How can I get Google Maps Platform products to display in a linguistic communication other than English?
  • In which countries are transit directions available?
Can 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 lot're viewing into your website or web log, without whatsoever programming or use of the Google Maps Platform. More information is available here.

How exercise I deliver Maps applications on mobile devices?

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

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

The Maps JavaScript API has been developed 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 every bit 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. Note that employ of the Maps Static API outside of browser based applications requires that the map image exist linked to Google Maps.

Which web browsers practice the Maps JavaScript API and Maps Embed API support?

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

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

In club to free up resources to deliver customer-requested features bachelor to modern browsers, Google Maps Platform is ending back up for Internet Explorer 11. Microsoft ended support for IE11 in 2021 and encouraged migration to Microsoft Edge.

Outset in August 2021, a warning message started to announced to Internet Explorer 11 users at the top of maps. The concluding version of the Maps JavaScript API to support Net Explorer 11 is v3.47. Support for Internet Explorer xi will be entirely discontinued in Nov 2022. This also applies to the IE mode in Edge.

Android
  • The electric current version of Chrome on Android iv.i+.
  • Chrome WebView on Android 4.iv+.
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.
Can I impress maps from the Maps JavaScript API?

Printing from the Maps JavaScript API is not supported. This is because printing support is inconsistent beyond commonly used browsers.

How can I be notified when in that location are changes to Google Maps Platform products?

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

How exercise I contact technical support?

See Google Maps Platform Support and Resources for information virtually bachelor support options.

When is technical back up available?
The support team is available 24x5 (weekdays from Monday 9 a.m. Tokyo fourth dimension to Friday 5 p.m. Pacific time) excluding regional holidays for "service unusable" problems.
How can I recover access to my Google Account?

If you lot lost admission to your Google Account (e.g. joe@mycompany.com or joe@gmail.com), you tin can try restoring the account access by retrieving or resetting your password. Visit the How to recover your Google Account or Gmail article in Google Account Aid.

  • Note: To restore access to a G Suite account, inquire your Organisation admin to undelete the account.
How can I recover admission to a specific project?

If you lot lost access to the project where you manage your Google Maps Platform implementation, you lot tin attempt to recover it.

If y'all have access to your project-associated Google Account:

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

If you do non have access to your project-associated Google Business relationship:

  • If yous lost admission to your Google Account: attempt to recover your username or password for your account.
  • If you cannot recover admission to your Google Account: Create a new Google Account, then contact an existing project owner and ask them to add your new Google Business relationship to the project.
Can I utilise the Maps and Places SDK for iOS on Arm-based Macs?

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

Understanding 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 meet 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 merely don't want to see: maps that place the places to buy illegal drugs in a city, for instance, or any other illegal activeness. We as well respect people's privacy, so the Google Maps Platform shouldn't be used to place private information about individuals.

You 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 tin can only offer technical assistance and are not qualified to offer legal advice. Google reserves the right to suspend or terminate your apply of the service at any time, then delight read the Maps APIs Terms advisedly.

Tin I directly admission map tiles and satellite imagery?

You may not access map tiles or satellite imagery through whatever machinery besides the Google Maps Platform (such every bit the creation of your own mapping API or the use of a bulk tile download script). Your application's admission to the tiles volition be blocked if it accesses them exterior of the Google Maps Platform. Run across the Google Maps Platform Terms of Service for more details.

Can I use Google Maps Platform products for tracking applications?

There 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 awarding?

Yes, Google Maps Platform products tin at present exist used in non-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 ane of the supported browsers.

Tin I apply Google Maps Platform products on a site that is password protected?

Aye, Google Maps, Routes, Places services tin exist used with private-admission applications. See the Google Maps Platform Terms of Service for more details.

Can I create an application that includes Google Maps Platform information in a document?

If your application generates a document, either in electronic or printed grade, no data from Google Maps Platform, including images, may exist included in the document. Please see 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 effect. You no longer demand to opt out explicitly, but 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 heart.

Can I generate a map paradigm 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 web pages that require static images must link the src attribute of an HTML img tag or the CSS groundwork-paradigm attribute of an HTML div tag directly to the Maps Static API and then that all map images are displayed within the HTML content of the web folio and served straight to end users past Google.

Usage limits and billing

How practise I set up up billing for my projection?
See Get Started with Google Maps Platform.
How do Google Cloud Platform Free Tier customers upgrade to a paid account?
The Google Cloud Platform Free Tier program provides customers a no-accuse trial with a $300 credit to utilise 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 keep using these services. To upgrade to a paid business relationship, visit the Cloud Console.
Does the Google Maps Platform take usage limits?

There are no maximum daily limits on the number of requests y'all tin can make 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 second (EPS) calculated as the sum of client-side and server-side queries.) The post-obit table shows the usage limit for each API.

API Usage limit
Directions 50 QPS
Distance Matrix 1000 EPS
Pinnacle 100 QPS
Geocoding fifty QPS
Geolocation 100 QPS
Dynamic Maps 500 QPS
Static Maps 500 QPS
Street View Prototype API 500 QPS
Time Zone 500 QPS
Places (except for mobile) 100 QPS
Roads 500 QPS

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

Google Maps Platform products must exist 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 come across the Pricing Sheet.

To acquire more virtually how Google Maps Platform APIs are billed, please encounter Understanding billing for Maps, Routes, and Places.

How are map loads counted on the Google Maps Platform?

A single map load is charged when any of the following occur:

  • A web page or awarding displays a map using the Maps JavaScript API.
  • An application 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 (not-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 application.

Subsequently a spider web folio or application loads a map, or a static map image, or a Street View panorama, any user interactions with it, such as panning, zooming, or switching map layers, practice not generate boosted map loads or impact usage limits.

How do I monitor my usage?

Yous can monitor the usage of individual APIs in the Google Deject Console.

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

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

  1. If you oasis't already done and so, fix billing.
  2. Go to the Cloud Console billing folio.
  3. Select a project.
  4. In the left sidebar, click Reports. Utilize the filters on the right sidebar to view reports on your billing account.

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

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

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

If you exceed the asking QPS limits or otherwise abuse the service, requests volition return a specific error bulletin. If you lot continue to exceed limits, your access to the Google Maps Platform may exist blocked.

Annotation: Four of the spider web service APIs have an equivalent client-side service bachelor in the Maps JavaScript API: Directions, Altitude Matrix, Top, and Geocoding.

Usage limits exceeded

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

This means that the web service volition finish providing normal responses and switch to returning merely status code OVER_QUERY_LIMIT until more usage is allowed again. This can happen within a few seconds, if the mistake was received because your application sent too many requests per 2d.

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

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

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

Once you have a billing account, if y'all exceed the no-charge, $200-monthly usage limit and you lot practice non have a valid payment method on your billing account (credit menu, bank transfer, ...), the API ceases to part until you add a valid payment method.

How volition usage be calculated and billed?

Usage is calculated at the cease of each day, and priced every bit shown in the Pricing Canvas. At the end of every month, the total usage is charged to the payment method associated with your billing business relationship. For more information, encounter Google Maps Platform Billing.

How much does it cost to use the Google Maps Platform?

See the Pricing Sheet for an overview of toll per API. If your awarding generates requests or map load volumes below the gratis $200 per month usage, your usage is not charged. Usage that exceeds the $200 monthly credit will be charged to your billing account. For more than details, run across our guide to understanding Google Maps Platform billing.

Is pricing available in other currencies?

Additional currencies may be bachelor within the console. When you select a dissimilar currency, rates will convert from the USD equivalent listed on our Pricing Sheet.

I've ready billing. How practice I view my bill?

Google charges you at the beginning of each month for the previous month'due south activeness, using your specified payment method. For details about your bill, run across our guide to agreement Google Maps Platform billing.

Boosted resources:

  • Learn how to view your price and payment history.
  • Learn how to go an invoice or payment receipt.
  • Learn how to set and manage billing alerts.
How do I avoid a big nib if my usage unexpectedly increases?

The Google Maps Platform provides ways to gear up daily asking limits and ready maximum daily billable limits. You can cap the maximum daily limit on usage to protect against unexpected increases. Y'all can besides set budget alerts to receive email notifications when the charges on the billing account attain a threshold you lot set.

Capping the maximum daily billable limit:

To avoid a large beak, you lot can set a daily cap on usage to protect against unexpected increases in apply. You tin alter this limit in the Cloud Console past taking the post-obit steps:

  1. Go to the APIs & Services Dashboard.
  2. Select a projection if prompted.
  3. Select an API from the list, then click the Quotas tab.
  4. Click the edit icon next to the "requests per day" quota.

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

Setting and managing budget alerts:

Set up budget alerts to transport 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%, ninety%, and 100% of the threshold.

I got a bulletin saying that my projection is linked to the "Google Maps Platform Transition Account", but I don't have access to that account. What do I do?

The "Google Maps Platform Transition Account" was created to help certain customers transition to our new pay-every bit-yous-go pricing plan. This transition account enabled Google to provide these customers with a one-time credit, and then that they could continue using Google Maps Platform up to the limit of the $200 no-charge tier. Once this limit is exceeded, the billing account will shut down and yous volition lose access to the service. To avoid service interruptions, we urge y'all to set your own billing account, and go on to bask the $200 monthly no-accuse tier. To change the billing account for your projection:

  1. Create a new billing account (if you lot already take a billing account, you tin can skip this step).
  2. Associate the billing business relationship with your project.
Why is my quota limit set to 1 asking per twenty-four hours? How can I raise this limit?

If y'all have non created and fastened a billing account to your project, your Maps Platform APIs volition exist limited to 1 request per day. You can get higher quota past creating and attaching a billing account. To do this, see Become Started with Google Maps Platform.

One time you have created and fastened a billing account, your daily quota limit will exist removed. You tin decide to set up a limit to prevent unexpected spend, in the Cloud Panel.

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

You have received this detect because Google has adamant that your account has been using multiple billing accounts. This is a violation of Google'south terms, equally divers in section three.ii.iv of the Google Maps Platform Terms of Service. Under these terms, information technology is forbidden to create multiple billing accounts. To learn more than, see the Billing Account Violation FAQ.

Using the Google Maps Platform

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

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

API Key:

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

Digital Signature:

  • A digital signature is generated using a URL signing cloak-and-dagger 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, simply nosotros strongly recommend you restrict all API keys for greater security. See API security best practices for more details.
  • You can add an application brake to the API key. Once restricted, a key will only work on platforms that back up that type of restriction. Four types of application restrictions are bachelor. APIs enforcing the same restriction type tin apply the same restricted cardinal.
    • IP addresses (individual servers) - for use with the web service APIs.
    • HTTP referrers (web sites) - for use with the web APIs.
    • Android app restriction (by package name and fingerprint) - for use with the Maps SDK for Android.
    • iOS app restriction (by iOS bundle identifier) - for apply with the Maps SDK for iOS.
  • You can also add an API restriction to the API primal. For more data, see Get, add, and restrict an API key.

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

API/SDK Credential & Awarding Brake
Maps SDK for Android API primal with Android restriction1
Places SDK for Android API key with Android restriction1
Maps SDK for iOS API key with iOS restriction1
Places SDK for iOS API key with iOS restriction1
Maps JavaScript API API key with HTTP referer restriction1
Maps Static API API cardinal with HTTP referer brakeone + Digital Signature2
Street View Static API API key with HTTP referer restriction1 + Digital Signaturetwo
Maps Embed API API key with HTTP referer restriction1
Directions API API key with IP accost restriction1
Altitude Matrix API API key with IP address restriction1
Meridian API API key with IP address restrictionone
Geocoding API API key with IP address brake1
Geolocation API API cardinal with IP address restriction1
Roads API API primal with IP address brake1
Time Zone API API key with IP accost restriction1
Places API API key with IP address restrictionane

1 API key restrictions are optional, but we 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 use both an API central and a digital signature to authenticate your requests.

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

Important: If you are using any of the web service APIs with an API key that has referer restrictions, your requests volition neglect with the error message: "API keys cannot accept referer restrictions when used with this API." You should switch to using an API central with IP address restrictions.

Before you switch the API fundamental restriction blazon from HTTP referer to IP address, ensure that all the APIs that employ the API key back up the IP restriction type. APIs of the same restriction blazon can use the same restricted key. If you need to enforce more than i restriction, add a split up key with the required restriction. See how to add a new API key.

Acquire more about API key restrictions associated with Google Maps Platform products.

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

  1. Go to the Credentials page of the Cloud Console.
  2. Select the projection that contains the API primal yous want to edit.
  3. On the Credentials page, from the list of API keys, select the proper name of the API central to edit the details of the key.
  4. In the Cardinal restriction section of the folio, select "IP addresses (web servers, cron jobs, etc.)" and insert the advisable server IP addresses, so click Save.
How practice I get a new API key?
Run across Go Started with Google Maps Platform.
How can I notice the changes introduced in each version of the Google Maps APIs?

Version change data for many of the Maps APIs are available at the post-obit 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

Yous can also check which version of the Google Maps Platform a detail bug was introduced and fixed in using the Google Maps Platform Issue Tracker at:

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

How can I load the API into a page asynchronously afterwards the page has loaded?

Just specify the callback parameter when loading the API. More data and sample code can be found in the Getting Started chapter of the Maps JavaScript API documentation.

How can I go Google Maps Platform products to brandish in a language other than English?

Past default the API will attempt to load the nigh appropriate language based on the users location or browser settings. Some APIs let you to explicitly fix a language when you lot make a asking. More information on how to prepare the linguistic communication is bachelor in the documentation for each API:

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

Google frequently updates supported languages. This list may not be exhaustive and is discipline to change.

Language Code Language Language Code Linguistic communication
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Arabic km Khmer
hy Armenian ko Korean
az Azerbaijani ky Kyrgyz
european union 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 Marāthi
zh Chinese mn Mongolian
zh-CN Chinese (Simplified) ne Nepali
zh-HK Chinese (Hong Kong) no Norwegian
zh-TW Chinese (Traditional) pl Polish
60 minutes Croatian pt Portuguese
cs Czech pt-BR Portuguese (Brazil)
da Danish pt-PT Portuguese (Portugal)
nl Dutch pa Punjabi
en English ro Romanian
en-AU English (Australian) ru Russian
en-GB English (United kingdom) sr Serbian
et Estonian si Sinhalese
fa Persian sk Slovak
fi Finnish sl Slovenian
fil Filipino es Castilian
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 thursday Thai
gu Gujarati tr Turkish
iw Hebrew u.k. Ukrainian
hi Hindi ur Urdu
hu Hungarian uz Uzbek
is Icelandic six Vietnamese
id Indonesian zu Zulu
information technology Italian

You can see what the map will look like in whatever of the languages listed higher up in this sample application.

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

The Maps JavaScript API, Maps Static API, and Spider web Service APIs tin exist accessed over secure (HTTPS) connections. Please encounter the documentation for the API concerned for information on how to admission the API over SSL.

Note that the Maps Static API does not support custom icon URLs that utilise HTTPS; the default icon volition exist displayed.

How practise I report a bug or request a new feature in the Google Maps Platform?

If you feel behavior that y'all believe may be a bug, please begin by raising information technology in the relevant forum. This will permit other developers to validate the issues, and rule out any potential bug with your code.

If you wish to request a characteristic, please as well starting time heighten it in the relevant forum to confirm that a solution that meets your requirements is non already available.

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

Before adding a bug or feature request to the Issue Tracker please exist sure to check that the bug or characteristic concerned has not already been added. If it has, you can star the upshot to annals your involvement and exist notified of updates.

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS apply cookies subject area to Google'southward Privacy Policy, such as computing daily and 7-day agile users and service abuse prevention. These cookies are not associated with any signed-in Google Business relationship and are not logged with the rest of the information collected from the API calls.

I tin't find the answer to my question. Who should I contact?

Google'south Programmer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and answer site for programmers. It'due south a great identify to ask technical questions about developing and maintaining Google Maps applications. More information virtually asking questions on Stack Overflow is available on the Support page.

For all-time results when requesting help, please keep the post-obit in mind:

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

Errors and troubleshooting

What does this fault mean?

If y'all encounter an mistake while loading or running the Google Maps APIs, please run across the following links to observe explanations for the mistake codes:

  • Maps JavaScript API
  • Maps Static API
  • Street View Static API
  • Maps Embed API
  • Elevation 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'southward happening?

Under sure circumstances, a darkened map, or 'negative' Street View image, watermarked with the text "for evolution purposes only", may be displayed. This behavior typically indicates issues with either an API fundamental or billing. To utilise Google Maps Platform products, you must have a billing account and all requests must include a valid API fundamental. The post-obit flow will help 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 key is missing from the request.
  • The provided API fundamental is invalid.
  • The projection does non have a billing account attached.
  • A self-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for case, a credit card has expired).
  • Y'all have exceeded the QPS limits for a given API.

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

  • Prepare a billing account.
  • Get a new API key.
  • Adjust your usage cap to increment your daily limit (if applicative).
How do I resolve the mistake codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If you are seeing kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED, yous may exist using a deprecated version of the Places SDK for Android or Places SDK for iOS. Learn more and find 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 apply this API fundamental."?

There are various scenarios which may crusade this error:

  • You've enabled IP address (server) restrictions on your API key, and an unauthorized IP accost is attempting a request.
  • You lot've enabled HTTP referrer (website) restrictions on your API key, and an unauthorized referrer is attempting a request.
  • Y'all've restricted usage to your Android apps by setting a package name and fingerprint, and an unauthorized Android app is attempting a request.
  • You lot'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 central with HTTP referer restrictions. Requests to those APIs should be identified with an API primal with IP accost restrictions. Switch your cardinal restriction type from an HTTP referer restriction to an IP address restriction. For more data nearly restricting API keys, come across API Fundamental Best Practices.

View and Edit your API Key Credentials

To view your API keys and manage any restrictions, practice 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 prepare 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 for the key. From here, the restrictions can be changed, 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 any of the web service APIs with an API key restricted to an HTTP referer. For security reasons, web service APIs demand to utilise API keys restricted to IP addresses. Switch your key restriction type from an HTTP referer restriction to an IP address restriction, or create a new API fundamental if your primal is already used with the Maps JavaScript API.

Google Maps Platform Services

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

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

Alternatively, Google also provides the Geocoding API, which offers a Rest interface that can answer in JSON and XML formats.

Which countries is geocoding available in?

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

The accurateness of geocoded locations may vary per country, then you should consider using the returned location_type field to determine if a proficient enough friction match has been found for the purposes of your application. Please notation that the availability of geocoding information depends on our contracts with data providers, and so it is subject to alter.

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

The API geocoder and Google Maps geocoder sometimes use dissimilar data sets (depending on the country). The API geocoder occasionally gets updated with new data, so you tin can expect to see results changing or improving over time.

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 state concerned.
  • Do not specify additional accost elements such as business names, unit numbers, floor numbers, or suite numbers that are not included in the address as divers by the postal service of the state concerned. Doing and then may result in responses with ZERO_RESULTS.
  • Format plus codes as shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %20):
    • global lawmaking is a four character expanse code and 6 character or longer local code (849VCWC8+R9 is 849VCWC8%2BR9).
    • compound lawmaking is a vi character or longer local code with an explicit location (CWC8+R9 Mountain View, CA, Us is CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Employ the street number of a premise in preference to the edifice name where possible.
  • Use street number addressing in preference to specifying cantankerous streets where possible.
  • Exercise not 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:

  • County Roads: "Co Road NNN" where NNN is the road number. eg. "Co Road 82"
  • State Highways: "State NNN" where State is the full name of the state and NNN is the highway number. eg. "California 82"
  • U.S. Highways: "U.South. NNN" where NNN is the highway number. eg. "U.S. 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 apply 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 assistance you shape directions with a travel way (driving), a single or a set of routes, and restrictions (no cost roads). The service is available in the following forms:

  • HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps web services. Meet the Directions API for more information.
  • JavaScript API, for client-side applications, allows you to provide driving directions via the google.maps.DirectionsService class. The DirectionsRenderer course can automatically create the overlays and directions panel for you. Boosted examples are provided in the documentation.
  • Java, Python, go, and Node.js client interfaces, for server-side applications, provide the same functionality. Reference documentation is available at these links: Java Client for Google Maps Services, Python Client for Google Maps Services, Go Client for Google Maps Services, and Node.js Client for Google Maps Services.
In which countries are driving directions available?

To come across countries currently supported by Driving Directions in the Google Maps Platform products, consult the Google Maps coverage data. Please note that the availability of driving directions data depends on our contracts with data providers, and is subject to alter.

In which countries are transit directions available?

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

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

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

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

The size and complication limits on the brandish of KML using the KmlLayer form are documented here.

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

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

If y'all need to develop applications that employ KML files hosted on intranet sites we recommend that you render the KML on the client side by using third-party JavaScript libraries. As the KML file is analyzed by the browser, functioning may be lower than by using the KmlLayer grade.

What is the maximum number of markers or path vertices supported past 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, up to five unique icons can be specified per request, simply each tin can be used multiple times inside the map.

Note that Maps Static API URLs can incorporate a maximum of approximately 8,192 characters which constrains the number of markers and path vertices that tin be specified based on the number of decimal places used when specifying each breadth/longitude pair. For information on how the number of decimal places used relates to the accuracy on the World see the Wikipedia commodity 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 do I report a problem on the Google basemap?
Transport feedback through Google Maps for wrong or missing map information such as:
  • Wrong addresses or marker locations
  • Incorrect road names
  • Wrong information most i-way and two-style roads
  • Incorrectly drawn route
  • Closed roads
  • Roads that don't exist

For correction of a place or business organization list, suggest an edit.

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

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

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

Some client-side features are instrumented to report success or failure for the purpose of calculating 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 condition, latency, and version/aqueduct of the Maps JavaScript API in employ. The calls may be batched for performance. Please annotation that you may need to permit 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 'self' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'cocky' maps.googleapis.com;"> with HTML Meta Tags.

Google Maps SDK for iOS

In Xcode 12, apps do non build correctly for the simulator. How can I gear up this?

To set this outcome, open your Xcode project Build Settings, and add arm64 to the Excluded Architectures for "iOS Simulator" builds just.

For more than data, see the following StackOverflow thread.

How do I resolve the fault: kGMSPlacesRateLimitExceeded?
If you lot are seeing this mistake, you lot may be using a deprecated version of the Places SDK for iOS. Version two.seven.0 of the Places SDK for iOS has been turned off, and is no longer available. Please update your app to utilise the latest version as before long as possible. Run into the migration guide for details.
I'1000 getting crashes when debugging with an iOS viii.x device. What should I do?

If y'all experience 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 Product, Scheme, Manage Schemes.
  2. Select a scheme and cull Edit....
  3. Fix the GPU Frame Capture option to Disabled. Notation that this option may not be present for all devices.
What's the touch of rounded and wider screens on the Google Maps iOS SDK?

Starting time with the iPhone 10, iPhones have a screen shape featuring rounded corners, a notch at the tiptop for the device's sensor housing, and an indicator at the bottom of the screen for accessing the Home screen. As of iOS eleven.0 SDK, Apple tree added the Condom Area API allowing developers to position elements in an expanse which is safe from being clipped by the new screen shape.

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

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

By default, nosotros will always include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe area. If you design your interface with the assumption that everything is positioned within the prophylactic area, this will work without any extra effort.

If you lot accept designed an interface which doesn't work with our default adjustment, we have introduced a new property to GMSMapView, called paddingAdjustmentBehavior. GMSMapView at present allows you to selection from one of three padding adjustments behaviors: 'Always' (default), 'Automatic', and 'Never'.

If GMSMapView is set to use the 'Always' padding behavior, it volition always add together the safe area insets to the padding. This allows you to blueprint your interface with the supposition that all placement is from the edges of the safe expanse. This is the default value.

If GMSMapView is fix to use the 'Automatic' padding behavior, information technology will always cull the larger of padding or safe area inset. This will allow you lot to add padding from the screen edge while always ensuring that all elements stay inside the safety surface area.

If GMSMapView is set to employ the 'Never' padding behavior, it will never add the safety area insets to the padding. This is the behavior prior to the 2.v release and may exist useful if your padding already takes into consideration the prophylactic surface 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 there is no padding to adjust and GMSPanoramaView will always apply any necessary padding to ensure that all visual elements are within the rubber surface area.

Google Maps SDK for Android

How practice I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If you are seeing this error, you may exist 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 available. Please update your app to use the latest version as before long every bit possible. See the migration guide for details.
My app only shows blank grayness tiles instead of a map. How can I resolve this?

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

  1. Make sure y'all take adb installed. If non, you can follow the guide hither.
  2. Install the app that shows the trouble on a device or an Android emulator. If you utilise Android emulator, brand sure the emulator settings has Play Store included.
  3. In Android Studio terminal, run adb logcat -e "Google Maps Android API". This will merely print lines where the log message matches "Google Maps Android API" (Optionally, you can output the log to a text file by appending: > logcat.txt)
  4. Reproduce the issue on your device and check for common errors such as:
    • The wrong/unintended API Fundamental is existence referenced in Manifest.
    • Billing isn't enabled on Project.
    • The SDK isn't enabled on project APIs.
    • The incorrect SHA1 fingerprint is added to the API Primal restrictions.
    • The Google Play Service dependencies is not 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 expose your URL signing secret to end users. Therefore signatures should only exist generated past 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 consequence, likely because the signature could not be verified for this request. This could exist considering:

  1. A signature has been specified just is incorrect for this request.
  2. The request specifies a Google Maps Platform Premium Program an API central but does not specify a signature, and the service being called requires that requests made using an API key include a valid signature.
  3. A signature has been specified but the associated Google Maps Platform Premium Plan API key has non been specified.