Google Maps Platform FAQ

Getting Started

  • What is the Google Maps Platform?
  • How do I become started with Google Maps Platform?
  • Which API do I need?
  • How do I start using the APIs on my site?
  • Which countries does the Google Maps Platform encompass?
  • Can I put Google Maps on my site without using Google Maps Platform products?
  • How do I evangelize Maps applications on mobile devices?
  • Which spider web browsers practise the Maps JavaScript API and Maps Embed API support?
  • Can I print maps from the Maps JavaScript API?
  • How 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?
  • Can I utilise the Maps and Places SDK for iOS on Arm-based Macs?

Understanding the terms of service

  • What are the terms of service for Google Maps Platform products?
  • Does my site see the Google Maps Platform Terms of Service?
  • Can I directly access map tiles and satellite imagery?
  • Can I utilize Google Maps Platform products for tracking applications?
  • Can I employ Google Maps Platform products in my non-Web awarding?
  • Tin can I apply Google Maps Platform products on a site that is password protected?
  • Tin 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?
  • Can I generate a map image using the Maps Static API which I store and serve from my website?

Usage limits and billing

  • How do I set upwardly billing for my projection?
  • How practise Google Cloud Platform Gratuitous Tier customers upgrade to a paid business relationship?
  • Does the Google Maps Platform have usage limits?
  • How is usage cost calculated?
  • How are map loads counted on the Google Maps Platform?
  • How do I monitor my quota usage?
  • What happens if I exceed the usage limits?
  • My site gets a lot of traffic. Can I use Google Maps Platform products?
  • If my spider web site or application becomes suddenly pop, will my maps stop working?
  • How will usage be calculated and billed?
  • How much does it cost to employ the Google Maps Platform?
  • Is pricing available in other currencies?
  • I've set up billing. How practice I view my bill?
  • How practise I avoid a big beak if my usage unexpectedly increases?
  • I got a message saying 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 do?
  • Why is my quota limit set to 1 asking per day? How can I raise this limit?
  • I received a billing violation notice. How do I resolve this?

Using the Google Maps Platform

  • Which keys or credentials should I employ for different Google Maps Platform products?
  • How practice I switch my fundamental brake type from an HTTP referer to an IP address restriction?
  • How practice I get a new API cardinal?
  • How tin 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 folio has loaded?
  • How tin I get Google Maps Platform products to brandish in a language other than English?
  • Can the Google Maps Platform exist accessed over SSL (HTTPS)?
  • How do I written 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 detect the answer to my question. Who should I contact?

Errors and troubleshooting

  • What does this error mean?
  • My maps appear darker than usual. What's happening?
  • How practice I resolve the fault 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 awarding 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 demand 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 dissimilar locations than Google Maps?
  • How should I format my geocoder queries to maximise the number of successful requests?
  • How should I format a U.S. address on a numbered highway for geocoding?
  • When should I use an API geocoder class and when should I employ 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 be displayed using the KmlLayer grade of the Maps JavaScript API?
  • How practise 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 can't I access Google Maps Platform products for certain countries?
  • How exercise I report a problem on the Google basemap?
  • How is performance monitored for the services used with Maps JavaScript API?

Maps JavaScript API

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

Google Maps SDK for iOS

  • In Xcode 12, apps do non build correctly for the simulator. How can I ready this?
  • How practise I resolve the error: kGMSPlacesRateLimitExceeded?
  • I'yard getting crashes when debugging with an iOS 8.10 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 mistake: 9001 Operation failed due to exceeding the quota usage limit?
  • My app simply shows bare 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 web pages, or to retrieve data from Google Maps. There are several offerings. Depending on your needs, y'all 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 get started with Google Maps Platform?

Meet Get Started with Google Maps Platform.

Which API do I need?

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

How do I beginning using the APIs on my site?

Come across the Overview, Developer, and Get Started guides for the specific API or SDK you lot are interested in. For case, bank check out the guides for Maps SDK for Android or Maps JavaScript API.

Which countries does the Google Maps Platform cover?

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

