Google Maps Platform FAQ

Getting Started

  • What is the Google Maps Platform?
  • How practice I get started with Google Maps Platform?
  • Which API do I need?
  • How do I first using the APIs on my site?
  • Which countries does the Google Maps Platform embrace?
  • Can I put Google Maps on my site without using Google Maps Platform products?
  • How practise I deliver Maps applications on mobile devices?
  • Which web browsers exercise the Maps JavaScript API and Maps Embed API back up?
  • Tin I print maps from the Maps JavaScript API?
  • How tin can I exist notified when there are changes to Google Maps Platform products?
  • How do I contact technical support?
  • When is technical support available?
  • How practise I recover access to my Google Account?
  • How do I recover access to a specific project?
  • Tin 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 direct access map tiles and satellite imagery?
  • Tin can I use Google Maps Platform products for tracking applications?
  • Tin can I use Google Maps Platform products in my non-Spider web application?
  • Can I employ Google Maps Platform products on a site that is password protected?
  • Can I create an application that includes Google Maps Platform data in a document?
  • How can I opt out of including my content in Google search results?
  • Tin can I generate a map epitome using the Maps Static API which I shop and serve from my website?

Usage limits and billing

  • How do I set up billing for my project?
  • How practise Google Deject Platform Gratuitous Tier customers upgrade to a paid business relationship?
  • Does the Google Maps Platform accept 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 apply Google Maps Platform products?
  • If my web site or application becomes suddenly popular, volition my maps stop working?
  • How volition usage be calculated and billed?
  • How much does it price to utilize the Google Maps Platform?
  • Is pricing available in other currencies?
  • I've set up billing. How practise I view my pecker?
  • How practise I avoid a large bill if my usage unexpectedly increases?
  • I got a message saying that my projection is linked to the "Google Maps Platform Transition Business relationship", merely I don't have admission to that account. What do I do?
  • Why is my quota limit prepare to 1 asking per mean solar day? How can I heighten this limit?
  • I received a billing violation discover. How practice 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 key restriction type from an HTTP referer to an IP address restriction?
  • How exercise I become a new API cardinal?
  • How tin I detect the changes introduced in each version of the Google Maps Platform?
  • How can I load the API into a page asynchronously afterward the page has loaded?
  • How tin I go Google Maps Platform products to display in a language other than English language?
  • 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 employ site cookies?
  • I can't find the respond to my question. Who should I contact?

Errors and troubleshooting

  • What does this mistake mean?
  • My maps appear darker than usual. What'south happening?
  • How practise I resolve the error codes OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
  • How practise I resolve the fault codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
  • How do I resolve the fault: "This IP, site or mobile application is not authorized to utilise 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 available in?
  • Why do 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.Southward. accost on a numbered highway for geocoding?
  • When should I use an API geocoder grade 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 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 can exist displayed using the KmlLayer class 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 past the Maps Static API?
  • Why tin't I access Google Maps Platform products for certain countries?
  • How do I study a trouble on the Google basemap?
  • How is functioning monitored for the services used with Maps JavaScript API?

Google Maps SDK for iOS

  • In Xcode 12, apps practise not build correctly for the simulator. How tin can I fix this?
  • How do I resolve the error: kGMSPlacesRateLimitExceeded?
  • I'm getting crashes when debugging with an iOS 8.x 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 do I resolve the error: 9001 Operation failed due to exceeding the quota usage limit?
  • My app only shows blank grey 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 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 spider web pages, or to think data from Google Maps. There are several offerings. Depending on your needs, you lot may find yourself using 1 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
  • Altitude Matrix API
  • Roads API

Places:

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

See Get Started with Google Maps Platform.

Which API do I need?

For assistance in finding the correct API based on your functional requirements, have a wait at the API picker.

How do I start using the APIs on my site?

Come across the Overview, Developer, and Get Started guides for the specific API or SDK you 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 embrace?

The Google Maps team is constantly pushing new map data out and increasing our international coverage. Consult the Google Maps coverage data for the latest coverage data. Y'all tin 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 change.

Too see:

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

Yeah. 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 awarding, utilise the Maps SDK for Android.

