Google Maps Platform FAQ

Getting Started

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

Usage limits and billing

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

Using the Google Maps Platform

  • Which keys or credentials should I use for dissimilar Google Maps Platform products?
  • How do I switch my cardinal brake type from an HTTP referer to an IP address restriction?
  • How do I go a new API key?
  • How can I find the changes introduced in each version of the Google Maps Platform?
  • How can I load the API into a folio asynchronously later the page has loaded?
  • How can I get Google Maps Platform products to display in a linguistic communication other than English?
  • Can the Google Maps Platform be accessed over SSL (HTTPS)?
  • How exercise 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 fault mean?
  • My maps appear darker than usual. What's happening?
  • How do I resolve the error codes OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
  • How do I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
  • How do I resolve the error: "This IP, site or mobile application is not authorized to use this API key."?
  • How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

Google Maps Platform Services

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

Google Maps SDK for iOS

  • In Xcode 12, apps practise not build correctly for the simulator. How can I fix this?
  • How practice I resolve the error: kGMSPlacesRateLimitExceeded?
  • I'k getting crashes when debugging with an iOS 8.ten device. What should I do?
  • What'due south 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 only shows blank grey tiles instead of a map. How can I resolve this?

URL signing

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

Getting Started

What is the Google Maps Platform?

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

Maps:

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

Routes:

  • Directions API
  • Distance Matrix API
  • Roads API

Places:

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

Meet Go Started with Google Maps Platform.

Which API do I need?

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

How do I kickoff using the APIs on my site?

See the Overview, Developer, and Become Started guides for the specific API or SDK yous are interested in. For case, 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 data for the latest coverage information. You tin can filter the information with the filter box at the top of the page. Please annotation that coverage data tin change if licensing agreements with the data providers change.

Also run into:

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

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

How do I deliver Maps applications on mobile devices?

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

To comprise 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. Annotation that utilize of the Maps Static API outside of browser based applications requires that the map epitome be linked to Google Maps.

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

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

Desktop
  • The current version of Microsoft Edge (Windows)
  • The electric 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)

Outset in Baronial 2021, a alarm message will appear to Net Explorer xi users at the elevation of maps. The last version of the Maps JavaScript API to back up Internet Explorer 11 is v3.47. Support for Internet Explorer 11 will be entirely discontinued in August 2022. This too applies to the IE manner in Edge.

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

Press from the Maps JavaScript API is not supported. This is because press back up 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 Blog for news updates across the various Google Geo developer offerings.

How exercise I contact technical back up?

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

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

If you lost admission to your Google Business relationship (due east.g. joe@mycompany.com or joe@gmail.com), you can effort restoring the account access past retrieving or resetting your password. Visit the How to recover your Google Account or Gmail article in Google Account Help.

  • Note: To restore access to a M Suite account, ask your Organisation admin to undelete the business relationship.
How can I recover access to a specific project?

If you lost access to the project where y'all manage your Google Maps Platform implementation, you can endeavour to recover information technology.

If you have access to your projection-associated Google Business relationship:

  • If yous know the Project Owner and have admission to your Google Business relationship: Inquire the Projection Owner to add together you lot every bit a Projection Owner or Project Editor.
    • If your project is part of an Organization: Contact your Organisation admins and inquire them to add you as a Project Possessor.
  • If you do non know any of the current Projection Owners: If you don't know who the Project Owner is, or the Project Owner is unavailable, contact the support team to explore additional options to recover the project.

If you practice non accept access to your projection-associated Google Business relationship:

  • If yous lost access to your Google Business relationship: endeavour to recover your username or password for your account.
  • If yous cannot recover access to your Google Account: Create a new Google Account, and so contact an existing project owner and ask them to add together your new Google Account to the projection.
Tin I use the Maps and Places SDK for iOS on Arm-based Macs?

Developing on the new Arm-based Macs is possible, however, it requires edifice and running on a concrete iOS device. This is a temporary limitation while we look into adding more back up for developing on simulators.

Understanding the terms of service

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

The Google Maps Platform Terms of Service are bachelor at:

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

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

Y'all tin employ the Google Maps Platform within your applications every bit long as your site meets the Google Maps Platform Terms of Service.

However, there are some uses of the Google Maps Platform that nosotros just don't want to meet: maps that identify the places to buy illegal drugs in a urban center, for example, or any other illegal activeness. We too respect people's privacy, so the Google Maps Platform shouldn't exist used to identify private information near individuals.