Besides see:

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

Aye. Google Maps at present offers the ability to embed the map that you're viewing into your website or blog, without whatever programming or use of the Google Maps Platform. More data is available here.

How practice I evangelize Maps applications on mobile devices?

To contain maps in an Android application, use 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 adult to cater to mobile devices, and is suitable for browser applications targeted at both the desktop and devices that include a web browser with a full JavaScript implementation, such as the Apple 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. Notation 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 exercise the Maps JavaScript API and Maps Embed API back up?

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

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

In order to free up resources to evangelize customer-requested features available to modern browsers, Google Maps Platform is catastrophe support for Cyberspace Explorer 11. Microsoft concluded support for IE11 in 2021 and encouraged migration to Microsoft Edge.

Beginning in Baronial 2021, a warning bulletin started to appear to Cyberspace Explorer 11 users at the top of maps. The last version of the Maps JavaScript API to support Internet Explorer 11 is v3.47. Back up for Internet Explorer 11 volition be entirely discontinued in Nov 2022. This too applies to the IE mode in Edge.

Android
  • The current version of Chrome on Android 4.1+.
  • Chrome WebView on Android four.four+.
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 current version of Chrome for iOS.
Can I print maps from the Maps JavaScript API?

Press from the Maps JavaScript API is not supported. This is because printing support is inconsistent across ordinarily used browsers.

How can I be notified when at that place 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 support?

Encounter Google Maps Platform Support and Resource for information nearly available back up options.

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

If you lost access to your Google Account (east.thousand. joe@mycompany.com or joe@gmail.com), you tin can endeavour restoring the business relationship access by retrieving or resetting your password. Visit the How to recover your Google Account or Gmail article in Google Account Assist.

  • Notation: To restore access to a G Suite account, ask your System admin to undelete the account.
How tin can I recover access to a specific project?

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

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

  • If yous know the Project Owner and take admission to your Google Account: Inquire the Project Owner to add you as a Project Owner or Project Editor.
    • If your projection is part of an Organisation: Contact your Organization admins and ask them to add you equally a Projection Owner.
  • If you practise not know any of the current Project Owners: If you lot don't know who the Project Owner is, or the Projection Owner is unavailable, contact the back up squad to explore additional options to recover the projection.

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

  • If you lost access to your Google Account: try to recover your username or password for your business relationship.
  • If you cannot recover access to your Google Account: Create a new Google Account, then contact an existing project owner and inquire them to add together your new Google Business relationship to the project.
Tin can I employ the Maps and Places SDK for iOS on Arm-based Macs?

Developing on the new Arm-based Macs is possible, even so, it requires building and running on a physical iOS device. This is a temporary limitation while nosotros look 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://deject.google.com/maps-platform/terms

Does my site come across the Google Maps Platform Terms of Service?

You tin utilize the Google Maps Platform within your applications equally long as your site meets the Google Maps Platform Terms of Service.

All the same, there are some uses of the Google Maps Platform that we but don't desire to come across: maps that identify the places to buy illegal drugs in a city, for case, or any other illegal activity. Nosotros also respect people'southward privacy, so the Google Maps Platform shouldn't be used to identify private data about individuals.

You should use your ain counsel to determine whether your application complies with the Google Maps Platform Terms of Service earlier you develop and launch it. Google engineers tin can merely offering technical assistance and are non qualified to offer legal advice. Google reserves the right to suspend or terminate your employ of the service at any time, so please read the Maps APIs Terms carefully.

Tin can I directly admission map tiles and satellite imagery?

You may not access map tiles or satellite imagery through whatsoever mechanism besides the Google Maps Platform (such as the creation of your own mapping API or the employ of a majority tile download script). Your application's admission to the tiles volition exist blocked if it accesses them outside of the Google Maps Platform. See the Google Maps Platform Terms of Service for more details.

Tin can I utilise Google Maps Platform products for tracking applications?

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

Tin can I use Google Maps in my non-Web application?

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

