Google Maps Platform FAQ

Getting Started

  • What is the Google Maps Platform?
  • How do I become started with Google Maps Platform?
  • Which API practise I demand?
  • How do I start using the APIs on my site?
  • Which countries does the Google Maps Platform cover?
  • Can I put Google Maps on my site without using Google Maps Platform products?
  • How do I evangelize Maps applications on mobile devices?
  • Which web browsers practice the Maps JavaScript API and Maps Embed API support?
  • Tin can I impress 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 back up available?
  • How do I recover access to my Google Account?
  • How practise 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 meet the Google Maps Platform Terms of Service?
  • Can I directly access map tiles and satellite imagery?
  • Can I use Google Maps Platform products for tracking applications?
  • Can I use Google Maps Platform products in my not-Web application?
  • Tin I use 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?
  • Can I generate a map image using the Maps Static API which I store and serve from my website?

Usage limits and billing

  • How exercise I set up billing for my project?
  • How do Google Cloud Platform Gratuitous Tier customers upgrade to a paid account?
  • Does the Google Maps Platform have usage limits?
  • How is usage cost calculated?
  • How are map loads counted on the Google Maps Platform?
  • How practise I monitor my quota usage?
  • What happens if I exceed the usage limits?
  • My site gets a lot of traffic. Tin can I employ Google Maps Platform products?
  • If my spider web site or application becomes suddenly popular, will my maps stop working?
  • How will usage exist calculated and billed?
  • How much does it cost to use the Google Maps Platform?
  • Is pricing available in other currencies?
  • I've fix billing. How practice I view my bill?
  • How do I avoid a big bill if my usage unexpectedly increases?
  • I got a bulletin proverb that my project is linked to the "Google Maps Platform Transition Account", but I don't take access to that account. What exercise I do?
  • Why is my quota limit set to ane request 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 use for unlike Google Maps Platform products?
  • How do I switch my key restriction type from an HTTP referer to an IP address brake?
  • How exercise I get a new API primal?
  • How tin can I detect the changes introduced in each version of the Google Maps Platform?
  • How tin I load the API into a folio asynchronously after the page has loaded?
  • How can I get Google Maps Platform products to brandish in a language other than English?
  • Tin can the Google Maps Platform exist accessed over SSL (HTTPS)?
  • How practice I report a bug or request a new feature in the Google Maps Platform?
  • How exercise Google Maps Platform APIs use site cookies?
  • I can't find the answer to my question. Who should I contact?

Errors and troubleshooting

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

Google Maps Platform Services

  • I need to convert addresses to breadth/longitude pairs. Can I practice that with the Google Maps Platform?
  • Which countries is geocoding available in?
  • Why exercise the Google Maps Platform Geocoders provide different locations than Google Maps?
  • How should I format my geocoder queries to maximise the number of successful requests?
  • How should I format a U.Due south. address on a numbered highway for geocoding?
  • When should I use an API geocoder class and when should I utilise the HTTP Geocoding Service?
  • How do I provide driving directions with the Google Maps Platform?
  • In which countries are driving directions available?
  • In which countries are transit directions 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 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 by the Maps Static API?
  • Why tin't I access Google Maps Platform products for certain countries?
  • How practice I report a problem on the Google basemap?
  • How is operation monitored for the services used with Maps JavaScript API?

Google Maps SDK for iOS

  • In Xcode 12, apps do not build correctly for the simulator. How tin can I fix this?
  • How do I resolve the mistake: kGMSPlacesRateLimitExceeded?
  • I'k getting crashes when debugging with an iOS 8.ten 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 practice I resolve the mistake: 9001 Operation failed due to exceeding the quota usage limit?
  • My app only shows blank grayness tiles instead of a map. How can I resolve this?

URL signing

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

Getting Started

What is the Google Maps Platform?

The Google Maps Platform is a ready of APIs and SDKs that allows developers to embed Google Maps into mobile apps and web pages, or to think information from Google Maps. In that location are several offerings. Depending on your needs, you 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
  • Time Zone API
How do I get started with Google Maps Platform?