Y'all should use your own counsel to determine whether your application complies with the Google Maps Platform Terms of Service earlier yous develop and launch information technology. Google engineers can but offering technical assistance and are not qualified to offer legal advice. Google reserves the right to suspend or finish your use of the service at whatsoever time, so please read the Maps APIs Terms carefully.

Tin can I straight access map tiles and satellite imagery?

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

Can I use Google Maps Platform products for tracking applications?

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

Tin I utilize Google Maps in my not-Web application?

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

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

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

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

Can I create an awarding that includes Google Maps Platform data in a certificate?

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. Delight see the Google Maps Platform Terms of Service "No Scraping" section for more details.

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

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

To remove your folio or site from search results, follow the instructions provided in our webmaster help middle.

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

You may non 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-prototype attribute of an HTML div tag straight to the Maps Static API and then that all map images are displayed within the HTML content of the web folio and served directly to end users by Google.

Usage limits and billing

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

There are no maximum daily limits on the number of requests you tin make to Google Maps Platform products, and the just usage limits are related to the maximum number of queries per second (QPS). (For Altitude Matrix, the limit is ready in events per second (EPS) calculated equally the sum of customer-side and server-side queries.) The following table shows the usage limit for each API.

API Usage limit
Directions l QPS
Altitude Matrix thou EPS
Elevation 100 QPS
Geocoding l QPS
Geolocation 100 QPS
Dynamic Maps 500 QPS
Static Maps 500 QPS
Street View Epitome API 500 QPS
Time Zone 500 QPS
Places (except for mobile) 100 QPS
Roads 500 QPS

In order to govern expenditures, yous can monitor your API usage, and set 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 see the Pricing Sail.

To learn more almost how Google Maps Platform APIs are billed, delight come across Agreement billing for Maps, Routes, and Places.

How are map loads counted on the Google Maps Platform?

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

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

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

How do 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 want to review.
  2. From the listing of APIs on the Dashboard, click the name of the API.
  3. Near the top of the folio, click Metrics or Quotas.

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

  1. If y'all oasis't already washed then, ready upward billing.
  2. Become to the Cloud Panel billing page.
  3. Select a projection.
  4. In the left sidebar, click Reports. Employ the filters on the correct sidebar to view reports on your billing account.

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

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

If you exceed the QPS limits of a given Google Maps Platform product, the API will return an error bulletin. If yous repeatedly exceed the limits, your admission to the API may exist temporarily blocked.

If y'all exceed the asking QPS limits or otherwise abuse the service, requests will return a specific error bulletin. If you lot 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 available in the Maps JavaScript API: Directions, Altitude Matrix, Elevation, and Geocoding.

Usage limits exceeded

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

This means that the web service will stop providing normal responses and switch to returning just status code OVER_QUERY_LIMIT until more than usage is immune again. This can happen within a few seconds, if the mistake was received considering 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. Meet the Optimization Guide for more information.

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

Yes. However we recommend that y'all familiarize yourself with the usage limits for any of the Google Maps Platform that your awarding relies on.

Once you have a billing account, if you exceed the no-accuse, $200-monthly usage limit and you do not accept a valid payment method on your billing account (credit card, depository financial institution transfer, ...), the API ceases to office until you add a valid payment method.

How will usage be calculated and billed?

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

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

See the Pricing Sheet for an overview of toll per API. If your application generates requests or map load volumes beneath the free $200 per calendar month usage, your usage is not charged. Usage that exceeds the $200 monthly credit will exist charged to your billing account. For more details, meet our guide to understanding Google Maps Platform billing.

Is pricing bachelor in other currencies?

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

I've prepare up billing. How exercise I view my bill?

Google charges you lot at the get-go of each month for the previous month's action, using your specified payment method. For details about your beak, meet our guide to understanding Google Maps Platform billing.

Additional resources:

  • Learn how to view your cost and payment history.
  • Learn how to get an invoice or payment receipt.
  • Larn how to gear up and manage billing alerts.
How do I avoid a big bill if my usage unexpectedly increases?

The Google Maps Platform provides ways to set up daily asking limits and set maximum daily billable limits. Y'all can cap the maximum daily limit on usage to protect against unexpected increases. Yous can as well set budget alerts to receive email notifications when the charges on the billing business relationship achieve a threshold you lot set.

Capping the maximum daily billable limit:

To avoid a big bill, yous tin set a daily cap on usage to protect against unexpected increases in use. Yous tin can change this limit in the Cloud Console past taking the following steps:

  1. Get 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 adjacent to the "requests per twenty-four hours" quota.

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

Setting and managing budget alerts:

Gear up up budget alerts to send email notifications to billing administrators when the charges on the billing account reach a threshold you lot prepare. Billing administrators volition exist sent email notifications when the estimated charges on the billing business relationship exceed 50%, 90%, and 100% of the threshold.

I got a message maxim that my projection is linked to the "Google Maps Platform Transition Business relationship", merely I don't accept access to that account. What practise I practice?

The "Google Maps Platform Transition Account" was created to help certain customers transition to our new pay-every bit-you-go pricing programme. This transition account enabled Google to provide these customers with a i-fourth dimension credit, and so that they could continue using Google Maps Platform upwardly to the limit of the $200 no-charge tier. In one case this limit is exceeded, the billing account will shut downwards and you volition lose access to the service. To avoid service interruptions, we urge you lot to gear up your own billing account, and continue to enjoy the $200 monthly no-charge tier. To change the billing account for your projection:

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

If you have not created and attached a billing account to your project, your Maps Platform APIs will be limited to 1 asking per day. You tin can get college quota by creating and attaching a billing business relationship. To do this, see Become Started with Google Maps Platform.

Once you have created and attached a billing account, your daily quota limit volition exist removed. Yous tin can make up one's mind to set a limit to foreclose unexpected spend, in the Deject Console.

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

You have received this notice because Google has determined that your account has been using multiple billing accounts. This is a violation of Google'south terms, as divers in section 3.ii.4 of the Google Maps Platform Terms of Service. Under these terms, it is forbidden to create multiple billing accounts. To larn more than, see the Billing Account Violation FAQ.

Using the Google Maps Platform

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

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

API Key:

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

Digital Signature:

  • A digital signature is generated using a URL signing underground 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, but we strongly recommend you restrict all API keys for greater security. Run across API security best practices for more details.
  • You can add an application restriction to the API key. Once restricted, a key will only piece of work on platforms that support that type of restriction. Four types of application restrictions are available. APIs enforcing the aforementioned restriction type can use the same restricted cardinal.
    • IP addresses (individual servers) - for use with the web service APIs.
    • HTTP referrers (web sites) - for use with the web APIs.
    • Android app restriction (by package name and fingerprint) - for employ with the Maps SDK for Android.
    • iOS app brake (by iOS parcel identifier) - for use with the Maps SDK for iOS.
  • You can also add together an API restriction to the API primal. For more information, meet Go, add, and restrict an API key.

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

API/SDK Credential & Application Restriction
Maps SDK for Android API key with Android restriction1
Places SDK for Android API 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 brake1
Maps Static API API key with HTTP referer restrictionane + Digital Signature2
Street View Static API API primal with HTTP referer restriction1 + Digital Signaturetwo
Maps Embed API API key with HTTP referer restriction1
Directions API API key with IP address restriction1
Distance Matrix API API primal with IP address restriction1
Summit API API key with IP accost restriction1
Geocoding API API key with IP address restriction1
Geolocation API API key with IP address restrictioni
Roads API API key with IP address restriction1
Time Zone API API key with IP address restriction1
Places API API key with IP address restrictionane

ane API fundamental restrictions are optional, simply we strongly recommend yous restrict all API keys for greater security.

two Depending on usage, a digital signature may exist required for the Maps Static API and Street View Static API. Regardless of usage, we strongly recommend that yous use both an API key and a digital signature to authenticate your requests.

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

Of import: If y'all are using whatever of the spider web service APIs with an API key that has referer restrictions, your requests will neglect with the error message: "API keys cannot take referer restrictions when used with this API." You should switch to using an API key with IP address restrictions.

Before y'all switch the API central brake blazon from HTTP referer to IP accost, ensure that all the APIs that employ the API key support the IP brake type. APIs of the aforementioned restriction type tin use the same restricted key. If you need to enforce more than one restriction, add a separate fundamental with the required restriction. Come across how to add a new API cardinal.

Learn more about API cardinal restrictions associated with Google Maps Platform products.

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

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

Version change 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

Y'all tin can also bank check which version of the Google Maps Platform a particular bug was introduced and fixed in using the Google Maps Platform Issue Tracker at:

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

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

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

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