The Maps JavaScript API is only supported when run in one of the supported browsers.

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

Yes, Google Maps, Routes, Places services tin can be 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 data in a document?

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

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

We are no longer collecting this data. The utilize of the indexing parameter has been deprecated and has no upshot. You no longer demand to opt out explicitly, merely 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 help centre.

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

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

Usage limits and billing

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

At that place are no maximum daily limits on the number of requests you tin can make to Google Maps Platform products, and the merely usage limits are related to the maximum number of queries per second (QPS). (For Distance Matrix, the limit is fix in events per second (EPS) calculated every bit 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 grand EPS
Summit 100 QPS
Geocoding 50 QPS
Geolocation 100 QPS
Dynamic Maps 500 QPS
Static Maps 500 QPS
Street View Paradigm 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 ready daily limits to all requests to any billable API.

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

How is usage price calculated?

For an overview of pricing for the Google Maps Platform products, please see the Pricing Canvass.

To learn more most how Google Maps Platform APIs are billed, delight 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 any of the following occur:

  • A web page or application displays a map using the Maps JavaScript API.
  • An awarding requests a unmarried 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 asking to the Street View Static API to embed a static (non-interactive) Street View panorama.
  • A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOS awarding.

Afterwards a web folio or application loads a map, or a static map image, or a Street View panorama, whatever user interactions with it, such equally panning, zooming, or switching map layers, do not generate additional map loads or touch on usage limits.

How do I monitor my usage?

You tin monitor the usage of individual APIs in the Google Deject Console.

  1. Select the projection that contains the API you want to review.
  2. From the listing of APIs on the Dashboard, click the name of the API.
  3. Almost the superlative of the page, click Metrics or Quotas.

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

  1. If you oasis't already washed so, prepare up billing.
  2. Go to the Cloud Console billing page.
  3. Select a projection.
  4. In the left sidebar, click Reports. Use the filters on the correct sidebar to view reports on your billing account.

To learn more, see Google Maps Platform Reporting every bit well equally 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 render an mistake bulletin. If y'all repeatedly exceed the limits, your access to the API may exist temporarily blocked.

If you exceed the asking QPS limits or otherwise corruption the service, requests volition return a specific error message. If you continue to exceed limits, your admission to the Google Maps Platform may be blocked.

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

Usage limits exceeded

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

This means that the web service will stop providing normal responses and switch to returning only status lawmaking OVER_QUERY_LIMIT until more than usage is allowed again. This can happen within a few seconds, if the mistake was received considering your awarding sent as well many requests per 2d.

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

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

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

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

How will usage be calculated and billed?

Usage is calculated at the cease of each twenty-four hours, and priced equally shown in the Pricing Canvass. At the finish of every month, the total usage is charged to the payment method associated with your billing business relationship. For more data, run across Google Maps Platform Billing.

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

See the Pricing Sail for an overview of cost per API. If your application generates requests or map load volumes below the free $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 details, see our guide to understanding Google Maps Platform billing.

Is pricing bachelor in other currencies?

Additional currencies may be bachelor inside the console. When yous select a different currency, rates volition convert from the USD equivalent listed on our Pricing Sheet.

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

Google charges you lot at the commencement of each month for the previous month'due south activity, using your specified payment method. For details about your bill, see our guide to understanding Google Maps Platform billing.

Boosted resources:

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

The Google Maps Platform provides means to set daily request limits and gear up maximum daily billable limits. Yous can cap the maximum daily limit on usage to protect against unexpected increases. You can also set upkeep alerts to receive email notifications when the charges on the billing business relationship accomplish a threshold y'all set.

Capping the maximum daily billable limit:

To avoid a large nib, you tin can fix a daily cap on usage to protect against unexpected increases in utilise. You lot tin can change this limit in the Cloud Console by taking the following steps:

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

Alternatively, y'all tin can edit multiple quotas for multiple APIs using the IAM & admin Quotas dashboard.

Setting and managing budget alerts:

Set up budget alerts to send email notifications to billing administrators when the charges on the billing account reach a threshold you set up. Billing administrators will be sent email notifications when the estimated charges on the billing account exceed 50%, 90%, and 100% of the threshold.

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

The "Google Maps Platform Transition Account" was created to help certain customers transition to our new pay-equally-you lot-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 business relationship will close downwardly and you will lose access to the service. To avoid service interruptions, we urge you to set your own billing account, and go along to enjoy the $200 monthly no-charge tier. To modify the billing account for your project:

  1. Create a new billing account (if you already have a billing account, y'all can skip this step).
  2. Associate the billing account with your project.
Why is my quota limit set to ane request per day? How tin can I heighten this limit?

If yous have non created and attached a billing business relationship to your projection, your Maps Platform APIs volition be limited to 1 request per twenty-four hours. You can go college quota by creating and attaching a billing business relationship. To do this, encounter Get Started with Google Maps Platform.

In one case you have created and fastened a billing business relationship, your daily quota limit will be removed. You tin make up one's mind to set a limit to preclude unexpected spend, in the Deject Console.

I received a billing violation find. How practice I resolve this?

Yous accept received this notice because Google has determined that your account has been using multiple billing accounts. This is a violation of Google'southward terms, as defined in section iii.2.4 of the Google Maps Platform Terms of Service. Nether these terms, it is forbidden to create multiple billing accounts. To larn more, come across the Billing Business relationship Violation FAQ.

Using the Google Maps Platform

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

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

API Cardinal:

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

Digital Signature:

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

Restrictions:

  • API key restrictions are optional, simply we strongly recommend you restrict all API keys for greater security. See API security best practices for more details.
  • Yous can add an application restriction to the API key. Once restricted, a cardinal will but piece of work on platforms that support that type of restriction. Four types of awarding restrictions are available. APIs enforcing the same restriction type can use the aforementioned restricted cardinal.
    • IP addresses (private servers) - for use with the web service APIs.
    • HTTP referrers (spider web sites) - for use with the web APIs.
    • Android app restriction (past package proper name and fingerprint) - for use with the Maps SDK for Android.
    • iOS app restriction (past iOS package identifier) - for employ with the Maps SDK for iOS.
  • You lot can too add an API restriction to the API key. For more than 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 Restriction
Maps SDK for Android API key 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 central with HTTP referer restriction1 + Digital Signatureii
Street View Static API API central with HTTP referer brake1 + Digital Signature2
Maps Embed API API central with HTTP referer restriction1
Directions API API central with IP address brakeone
Distance Matrix API API central with IP accost restrictioni
Pinnacle API API key with IP address restriction1
Geocoding API API key with IP accost restriction1
Geolocation API API key with IP accost restriction1
Roads API API fundamental with IP address brake1
Time Zone API API key with IP address restrictionane
Places API API key with IP address restriction1

i API key restrictions are optional, but we strongly recommend y'all 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 you utilize both an API key and a digital signature to authenticate your requests.

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

Important: If you are using whatsoever of the web service APIs with an API key that has referer restrictions, your requests volition fail with the error bulletin: "API keys cannot have referer restrictions when used with this API." Yous should switch to using an API key with IP address restrictions.

Before y'all switch the API primal restriction type from HTTP referer to IP address, ensure that all the APIs that use the API fundamental support the IP restriction type. APIs of the aforementioned restriction blazon can use the same restricted key. If you need to enforce more than one restriction, add a separate 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, practise the following:

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

Version alter information 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

Y'all can also cheque which version of the Google Maps Platform a particular problems was introduced and fixed in using the Google Maps Platform Outcome Tracker at:

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

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

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

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

By default the API will attempt to load the most advisable language based on the users location or browser settings. Some APIs allow you to explicitly set a linguistic communication when you brand 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 list may non exist exhaustive and is bailiwick to modify.

Language Code Linguistic communication Language Code Language
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Arabic km Khmer
hy Armenian ko Korean
az Azerbaijani cluster ky Kyrgyz
eu Basque lo Lao
be Belarusian lv Latvian
bn Bengali lt Lithuanian
bs Bosnian mk Macedonian
bg Bulgarian ms Malay
my Burmese ml Malayalam
ca Catalan mr Marä thi
zh Chinese mn Mongolian
zh-CN Chinese (Simplified) ne Nepali
zh-HK Chinese (Hong Kong) no Norwegian
zh-TW Chinese (Traditional) pl Smooth
hr Croatian pt Portuguese
cs Czech pt-BR Portuguese (Brazil)
da Danish pt-PT Portuguese (Portugal)
nl Dutch pa Panjabi
en English ro Romanian
en-AU English (Australian) ru Russian
en-GB English (United kingdom of great britain and northern ireland) sr Serbian
et Estonian si Sinhalese
fa Farsi 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 language te Telugu
el Greek th Thai
gu Gujarati tr Turkish
iw Hebrew britain Ukrainian
hi Hindi ur Urdu
hu Hungarian uz Uzbek
is Icelandic vi Vietnamese
id Indonesian zu Zulu
it Italian

You tin can see what the map will look like in any of the languages listed above in this sample application.

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

The Maps JavaScript API, Maps Static API, and Web Service APIs can be accessed over secure (HTTPS) connections. Please see 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 use HTTPS; the default icon will exist displayed.

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

If yous experience behavior that y'all believe may be a bug, please begin past raising it in the relevant forum. This volition allow other developers to validate the problems, and rule out any potential issues with your lawmaking.

If y'all wish to request a feature, delight also first raise it in the relevant forum to confirm that a solution that meets your requirements is not already available.

One time you have confirmed that you have identified a new bug, or that your requirements cannot exist met by the existing functionality of the Google Maps Platform products, please written report your bug or characteristic asking using the Google Maps Platform Event Tracker.

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

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS use cookies subject to Google'southward Privacy Policy, such as calculating daily and 7-twenty-four hours agile users and service abuse prevention. These cookies are not associated with whatever signed-in Google Account and are non logged with the rest of the information collected from the API calls.

I can't find the reply to my question. Who should I contact?

Google's Programmer Relations squad maintains a presence on Stack Overflow — a collaboratively-edited question and respond site for programmers. It's a peachy identify to ask technical questions about developing and maintaining Google Maps applications. More information about asking questions on Stack Overflow is available on the Back up page.

For best results when requesting assist, delight continue the following in mind:

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

Errors and troubleshooting

What does this mistake mean?

If you encounter an fault while loading or running the Google Maps APIs, please encounter the following links to find 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
  • Altitude Matrix API
  • Roads API
  • Time Zone API
  • Places API
My maps appear darker than usual. What'south happening?

Under certain circumstances, a darkened map, or 'negative' Street View prototype, watermarked with the text "for development purposes only", may be displayed. This beliefs typically indicates issues with either an API key or billing. To utilize Google Maps Platform products, you must take a billing business relationship and all requests must include a valid API key. The following menstruum will assist troubleshoot this:


How do I resolve the fault codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
These mistake codes tin be returned for any of the following reasons:
  • An API key is missing from the asking.
  • The provided API key is invalid.
  • The projection does not have a billing account attached.
  • A cocky-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for example, a credit carte du jour has expired).
  • You lot take exceeded the QPS limits for a given API.

To use Google Maps Platform products, y'all must take a billing account, and all requests must include a valid API key. To fix this, have the post-obit steps:

  • Set up a billing business relationship.
  • Become a new API cardinal.
  • Adjust your usage cap to increase your daily limit (if applicable).
How practise I resolve the mistake codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If y'all are seeing kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED, you may be using a deprecated version of the Places SDK for Android or Places SDK for iOS. Learn more and discover the new SDKs at https://goo.gle/places-sdk-deprecation.
How practise I resolve the error: "This IP, site or mobile application is not authorized to use this API cardinal."?

There are various scenarios which may cause this error:

  • You've enabled IP address (server) restrictions on your API fundamental, and an unauthorized IP accost is attempting a request.
  • You've enabled HTTP referrer (website) restrictions on your API key, and an unauthorized referrer is attempting a request.
  • You've restricted usage to your Android apps by setting a bundle name and fingerprint, and an unauthorized Android app is attempting a asking.
  • Y'all've restricted requests from iOS apps by specifying package identifiers and an unrecognized iOS app is attemting to send a request.
  • Information technology used to be possible to get this error if you used whatever of the spider web service APIs, with an API key with HTTP referer restrictions. Requests to those APIs should be identified with an API fundamental with IP address restrictions. Switch your cardinal restriction type from an HTTP referer brake to an IP accost restriction. For more than information well-nigh restricting API keys, come across API Key All-time Practices.

View and Edit your API Primal Credentials

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

  1. Go to the Credentials folio of the Deject Panel.
  2. Select the projection that contains the API key you desire to review.
  3. To view credential details, including any restrictions gear up for the key, from the list of API keys, click the name of the key.
  4. The full credentials of the selected API key are displayed, including whatever restrictions set up for the key. From here, the restrictions can exist inverse, deleted, or updated as needed.
How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

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

Google Maps Platform Services

I need to convert addresses to breadth/longitude pairs. Tin 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 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 data.

The accuracy of geocoded locations may vary per land, then you should consider using the returned location_type field to decide if a good enough match has been found for the purposes of your application. Delight note that the availability of geocoding data depends on our contracts with data providers, then it is subject to alter.

Why do the Google Maps Platform Geocoders provide different 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 can await 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 following 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.
  • Do not specify additional accost elements such as business names, unit numbers, flooring numbers, or suite numbers that are not included in the address as divers by the mail of the state concerned. Doing so may result in responses with ZERO_RESULTS.
  • Format plus codes equally shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %20):
    • global code is a 4 character area code and 6 character or longer local lawmaking (849VCWC8+R9 is 849VCWC8%2BR9).
    • chemical compound code is a vi character or longer local lawmaking 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 edifice name where possible.
  • Use street number addressing in preference to specifying cantankerous streets where possible.
  • Do 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.Due south. numbered highways be specified in addresses as follows:

  • County Roads: "Co Road NNN" where NNN is the road number. eg. "Co Route 82"
  • State Highways: "Country NNN" where State is the full name of the state and NNN is the highway number. eg. "California 82"
  • U.S. Highways: "U.S. NNN" where NNN is the highway number. eg. "U.South. 101"
  • U.S. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