To comprise maps in a native iOS application, apply 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 total JavaScript implementation, such as the Apple 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 be linked to Google Maps.

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

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

Desktop
  • The 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)

Beginning in Baronial 2021, a warning message will announced to Internet Explorer 11 users at the meridian of maps. The last version of the Maps JavaScript API to back up Internet Explorer xi is v3.47. Support for Internet Explorer 11 will exist entirely discontinued in Baronial 2022. This also applies to the IE mode in Edge.

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

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

How tin can I exist notified when there 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 do I contact technical back up?

Come across Google Maps Platform Support and Resource for information about available back up options.

When is technical support available?
The support team is available 24x5 (weekdays from Mon ix a.m. Tokyo time to Fri 5 p.one thousand. Pacific time) excluding regional holidays for "service unusable" issues.
How can I recover access to my Google Account?

If you lost access to your Google Account (eastward.g. joe@mycompany.com or joe@gmail.com), y'all tin try restoring the account access by retrieving or resetting your password. Visit the How to recover your Google Business relationship or Gmail article in Google Account Assistance.

  • Note: To restore access to a K Suite business relationship, ask your System admin to undelete the business relationship.
How can I recover admission to a specific projection?

If you lost access to the project where yous manage your Google Maps Platform implementation, you can try to recover it.

If yous accept access to your project-associated Google Account:

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

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

  • If you lost admission to your Google Business relationship: endeavor to recover your username or password for your account.
  • If you cannot recover access to your Google Account: Create a new Google Business relationship, and so contact an existing project owner and ask them to add together your new Google Business relationship 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, still, it requires building and running on a physical iOS device. This is a temporary limitation while we look into adding more than back up 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 bachelor at:

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

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

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

Withal, there are some uses of the Google Maps Platform that nosotros merely don't want to see: maps that place the places to buy illegal drugs in a city, for example, or any other illegal activeness. Nosotros also respect people's privacy, so the Google Maps Platform shouldn't be used to identify private information nigh individuals.

Y'all should use 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 assistance and are non qualified to offer legal advice. Google reserves the right to suspend or stop your use of the service at any fourth dimension, so delight read the Maps APIs Terms carefully.

Tin I direct access map tiles and satellite imagery?

You may not access map tiles or satellite imagery through any machinery besides the Google Maps Platform (such every bit the creation of your ain mapping API or the use of a majority tile download script). Your application'due south access to the tiles volition be blocked if it accesses them outside of the Google Maps Platform. See the Google Maps Platform Terms of Service for more than details.

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

Tin I use Google Maps in my non-Spider web application?

Yes, Google Maps Platform products tin can now be 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 simply supported when run in ane of the supported browsers.

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

Yes, Google Maps, Routes, Places services tin can exist used with private-access applications. Meet the Google Maps Platform Terms of Service for more than details.

Can I create an awarding 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 run across the Google Maps Platform Terms of Service "No Scraping" department for more details.

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

We are no longer collecting this information. The use of the indexing parameter has been deprecated and has no effect. Y'all 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.

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

You may not shop 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 background-image aspect of an HTML div tag directly to the Maps Static API and then that all map images are displayed inside the HTML content of the web page and served directly to end users by Google.

Usage limits and billing

How do I set billing for my project?
Meet 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 use with any Google Deject 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 lot tin can brand to Google Maps Platform products, and the only 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 following table shows the usage limit for each API.

API Usage limit
Directions 50 QPS
Distance Matrix 1000 EPS
Summit 100 QPS
Geocoding 50 QPS
Geolocation 100 QPS
Dynamic Maps 500 QPS
Static Maps 500 QPS
Street View Image 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 set 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 see the Pricing Sheet.

To learn more about 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 unmarried map load is charged when whatsoever of the post-obit occur:

  • A web folio 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 awarding.

After a web page or application loads a map, or a static map image, or a Street View panorama, whatever user interactions with it, such as panning, zooming, or switching map layers, do non 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 proper name of the API.
  3. Near the peak of the page, click Metrics or Quotas.

To see a traffic study and billing information for an unabridged project, follow these steps:

  1. If y'all haven't already done so, prepare billing.
  2. Go to the Cloud Console billing page.
  3. Select a project.
  4. In the left sidebar, click Reports. Utilise the filters on the correct sidebar to view reports on your billing account.

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