By default the API will endeavour to load the most appropriate linguistic communication based on the users location or browser settings. Some APIs allow you to explicitly set up a linguistic communication when y'all brand a request. More information on how to ready 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 not be exhaustive and is subject to change.

Language Lawmaking Language Language Lawmaking Linguistic communication
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Standard arabic km Khmer
hy Armenian ko Korean
az Azerbaijani ky Kyrgyz
eu Basque lo Lao
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 Shine
hour 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 language (Australian) ru Russian
en-GB English (Great United kingdom) sr Serbian
et Estonian si Sinhalese
fa Farsi sk Slovak
fi Finnish sl Slovenian
fil Filipino es Spanish
fr French es-419 Spanish (Latin America)
fr-CA French (Canada) sw Swahili
gl Galician sv Swedish
ka Georgian ta Tamil
de German te Telugu
el Greek thursday Thai
gu Gujarati tr Turkish
iw Hebrew uk Ukrainian
hi Hindi ur Urdu
hu Hungarian uz Uzbek
is Icelandic vi Vietnamese
id Indonesian zu Zulu
information technology Italian

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

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

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

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

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

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

If you wish to request a characteristic, delight also first heighten information technology in the relevant forum to ostend that a solution that meets your requirements is non already bachelor.

Once you have confirmed that you have identified a new issues, or that your requirements cannot be met by the existing functionality of the Google Maps Platform products, please written report your issues or feature request using the Google Maps Platform Outcome Tracker.

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

How do Google Maps Platform APIs employ site cookies?

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

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

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

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

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

Errors and troubleshooting

What does this error mean?

If you encounter an error while loading or running the Google Maps APIs, delight run across the post-obit links to find explanations for the mistake codes:

  • Maps JavaScript API
  • Maps Static API
  • Street View Static API
  • Maps Embed API
  • Superlative 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?

Nether sure circumstances, a darkened map, or 'negative' Street View image, watermarked with the text "for evolution purposes only", may be displayed. This behavior typically indicates bug with either an API fundamental or billing. To utilise Google Maps Platform products, yous must take a billing account and all requests must include a valid API primal. The following menstruation volition help troubleshoot this:


How do I resolve the fault codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT?
These fault codes can be returned for any of the following reasons:
  • An API primal is missing from the request.
  • The provided API key is invalid.
  • The project does not have a billing account fastened.
  • A cocky-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for example, a credit card has expired).
  • You lot 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:

  • Set up a billing business relationship.
  • Get a new API key.
  • Adjust 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 lot 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 find the new SDKs at https://goo.gle/places-sdk-deprecation.
How do I resolve the mistake: "This IP, site or mobile application is not authorized to use this API key."?

There are various scenarios which may cause this mistake:

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

View and Edit your API Fundamental 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 project that contains the API fundamental you want to review.
  3. To view credential details, including whatsoever restrictions set up for the key, from the listing of API keys, click the name of the key.
  4. The total credentials of the selected API key are displayed, including any restrictions gear up up for the fundamental. From here, the restrictions can be changed, deleted, or updated as needed.
How practice 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 key restricted to an HTTP referer. For security reasons, web service APIs need to employ API keys restricted to IP addresses. Switch your fundamental restriction type from an HTTP referer brake to an IP address restriction, or create a new API key if your key is already used with the Maps JavaScript API.

Google Maps Platform Services

I need to convert addresses to latitude/longitude pairs. Tin 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 class is: google.maps.Geocoder.

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

Which countries is geocoding available in?

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

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

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

The API geocoder and Google Maps geocoder sometimes use different information sets (depending on the country). The API geocoder occasionally gets updated with new data, and then y'all can expect to encounter 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 accordance with the following guidelines to maximize the likelihood of a successful query:

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

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

  • County Roads: "Co Road NNN" where NNN is the road number. eg. "Co Road 82"
  • State Highways: "State NNN" where Land is the total name of the land and NNN is the highway number. eg. "California 82"
  • U.Due south. Highways: "U.S. NNN" where NNN is the highway number. eg. "U.Southward. 101"
  • U.Southward. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
When should I use an API geocoder grade and when should I utilise the HTTP Geocoding Service?

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

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

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

  • HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps spider web services. See the Directions API for more than information.
  • JavaScript API, for client-side applications, allows you lot 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, go, and Node.js client interfaces, for server-side applications, provide the same functionality. Reference documentation is available 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 bachelor?

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

In which countries are transit directions bachelor?

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

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

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

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