When should I apply an API geocoder course and when should I utilise the HTTP Geocoding Service?

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

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

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

  • HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps spider web services. Encounter 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 class can automatically create the overlays and directions panel for you. Additional examples are provided in the documentation.
  • Java, Python, become, and Node.js client interfaces, for server-side applications, provide the same functionality. Reference documentation is available at these links: Coffee Client for Google Maps Services, Python Customer for Google Maps Services, Go Customer for Google Maps Services, and Node.js Client for Google Maps Services.
In which countries are driving directions bachelor?

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

In which countries are transit directions available?

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

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 be institute here.

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

The size and complexity limits on the display of KML using the KmlLayer grade are documented here.

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

The KmlLayer form 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 not possible to brandish KML files that are non hosted at a URL that is bachelor publicly attainable, or that crave authentication to access.

If you need to develop applications that utilize KML files hosted on intranet sites we recommend that you lot render the KML on the client side by using tertiary-party JavaScript libraries. As the KML file is analyzed by the browser, performance may be lower than by using the KmlLayer course.

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

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

Notation that Maps Static API URLs tin contain a maximum of approximately eight,192 characters which constrains the number of markers and path vertices that can exist specified based on the number of decimal places used when specifying each breadth/longitude pair. For data on how the number of decimal places used relates to the accurateness on the World see the Wikipedia article on Decimal Degrees.

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