See Get Started with Google Maps Platform.

Which API exercise I need?

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

How do I beginning using the APIs on my site?

See 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 cover?

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 information. You can filter the data with the filter box at the height of the page. Please note that coverage data tin change if licensing agreements with the information providers modify.

Too see:

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

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

How do I evangelize Maps applications on mobile devices?

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

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

The Maps JavaScript API has been developed to cater to mobile devices, and is suitable for browser applications targeted at both the desktop and devices that include a web browser with a full JavaScript implementation, such 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 do the Maps JavaScript API and Maps Embed API support?

The Maps JavaScript API and Maps Embed API support the post-obit web browsers:

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

In order to costless upward resources to deliver customer-requested features available to mod browsers, Google Maps Platform is ending back up for Net Explorer 11. Microsoft ended support for IE11 in 2021 and encouraged migration to Microsoft Edge.

Beginning in August 2021, a warning bulletin started to appear to Internet Explorer 11 users at the top of maps. The last version of the Maps JavaScript API to back up Net Explorer eleven is v3.47. Support for Internet Explorer 11 will exist entirely discontinued in November 2022. This also applies to the IE mode in Edge.

Android
  • The current version of Chrome on Android 4.1+.
  • Chrome WebView on Android 4.4+.
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 commonly used browsers.

How can I be notified when there are changes to Google Maps Platform products?

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

How do I contact technical support?

See Google Maps Platform Back up and Resources for information nigh available support options.

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

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

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

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

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

  • If y'all know the Project Owner and have admission to your Google Business relationship: Ask the Projection Owner to add you as a Project Owner or Projection Editor.
    • If your project is part of an Organization: Contact your Organization admins and inquire them to add you equally a Project Possessor.
  • If you lot do not know whatever of the current Project Owners: If you don't know who the Projection Owner is, or the Projection Owner is unavailable, contact the back up team to explore additional options to recover the project.

If you practise not take access to your project-associated Google Account:

  • If you lost access to your Google Account: endeavor to recover your username or password for your account.
  • If y'all cannot recover access to your Google Account: Create a new Google Account, and so contact an existing project possessor and ask them to add your new Google Account to the project.
Can I use the Maps and Places SDK for iOS on Arm-based Macs?

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

Understanding the terms of service

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

The Google Maps Platform Terms of Service are available at:

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

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

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

However, in that location are some uses of the Google Maps Platform that we only don't want to encounter: maps that place the places to buy illegal drugs in a city, for case, or whatever other illegal activeness. Nosotros also respect people's privacy, and so the Google Maps Platform shouldn't be used to place private information about individuals.

Y'all should utilise your own counsel to decide 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 append or terminate your use of the service at whatsoever fourth dimension, so please read the Maps APIs Terms carefully.

Tin can I directly access map tiles and satellite imagery?

Yous may non admission map tiles or satellite imagery through any mechanism as well the Google Maps Platform (such equally the cosmos of your own mapping API or the use of a bulk tile download script). Your application'due south access to the tiles will exist blocked if information technology accesses them outside of the Google Maps Platform. See the Google Maps Platform Terms of Service for more details.

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

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

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

Yes, Google Maps Platform products 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 only supported when run in one of the supported browsers.

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

Yes, Google Maps, Routes, Places services can be used with individual-access applications. Run into 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 document, either in electronic or printed form, no information from Google Maps Platform, including images, may be included in the document. Please see the Google Maps Platform Terms of Service "No Scraping" section for more details.

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

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

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

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

Yous may non shop and serve copies of images generated using the Maps Static API from your website. All web pages that crave static images must link the src aspect of an HTML img tag or the CSS background-image attribute of an HTML div tag directly to the Maps Static API then that all map images are displayed inside the HTML content of the web page and served direct to end users by Google.

Usage limits and billing

How do I gear up billing for my project?
Meet Go Started with Google Maps Platform.
How practice Google Deject Platform Free Tier customers upgrade to a paid account?
The Google Cloud Platform Costless Tier program provides customers a no-charge trial with a $300 credit to employ with whatsoever Google Cloud Platform (GCP) service, including the Google Maps Platform (GMP) APIs. When the no-charge trial ends, y'all must upgrade to a paid account to continue using these services. To upgrade to a paid account, visit the Deject Panel.
Does the Google Maps Platform have usage limits?