What happens if I exceed the request charge per unit (QPS) limits?

If y'all exceed the QPS limits of a given Google Maps Platform product, the API volition return an error bulletin. If you lot repeatedly exceed the limits, your access to the API may be temporarily blocked.

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

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

Usage limits exceeded

If you exceed the usage limits you volition get an OVER_QUERY_LIMIT status code every bit a response.

This means that the spider web service volition terminate providing normal responses and switch to returning only condition 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 as well many requests per second.

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

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

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

In one case you have a billing business relationship, if you lot exceed the no-accuse, $200-monthly usage limit and you practice non accept a valid payment method on your billing account (credit bill of fare, bank transfer, ...), the API ceases to function until you lot add together a valid payment method.

How will usage be calculated and billed?

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

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

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

Is pricing bachelor in other currencies?

Additional currencies may be available within the console. When yous select a unlike currency, rates volition convert from the USD equivalent listed on our Pricing Canvass.

I've set up billing. How do I view my bill?

Google charges y'all at the beginning of each month for the previous month'south activeness, using your specified payment method. For details about your bill, see our guide to understanding Google Maps Platform billing.

Additional resources:

  • Larn how to view your toll and payment history.
  • Learn how to get an invoice or payment receipt.
  • Larn how to set and manage billing alerts.
How practice I avoid a large neb if my usage unexpectedly increases?

The Google Maps Platform provides ways to set daily request limits and set maximum daily billable limits. You can cap the maximum daily limit on usage to protect against unexpected increases. Yous tin too set up budget alerts to receive email notifications when the charges on the billing account reach a threshold you fix.

Capping the maximum daily billable limit:

To avoid a large bill, y'all tin can set a daily cap on usage to protect against unexpected increases in use. Y'all tin change this limit in the Cloud Console by taking the following steps:

  1. Get to the APIs & Services Dashboard.
  2. Select a project 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, yous can edit multiple quotas for multiple APIs using the IAM & admin Quotas dashboard.

Setting and managing upkeep alerts:

Prepare upwardly budget alerts to send e-mail notifications to billing administrators when the charges on the billing account attain a threshold you lot fix. 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 bulletin saying that my project is linked to the "Google Maps Platform Transition Account", simply I don't have admission to that account. What exercise I do?