Maps APIs may non be used in Prohibited Territories. Refer likewise 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
  • Wrong road names
  • Wrong information about one-way and two-way roads
  • Incorrectly drawn road
  • Closed roads
  • Roads that don't exist

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

If Maps content needs to exist 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 performance 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 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 data includes success status, latency, and version/channel of the Maps JavaScript API in utilize. The calls may be batched for performance. Please note that you may need to allow maps.googleapis.com in your Content Security Policy to ensure these calls are non blocked at browser-level. For case: 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.

Maps JavaScript API

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

You need to refresh the folio that loads the Maps JavaScript API at least one time every five days.

Google Maps SDK for iOS

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

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

For more information, see the following StackOverflow thread.

How do I resolve the error: kGMSPlacesRateLimitExceeded?
If yous are seeing this fault, you may be 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 bachelor. Please update your app to utilize the latest version as soon as possible. Encounter the migration guide for details.
I'm getting crashes when debugging with an iOS viii.10 device. What should I do?

If yous experience bug when debugging with devices running iOS 8.x, follow these steps to disable GPU frame capture in the XCode scheme you lot are running:

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

Beginning with the iPhone X, iPhones take 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. As of iOS 11.0 SDK, Apple tree added the Safe Area API allowing developers to position elements in an area which is condom from existence clipped by the new screen shape.