There are no maximum daily limits on the number of requests you can make 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 gear up in events per second (EPS) calculated as the sum of client-side and server-side queries.) The post-obit tabular array shows the usage limit for each API.

API Usage limit
Directions fifty QPS
Altitude Matrix 1000 EPS
Tiptop 100 QPS
Geocoding fifty 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 social club to govern expenditures, you tin can monitor your API usage, and prepare daily limits to all requests to any billable API.

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

How is usage cost calculated?

For an overview of pricing for the Google Maps Platform products, please run across the Pricing Canvas.

To learn more about how Google Maps Platform APIs are billed, please run across Agreement 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 request to the Street View Static API to embed a static (non-interactive) Street View panorama.
  • A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOS application.

After a web page or application loads a map, or a static map epitome, or a Street View panorama, whatsoever user interactions with it, such as panning, zooming, or switching map layers, practice not generate additional map loads or touch on usage limits.

How practise I monitor my usage?

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

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

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

  1. If yous haven't already done so, prepare upwardly billing.
  2. Go to the Cloud Console billing folio.
  3. Select a project.
  4. In the left sidebar, click Reports. Utilize the filters on the right sidebar to view reports on your billing business relationship.

To learn more than, come across Google Maps Platform Reporting too as Monitoring your API Usage and Capping API Usage.

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

If you lot exceed the QPS limits of a given Google Maps Platform production, the API volition return an error message. If you 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 render a specific error message. If you keep to exceed limits, your access to the Google Maps Platform may be blocked.

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

Usage limits exceeded

If you exceed the usage limits you will become an OVER_QUERY_LIMIT status code equally a response.

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

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

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

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

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

How volition usage be calculated and billed?

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

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

See the Pricing Sail for an overview of cost per API. If your awarding 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, run across our guide to understanding Google Maps Platform billing.

Is pricing available in other currencies?

Additional currencies may be available within the console. When y'all select a unlike currency, rates will catechumen from the USD equivalent listed on our Pricing Sheet.

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

Google charges you at the start of each calendar month for the previous month's activity, using your specified payment method. For details about your bill, meet our guide to agreement Google Maps Platform billing.

Additional resources:

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

The Google Maps Platform provides means 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. You can likewise set budget alerts to receive email notifications when the charges on the billing account reach a threshold you set.

Capping the maximum daily billable limit:

To avoid a large beak, you tin gear up a daily cap on usage to protect confronting unexpected increases in utilise. You can modify this limit in the Deject Panel by taking the following steps:

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

Alternatively, yous tin edit multiple quotas for multiple APIs using the IAM & admin Quotas dashboard.

Setting and managing upkeep alerts:

Set up upwardly budget alerts to ship electronic mail notifications to billing administrators when the charges on the billing account reach a threshold y'all prepare. Billing administrators will be sent email notifications when the estimated charges on the billing account exceed 50%, xc%, and 100% of the threshold.

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

The "Google Maps Platform Transition Account" was created to aid certain customers transition to our new pay-as-you-become pricing plan. This transition account enabled Google to provide these customers with a i-fourth dimension credit, then that they could continue using Google Maps Platform upwards to the limit of the $200 no-charge tier. One time this limit is exceeded, the billing account will shut down and you will lose access to the service. To avoid service interruptions, we urge you to ready your ain billing business relationship, and continue to enjoy the $200 monthly no-charge tier. To alter the billing account for your projection:

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

If you have non created and fastened a billing account to your project, your Maps Platform APIs will exist limited to ane asking per day. You tin go higher quota by creating and attaching a billing business relationship. To do this, run into Go Started with Google Maps Platform.

Once you lot take created and attached a billing account, your daily quota limit volition exist removed. You can decide to set a limit to prevent unexpected spend, in the Cloud Console.

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