The size and complexity limits on the display of KML using the KmlLayer 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 call back and parse KML files for rendering. Consequently information technology 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 need to develop applications that use KML files hosted on intranet sites we recommend that you return the KML on the client side by using third-political party JavaScript libraries. Every bit the KML file is analyzed past the browser, performance 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?

At that place 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 tin can be specified per request, only each can be used multiple times within the map.

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

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

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

How do I report a trouble on the Google basemap?
Send feedback through Google Maps for wrong or missing map data such as:
  • Wrong addresses or marker locations
  • Incorrect route names
  • Wrong information about 1-way and two-mode roads
  • Incorrectly drawn road
  • Closed roads
  • Roads that don't exist

For correction of a place 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 exist fixed.

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

Some client-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/aqueduct of the Maps JavaScript API in apply. The calls may be batched for functioning. Please note that yous may demand to allow maps.googleapis.com in your Content Security Policy to ensure these calls are not blocked at browser-level. For example: Content-Security-Policy: default-src 'cocky' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'cocky' maps.googleapis.com;"> with HTML Meta Tags.

Google Maps SDK for iOS

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

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

For more information, come across the following StackOverflow thread.

How do I resolve the error: kGMSPlacesRateLimitExceeded?
If you are seeing this mistake, you may exist using a deprecated version of the Places SDK for iOS. Version 2.seven.0 of the Places SDK for iOS has been turned off, and is no longer available. Please update your app to utilise the latest version every bit shortly every bit possible. See the migration guide for details.
I'm getting crashes when debugging with an iOS viii.x device. What should I do?

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

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

Start with the iPhone X, iPhones accept a screen shape featuring rounded corners, a notch at the pinnacle for the device's sensor housing, and an indicator at the bottom of the screen for accessing the Home screen. Equally of iOS xi.0 SDK, Apple added the Safe Area API assuasive developers to position elements in an area which is condom from existence clipped past the new screen shape.

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

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

By default, nosotros will e'er include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe expanse. If you design your interface with the supposition that everything is positioned inside the safe expanse, this will work without whatever actress attempt.

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

If GMSMapView is fix to use the 'Ever' padding behavior, it will always add the rubber surface area insets to the padding. This allows you to design your interface with the assumption that all placement is from the edges of the rubber surface area. This is the default value.

If GMSMapView is set to use the 'Automatic' padding beliefs, it will always choose the larger of padding or rubber area inset. This volition allow you to add padding from the screen edge while always ensuring that all elements stay within the condom area.

If GMSMapView is set to use the 'Never' padding beliefs, it will never add the rubber surface area insets to the padding. This is the beliefs prior to the ii.v release and may exist useful if your padding already takes into consideration the condom expanse, or if our other behaviors don't act well with your interface. It is your responsibility to ensure that the Google logo and copyright notices are always visible, as specified in the Google Maps Platform Terms of Service.

In contrast, GMSPanoramaView doesn't have an optional padding property. This means that at that place is no padding to adapt and GMSPanoramaView will always apply whatever 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 you are seeing this fault, 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 utilize the latest version as soon as possible. See the migration guide for details.
My app only shows blank grey tiles instead of a map. How can I resolve this?

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

  1. Brand sure y'all accept adb installed. If not, you can follow the guide hither.
  2. Install the app that shows the problem on a device or an Android emulator. If you use Android emulator, brand sure the emulator settings has Play Store included.
  3. In Android Studio final, run adb logcat -e "Google Maps Android API". This will merely impress lines where the log message matches "Google Maps Android API" (Optionally, you tin output the log to a text file by appending: > logcat.txt)
  4. Reproduce the issue on your device and check for common errors such as:
    • The wrong/unintended API Central is being referenced in Manifest.
    • Billing isn't enabled on Projection.
    • The SDK isn't enabled on project APIs.
    • The incorrect SHA1 fingerprint is added to the API Cardinal restrictions.
    • The Google Play Service dependencies is non included in the build.gradle file.

URL signing

Can I sign URLs using JavaScript?

We strongly recommend against signing URLs using JavaScript as this would expose your URL signing hole-and-corner to end users. Therefore signatures should only be generated by server side components.

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

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

  1. A signature has been specified just is incorrect for this asking.
  2. The asking specifies a Google Maps Platform Premium Plan an API primal but does not specify a signature, and the service beingness chosen requires that requests made using an API fundamental include a valid signature.
  3. A signature has been specified but the associated Google Maps Platform Premium Plan API key has not been specified.