The "Google Maps Platform Transition Business relationship" was created to help sure customers transition to our new pay-as-you-get pricing plan. This transition account enabled Google to provide these customers with a one-fourth dimension credit, so that they could proceed using Google Maps Platform up to the limit of the $200 no-charge tier. One time this limit is exceeded, the billing business relationship will shut downwards and you will lose admission to the service. To avoid service interruptions, nosotros urge you to set up your ain billing account, and proceed to enjoy the $200 monthly no-charge tier. To modify the billing account for your project:

  1. Create a new billing business relationship (if y'all already have a billing business relationship, you tin can skip this pace).
  2. Acquaintance the billing account with your project.
Why is my quota limit ready to 1 request per twenty-four hour period? How can I raise this limit?

If you have non created and attached a billing account to your project, your Maps Platform APIs will exist limited to ane asking per day. You can become higher quota by creating and attaching a billing account. To practise this, encounter Get Started with Google Maps Platform.

One time you lot accept created and attached a billing business relationship, your daily quota limit will be removed. You tin decide to set a limit to forbid unexpected spend, in the Cloud Console.

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

You have received this notice because Google has adamant that your business relationship has been using multiple billing accounts. This is a violation of Google'due south terms, as defined in department iii.2.four of the Google Maps Platform Terms of Service. Under these terms, it is forbidden to create multiple billing accounts. To larn more, run across 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 use Google Maps Platform products, yous must include an API key to validate your request. The Google Maps Platform is available for Android, iOS or Web apps, and via HTTP web services.

API Key:

  • An API key is a unique identifier that you generate using the Cloud Console.
  • Example of loading an API with a key: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Digital Signature:

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

Restrictions:

  • API primal restrictions are optional, simply we strongly recommend yous restrict all API keys for greater security. See API security best practices for more details.
  • You can add together an application restriction to the API central. Once restricted, a key will only piece of work on platforms that support that type of restriction. Four types of application restrictions are available. APIs enforcing the same restriction type can utilize the same restricted key.
    • IP addresses (individual servers) - for use with the spider web service APIs.
    • HTTP referrers (web sites) - for use with the web APIs.
    • Android app restriction (by package proper noun and fingerprint) - for use with the Maps SDK for Android.
    • iOS app brake (by iOS bundle identifier) - for utilize with the Maps SDK for iOS.
  • You tin also add an API restriction to the API primal. For more than information, 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 & Application Restriction
Maps SDK for Android API key with Android restriction1
Places SDK for Android API cardinal with Android restriction1
Maps SDK for iOS API key with iOS brake1
Places SDK for iOS API key with iOS restriction1
Maps JavaScript API API key with HTTP referer restrictionane
Maps Static API API cardinal with HTTP referer brake1 + Digital Signature2
Street View Static API API fundamental with HTTP referer restriction1 + Digital Signature2
Maps Embed API API central with HTTP referer restriction1
Directions API API central with IP address restriction1
Distance Matrix API API key with IP address brakei
Summit API API key with IP accost restrictionane
Geocoding API API key with IP address brakeane
Geolocation API API central with IP accost restrictionane
Roads API API primal with IP address brake1
Time Zone API API key with IP accost brake1
Places API API fundamental with IP address brake1

i API cardinal restrictions are optional, only we strongly recommend yous restrict all API keys for greater security.

two 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 yous use both an API key and a digital signature to authenticate your requests.

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

Of import: If y'all 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." Yous should switch to using an API key with IP accost restrictions.

Before you switch the API key brake blazon from HTTP referer to IP address, ensure that all the APIs that apply the API key support the IP restriction blazon. APIs of the same restriction blazon can use the same restricted central. If you need to enforce more than 1 restriction, add a separate key with the required restriction. Come across how to add together a new API key.

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

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

  1. Go to the Credentials page of the Deject Panel.
  2. Select the project that contains the API key you want to edit.
  3. On the Credentials page, from the listing of API keys, select the name of the API key to edit the details of the key.
  4. In the Key brake section of the page, select "IP addresses (web servers, cron jobs, etc.)" and insert the appropriate server IP addresses, so click Salvage.
How do I get a new API central?
See Get Started with Google Maps Platform.
How tin I detect 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 lot can also check which version of the Google Maps Platform a item bug was introduced and stock-still 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 tin can be found in the Getting Started affiliate of the Maps JavaScript API documentation.

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

By default the API will try to load the most appropriate language based on the users location or browser settings. Some APIs let y'all to explicitly prepare a linguistic communication when you make a request. More than information on how to set 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 listing may non be exhaustive and is subject to change.

Language Lawmaking Linguistic communication Linguistic communication Code Language
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Standard arabic km Khmer
hy Armenian ko Korean
az Azerbaijani ky Kyrgyz
eu Basque lo Lao
exist 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 Smoothen
hr Croation 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 (Dandy Britain) sr Serbian
et Estonian si Sinhalese
fa Farsi sk Slovak
fi Finnish sl Slovenian
fil Filipino es Spanish
fr French es-419 Castilian (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 vi Vietnamese
id Indonesian zu Zulu
it Italian

You lot can see what the map volition look like in whatever of the languages listed above in this sample application.

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

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

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

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

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

If yous wish to request a feature, please also first raise information technology in the relevant forum to ostend that a solution that meets your requirements is not already available.

In one case y'all have confirmed that you have identified a new bug, or that your requirements cannot be met by 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 certain to cheque that the bug or characteristic concerned has not already been added. If information technology has, you lot tin star the consequence to annals your interest and be notified of updates.

How practice Google Maps Platform APIs utilise site cookies?

Maps SDK for Android and Maps SDK for iOS apply cookies subject to Google's Privacy Policy, such as calculating daily and 7-solar day active users and service corruption prevention. These cookies are non 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 discover the answer to my question. Who should I contact?

Google's Programmer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and reply site for programmers. Information technology'south a not bad place to ask technical questions about developing and maintaining Google Maps applications. More information about request questions on Stack Overflow is available on the Back up folio.

For best results when requesting help, please proceed the following in mind:

  • Search the current discussions. Chances are someone else has experienced a like issue and found a fix.
  • Submit a link to your site if possible. Only post lawmaking snippets if the code is not 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 error mean?

If you lot 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
  • Peak 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 simply", may be displayed. This behavior typically indicates issues with either an API key or billing. To use Google Maps Platform products, you lot must accept a billing account and all requests must include a valid API key. The post-obit flow will help troubleshoot this:


How do I resolve the error codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
These error codes tin can be returned for any of the following reasons:
  • An API fundamental is missing from the asking.
  • The provided API cardinal is invalid.
  • The projection does not accept 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 carte has expired).
  • You take exceeded the QPS limits for a given API.

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

  • Set up a billing account.
  • Get a new API key.
  • Adjust your usage cap to increase your daily limit (if applicable).
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, y'all may be 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 awarding is not authorized to use this API key."?

There are various scenarios which may cause this mistake:

  • You've enabled IP accost (server) restrictions on your API cardinal, and an unauthorized IP address is attempting a request.
  • You'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 parcel name and fingerprint, and an unauthorized Android app is attempting a request.
  • You'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 spider web service APIs, with an API key with HTTP referer restrictions. Requests to those APIs should be identified with an API primal with IP address restrictions. Switch your key brake type from an HTTP referer restriction to an IP address restriction. For more information about restricting API keys, see API Key All-time Practices.

View and Edit your API Key Credentials

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

  1. Get to the Credentials page of the Cloud Console.
  2. Select the project that contains the API key you lot want to review.
  3. To view credential details, including whatsoever restrictions set for the primal, from the list of API keys, click the name of the key.
  4. The full credentials of the selected API cardinal are displayed, including any restrictions set up for the fundamental. From here, the restrictions can be changed, deleted, or updated as needed.
How do I resolve the fault: "API keys with referer restrictions cannot be used with this API."?

You are using any of the spider web service APIs with an API cardinal restricted to an HTTP referer. For security reasons, web service APIs demand to use API keys restricted to IP addresses. Switch your key restriction type from an HTTP referer restriction to an IP accost brake, 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. Tin I do that with the Google Maps Platform?

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

Alternatively, Google also provides the Geocoding API, which offers a Residual interface that tin respond 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 information.

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

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

The API geocoder and Google Maps geocoder sometimes utilise dissimilar information sets (depending on the country). The API geocoder occasionally gets updated with new information, so you can await to run across 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 accord with the format used by the national postal service of the country concerned.
  • Practise not specify additional accost elements such equally business names, unit numbers, flooring numbers, or suite numbers that are not included in the address as divers past the mail service of the country concerned. Doing so 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 code is a 4 character area lawmaking and six graphic symbol or longer local code (849VCWC8+R9 is 849VCWC8%2BR9).
    • compound code is a 6 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.
  • Do 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 every bit follows:

  • County Roads: "Co Road NNN" where NNN is the road number. eg. "Co Road 82"
  • State Highways: "Land NNN" where State is the full proper noun of the land and NNN is the highway number. eg. "California 82"
  • U.S. Highways: "U.Due south. NNN" where NNN is the highway number. eg. "U.S. 101"
  • U.Southward. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
When should I use an API geocoder class and when should I utilize 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 you shape directions with a travel mode (driving), a unmarried or a set of routes, and restrictions (no toll roads). The service is available in the post-obit forms:

  • HTTP asking/response interface (used in mobile and other applications) is uniform with Maps SDK for Android and with other Google Maps spider web services. Run across the Directions API for more information.
  • JavaScript API, for customer-side applications, allows you to provide driving directions via the google.maps.DirectionsService class. The DirectionsRenderer class tin can automatically create the overlays and directions panel 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 available at these links: Coffee Customer 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 see countries currently supported past Driving Directions in the Google Maps Platform products, consult the Google Maps coverage data. Please note that the availability of driving directions information depends on our contracts with data providers, and is field of study to alter.

In which countries are transit directions bachelor?

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

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 elevation of the map. Documentation and examples tin be plant 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 complexity limits on the display of KML using the KmlLayer form are documented here.

How practise 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 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 you need to develop applications that use KML files hosted on intranet sites we recommend that you render the KML on the customer side by using tertiary-party JavaScript libraries. Every bit the KML file is analyzed past the browser, functioning 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?

In that location 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 exist specified per request, but each can exist used multiple times within the map.

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

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

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

How do I written report a problem on the Google basemap?
Send feedback through Google Maps for incorrect or missing map information such as:
  • Wrong addresses or marker locations
  • Wrong road names
  • Wrong information about ane-style and ii-fashion roads
  • Incorrectly drawn road
  • Closed roads
  • Roads that don't exist

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

If Maps content needs to exist 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 operation monitored for the services used with Maps JavaScript API?

Some client-side features are instrumented to written report 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 functioning. Please notation that y'all 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 'self' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> with HTML Meta Tags.

Google Maps SDK for iOS

In Xcode 12, apps practice not build correctly for the simulator. How tin can I gear up this?

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

For more information, run across the following StackOverflow thread.

How do I resolve the error: kGMSPlacesRateLimitExceeded?
If y'all are seeing this error, yous may exist using a deprecated version of the Places SDK for iOS. Version two.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 as soon as possible. See the migration guide for details.
I'm getting crashes when debugging with an iOS 8.x device. What should I do?

If you experience issues when debugging with devices running iOS viii.10, follow these steps to disable GPU frame capture in the XCode scheme you are running:

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

Beginning with the iPhone Ten, 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. Equally of iOS 11.0 SDK, Apple added the Safe Area API assuasive developers to position elements in an area which is condom 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 report a problem link. With version 2.4, these visual elements and controls could be clipped by the new screen shape. In landscape mode, the indoor floor picker may exist clipped past either the notch or the home button indicator.

With the Google Maps iOS SDK 2.5 release these layout issues 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, we 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 safe area, this will piece of work without any extra effort.

If you lot 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 option from one of iii padding adjustments behaviors: 'Always' (default), 'Automatic', and 'Never'.

If GMSMapView is gear up to use the 'Always' padding behavior, it volition always add the safe surface area insets to the padding. This allows you to design your interface with the supposition that all placement is from the edges of the prophylactic area. This is the default value.

If GMSMapView is fix to use the 'Automatic' padding behavior, it will e'er choose the larger of padding or condom area inset. This will permit you to add together padding from the screen border while e'er ensuring that all elements stay within the safe area.

If GMSMapView is gear up to utilise the 'Never' padding behavior, information technology volition never add the safe expanse insets to the padding. This is the behavior prior to the 2.5 release and may be useful if your padding already takes into consideration the rubber 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 always visible, as specified in the Google Maps Platform Terms of Service.

In contrast, GMSPanoramaView doesn't have an optional padding property. This means that at that place is no padding to adjust and GMSPanoramaView will e'er use any necessary padding to ensure that all visual elements are inside the safe expanse.

Google Maps SDK for Android

How exercise I resolve the mistake: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If you are seeing this mistake, you 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 available. Delight update your app to use the latest version as soon as possible. Run across the migration guide for details.
My app only shows blank grey 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 hallmark problems. You tin follow the steps beneath to troubleshoot those issues by using adb logcat.

  1. Make sure you take adb installed. If not, you can follow the guide here.
  2. Install the app that shows the problem on a device or an Android emulator. If y'all use Android emulator, make sure the emulator settings has Play Store included.
  3. In Android Studio last, run adb logcat -e "Google Maps Android API". This will only print lines where the log message matches "Google Maps Android API" (Optionally, y'all tin output the log to a text file by appending: > logcat.txt)
  4. Reproduce the issue on your device and bank check for common errors such every bit:
    • The wrong/unintended API Fundamental is beingness 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 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 expose your URL signing secret to cease 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 exist verified for this asking. This could exist because:

  1. A signature has been specified simply is incorrect for this request.
  2. The request specifies a Google Maps Platform Premium Plan an API central simply does not specify a signature, and the service existence chosen 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 not been specified.