You have received this detect because Google has determined that your business relationship has been using multiple billing accounts. This is a violation of Google's terms, every bit defined in section 3.ii.iv of the Google Maps Platform Terms of Service. Nether these terms, it is forbidden to create multiple billing accounts. To learn more than, encounter the Billing Account Violation FAQ.

Using the Google Maps Platform

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

Each fourth dimension you utilise Google Maps Platform products, you lot must include an API primal to validate your request. The Google Maps Platform is bachelor for Android, iOS or Web apps, and via HTTP web services.

API Central:

  • An API central is a unique identifier that y'all generate using the Deject Console.
  • Case of loading an API with a key: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Digital Signature:

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

Restrictions:

  • API key restrictions are optional, but nosotros strongly recommend you restrict all API keys for greater security. See API security all-time practices for more details.
  • You tin add an application restriction to the API fundamental. Once restricted, a cardinal volition simply work on platforms that support that blazon of brake. 4 types of application restrictions are available. APIs enforcing the same restriction type tin can utilise the same restricted cardinal.
    • IP addresses (individual servers) - for use with the web service APIs.
    • HTTP referrers (web sites) - for employ with the web APIs.
    • Android app restriction (past package proper name and fingerprint) - for utilise with the Maps SDK for Android.
    • iOS app brake (by iOS package identifier) - for use with the Maps SDK for iOS.
  • You can too add an API restriction to the API key. For more information, encounter Get, add, and restrict an API primal.

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

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

ane API key restrictions are optional, merely 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, nosotros strongly recommend that you apply both an API key and a digital signature to authenticate your requests.

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

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

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

Learn more most API key restrictions associated with Google Maps Platform products.

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

  1. Go to the Credentials page of the Cloud Console.
  2. Select the project that contains the API fundamental you lot want to edit.
  3. On the Credentials page, from the list of API keys, select the proper name of the API fundamental to edit the details of the key.
  4. In the Key restriction section of the page, select "IP addresses (web servers, cron jobs, etc.)" and insert the appropriate server IP addresses, then click Salve.
How do I get a new API key?
See Get Started with Google Maps Platform.
How tin 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
  • Altitude Matrix API
  • Maps SDK for Android
  • Places SDK for Android
  • Maps SDK for iOS
  • Places SDK for iOS

Yous can also cheque which version of the Google Maps Platform a particular issues was introduced and fixed in using the Google Maps Platform Issue Tracker at:

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

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

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

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

By default the API will attempt to load the most appropriate language based on the users location or browser settings. Some APIs permit y'all to explicitly set a linguistic communication when you brand a request. More information on how to ready the language is bachelor in the documentation for each API:

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

Google oftentimes updates supported languages. This list may not be exhaustive and is subject to change.

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

You can see what the map will expect like in any of the languages listed in a higher place in this sample awarding.

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

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

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

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

If you lot experience beliefs that y'all believe may exist a bug, delight begin by raising it in the relevant forum. This volition permit other developers to validate the bug, and rule out whatsoever potential problems with your code.

If you wish to request a feature, delight besides first heighten information technology in the relevant forum to confirm that a solution that meets your requirements is not already bachelor.

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

Before calculation a problems or characteristic request to the Outcome Tracker please exist sure to check that the bug or feature concerned has not already been added. If it has, yous tin can star the issue to register your interest and be notified of updates.

How practise Google Maps Platform APIs use site cookies?

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

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

Google's Developer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and answer site for programmers. Information technology's a groovy place to inquire technical questions about developing and maintaining Google Maps applications. More than information about asking questions on Stack Overflow is available on the Back up page.

For all-time results when requesting assist, delight keep the following in mind:

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

Errors and troubleshooting

What does this fault hateful?

If you encounter an error while loading or running the Google Maps APIs, please see the post-obit links to detect explanations for the mistake codes:

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

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


How do I resolve the error codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
These error codes can be returned for whatever of the following reasons:
  • An API key is missing from the request.
  • The provided API fundamental is invalid.
  • The project does not take a billing account attached.
  • A self-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for case, a credit card has expired).
  • You have exceeded the QPS limits for a given API.

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

  • Fix a billing account.
  • Get a new API fundamental.
  • Arrange your usage cap to increase your daily limit (if applicable).