The Google Maps iOS SDK has many visual elements and controls, such as an indoor picker and the written report a trouble link. With version 2.4, these visual elements and controls could exist clipped past the new screen shape. In mural style, the indoor flooring picker may exist clipped by either the notch or the dwelling house 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 10 or later, the padding on GMSMapView and GMSPanoramaView are increased so that the visual elements aren't clipped.

By default, we will ever include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe surface area. If you lot design your interface with the assumption that everything is positioned within the safe expanse, this volition work without any extra endeavor.

If yous have designed an interface which doesn't work with our default aligning, we have introduced a new holding to GMSMapView, called paddingAdjustmentBehavior. GMSMapView now allows you to choice from one of 3 padding adjustments behaviors: 'Always' (default), 'Automated', and 'Never'.

If GMSMapView is set to use the 'Always' padding behavior, information technology will always add the rubber area insets to the padding. This allows you to design your interface with the assumption that all placement is from the edges of the safety area. This is the default value.

If GMSMapView is set to use the 'Automatic' padding behavior, it will always choose the larger of padding or safety area inset. This volition let you to add padding from the screen border while always ensuring that all elements stay within the safe expanse.

If GMSMapView is set to use the 'Never' padding behavior, it will 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 safe area, or if our other behaviors don't deed well with your interface. It is your responsibleness 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 ways that at that place is no padding to adjust and GMSPanoramaView volition always apply any necessary padding to ensure that all visual elements are within the safe expanse.