How do I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If you 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 than 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 key."?

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

  • You've enabled IP address (server) restrictions on your API key, and an unauthorized IP accost is attempting a asking.
  • You've enabled HTTP referrer (website) restrictions on your API key, and an unauthorized referrer is attempting a asking.
  • You've restricted usage to your Android apps past setting a package name and fingerprint, and an unauthorized Android app is attempting a request.
  • You've restricted requests from iOS apps by specifying parcel identifiers and an unrecognized iOS app is attemting to transport a request.
  • It used to be possible to get this fault if you used any of the web service APIs, with an API cardinal with HTTP referer restrictions. Requests to those APIs should exist identified with an API cardinal with IP address restrictions. Switch your key restriction type from an HTTP referer restriction to an IP address restriction. For more than data well-nigh restricting API keys, run into API Primal Best Practices.

View and Edit your API Key Credentials

To view your API keys and manage any restrictions, do the following:

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

Y'all are using whatsoever 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 key restriction type from an HTTP referer restriction to an IP address restriction, or create a new API key if your key is already used with the Maps JavaScript API.

Google Maps Platform Services

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

Yes, this process is called "geocoding." The Maps JavaScript API includes a course for performing a geocoding service. The form 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 meet 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 yous should consider using the returned location_type field to make up one's mind if a skilful enough match has been found for the purposes of your application. Delight notation that the availability of geocoding data depends on our contracts with information providers, then it is subject to alter.

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

The API geocoder and Google Maps geocoder sometimes use dissimilar information sets (depending on the country). The API geocoder occasionally gets updated with new data, so you tin can expect to come across 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 format geocoder requests in accord 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 non specify additional address elements such every bit business names, unit numbers, flooring numbers, or suite numbers that are non included in the address as defined past the post of the country concerned. Doing so may issue 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 grapheme surface area code and 6 graphic symbol or longer local code (849VCWC8+R9 is 849VCWC8%2BR9).
    • chemical 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).
  • Utilize the street number of a premise in preference to the building name where possible.
  • Utilize street number addressing in preference to specifying cantankerous streets where possible.
  • Do non provide 'hints' such equally nearby landmarks.
How should I format a U.Southward. accost on a numbered highway for geocoding?

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

  • County Roads: "Co Route NNN" where NNN is the road number. eg. "Co Road 82"
  • Country Highways: "Land NNN" where State is the full name of the state and NNN is the highway number. eg. "California 82"
  • U.South. Highways: "U.Southward. NNN" where NNN is the highway number. eg. "U.Due south. 101"
  • U.S. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
When should I utilize an API geocoder course 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 practise I provide driving directions with the Google Maps Platform?

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

  • HTTP asking/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps spider web services. See the Directions API for more than information.
  • JavaScript API, for customer-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 y'all. Additional examples are provided in the documentation.
  • Coffee, Python, become, and Node.js customer interfaces, for server-side applications, provide the same functionality. Reference documentation is bachelor at these links: Java Customer for Google Maps Services, Python Customer 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 by Driving Directions in the Google Maps Platform products, consult the Google Maps coverage data. Delight notation that the availability of driving directions data depends on our contracts with data providers, and is bailiwick to change.

In which countries are transit directions available?

The Directions API and Altitude 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 grade in the Maps JavaScript API enables developers to overlay KML/KMZ and GeoRSS files on tiptop of the map. Documentation and examples can exist found here.

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

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

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

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

If you lot demand to develop applications that utilise KML files hosted on intranet sites we recommend that you render the KML on the client side by using third-party JavaScript libraries. As the KML file is analyzed by the browser, functioning may exist lower than by using the KmlLayer class.

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

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

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

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

Maps APIs may not be used in Prohibited Territories. Refer too to the Terms of Service.

How do I report a trouble on the Google basemap?
Ship feedback through Google Maps for wrong or missing map information such as:
  • Wrong addresses or marking locations
  • Wrong road names
  • Wrong information about one-style and two-mode roads
  • Incorrectly fatigued road
  • Closed roads
  • Roads that don't exist

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

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

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

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

Some customer-side features are instrumented to 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 performance. Please note that you lot may need to allow maps.googleapis.com in your Content Security Policy to ensure these calls are not blocked at browser-level. For instance: Content-Security-Policy: default-src 'cocky' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'cocky' maps.googleapis.com;"> with HTML Meta Tags.

Google Maps SDK for iOS

In Xcode 12, apps exercise not 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 only.

For more information, meet the following StackOverflow thread.

How practice I resolve the fault: kGMSPlacesRateLimitExceeded?
If you are seeing this error, you may be using a deprecated version of the Places SDK for iOS. Version 2.7.0 of the Places SDK for iOS has been turned off, and is no longer available. Please update your app to use the latest version as soon as possible. See the migration guide for details.
I'm getting crashes when debugging with an iOS eight.x device. What should I do?

If you experience issues when debugging with devices running iOS 8.10, follow these steps to disable GPU frame capture in the XCode scheme y'all are running:

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

Offset with the iPhone X, iPhones have a screen shape featuring rounded corners, a notch at the superlative 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 added the Safe Area API allowing developers to position elements in an area which is safety 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 ii.4, these visual elements and controls could be clipped past the new screen shape. In landscape style, the indoor flooring picker may be clipped by either the notch or the home push 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 e'er include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe expanse. If yous design your interface with the assumption that everything is positioned within the safe area, this will piece of work without whatsoever extra try.

If yous take designed an interface which doesn't work with our default adjustment, we have introduced a new property to GMSMapView, chosen paddingAdjustmentBehavior. GMSMapView at present allows you to pick from one of three padding adjustments behaviors: 'Ever' (default), 'Automated', and 'Never'.

If GMSMapView is set to utilise the 'Always' padding behavior, it volition always add the safe area insets to the padding. This allows y'all to design your interface with the supposition that all placement is from the edges of the condom surface area. This is the default value.

If GMSMapView is set to utilize the 'Automated' padding behavior, it will ever choose the larger of padding or rubber area inset. This volition allow you to add together padding from the screen edge while e'er ensuring that all elements stay within the safe area.

If GMSMapView is set to apply the 'Never' padding behavior, information technology volition never add together the condom area 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 prophylactic surface area, or if our other behaviors don't human activity well with your interface. Information technology is your responsibility to ensure that the Google logo and copyright notices are ever visible, equally specified in the Google Maps Platform Terms of Service.

In contrast, GMSPanoramaView doesn't have an optional padding property. This means that there is no padding to arrange and GMSPanoramaView volition always apply any necessary padding to ensure that all visual elements are within the safe surface area.

Google Maps SDK for Android

How do I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
If y'all are seeing this error, 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. Please update your app to use the latest version equally soon as possible. See the migration guide for details.
My app simply 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 authentication issues. Yous can follow the steps below to troubleshoot those bug by using adb logcat.

  1. Make sure yous take adb installed. If not, you tin can follow the guide here.
  2. Install the app that shows the trouble on a device or an Android emulator. If you use Android emulator, make sure the emulator settings has Play Store included.
  3. In Android Studio concluding, run adb logcat -e "Google Maps Android API". This will simply print lines where the log message matches "Google Maps Android API" (Optionally, you tin can output the log to a text file by appending: > logcat.txt)
  4. Reproduce the result on your device and check for common errors such equally:
    • The incorrect/unintended API Key is being 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 Fundamental restrictions.
    • The Google Play Service dependencies is not included in the build.gradle file.

URL signing

Can I sign URLs using JavaScript?

Nosotros strongly recommend against signing URLs using JavaScript every bit this would expose your URL signing secret to end users. Therefore signatures should only exist generated past server side components.

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

An HTTP 403 response indicates a permission issue, probable considering the signature could not be verified for this request. This could be because:

  1. A signature has been specified simply is wrong for this asking.
  2. The request specifies a Google Maps Platform Premium Plan an API key just 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 just the associated Google Maps Platform Premium Program API cardinal has not been specified.