Google Maps SDK for Android

How do I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If you lot are seeing this error, y'all 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 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 bare greyness tiles are shown instead of a map is authentication problems. You tin can follow the steps beneath to troubleshoot those bug by using adb logcat.

  1. Brand sure yous have adb installed. If not, you can follow the guide here.
  2. Install the app that shows the trouble on a device or an Android emulator. If you lot use Android emulator, make certain the emulator settings has Play Store included.
  3. In Android Studio terminal, run adb logcat -e "Google Maps Android API". This will simply impress lines where the log bulletin matches "Google Maps Android API" (Optionally, you can output the log to a text file past appending: > logcat.txt)
  4. Reproduce the issue on your device and check for mutual errors such as:
    • The wrong/unintended API Key is being referenced in Manifest.
    • Billing isn't enabled on Projection.
    • The SDK isn't enabled on projection APIs.
    • The incorrect SHA1 fingerprint is added to the API Key restrictions.
    • The Google Play Service dependencies is not included in the build.gradle file.

URL signing

Tin I sign URLs using JavaScript?

We strongly recommend against signing URLs using JavaScript as this would expose your URL signing secret to stop 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, probable because the signature could not be verified for this asking. This could be because:

  1. A signature has been specified but is incorrect for this request.
  2. The request specifies a Google Maps Platform Premium Plan an API key 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 Program API central has not been specified.