How To Change Currency Settings In Google Maps

Google Maps Platform FAQ

Getting Started

What is the Google Maps Platform?
How do I go started with Google Maps Platform?
Which API do I need?
How practise I start using the APIs on my site?
Which countries does the Google Maps Platform encompass?
Can I put Google Maps on my site without using Google Maps Platform products?
How practice I deliver Maps applications on mobile devices?
Which web browsers do the Maps JavaScript API and Maps Embed API support?
Tin I print maps from the Maps JavaScript API?
How tin can I be notified when there are changes to Google Maps Platform products?
How exercise I contact technical support?
When is technical support available?
How practice I recover admission to my Google Account?
How exercise I recover access to a specific project?
Can I use the Maps and Places SDK for iOS on Arm-based Macs?

Understanding the terms of service

What are the terms of service for Google Maps Platform products?
Does my site come across the Google Maps Platform Terms of Service?
Can I direct access map tiles and satellite imagery?
Can I utilize Google Maps Platform products for tracking applications?
Can I use Google Maps Platform products in my non-Web application?
Can I utilize 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 can I opt out of including my content in Google search results?
Tin can I generate a map image using the Maps Static API which I shop and serve from my website?

Usage limits and billing

How do I set up up billing for my projection?
How practice Google Cloud Platform Free Tier customers upgrade to a paid business relationship?
Does the Google Maps Platform take usage limits?
How is usage toll calculated?
How are map loads counted on the Google Maps Platform?
How do I monitor my quota usage?
What happens if I exceed the usage limits?
My site gets a lot of traffic. Can I use Google Maps Platform products?
If my web site or application becomes of a sudden popular, will my maps stop working?
How will usage be calculated and billed?
How much does information technology toll to apply the Google Maps Platform?
Is pricing available in other currencies?
I've set up billing. How do I view my bill?
How do I avoid a big neb 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 solar 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 different Google Maps Platform products?
How do I switch my cardinal restriction type from an HTTP referer to an IP address brake?
How do I get 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 page asynchronously later on the page has loaded?
How can I get Google Maps Platform products to display in a language other than English language?
Can the Google Maps Platform be accessed over SSL (HTTPS)?
How practice I study a issues or request a new characteristic in the Google Maps Platform?
How do Google Maps Platform APIs use site cookies?
I tin can't detect the answer to my question. Who should I contact?

Errors and troubleshooting

What does this error mean?
My maps appear darker than usual. What's happening?
How 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 do I resolve the mistake: "This IP, site or mobile application is not authorized to use this API central."?
How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

Google Maps Platform Services

I need to convert addresses to latitude/longitude pairs. Can I do that with the Google Maps Platform?
Which countries is geocoding available in?
Why do the Google Maps Platform Geocoders provide different locations than Google Maps?
How should I format my geocoder queries to maximise the number of successful requests?
How should I format a U.S. accost on a numbered highway for geocoding?
When should I utilize an API geocoder form and when should I employ the HTTP Geocoding Service?
How do I provide driving directions with the Google Maps Platform?
In which countries are driving directions 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 complexity 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 can't I access Google Maps Platform products for sure countries?
How practise I report a problem on the Google basemap?
How is functioning monitored for the services used with Maps JavaScript API?

Maps JavaScript API

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

Google Maps SDK for iOS

In Xcode 12, apps do non build correctly for the simulator. How tin can I fix this?
How do I resolve the error: kGMSPlacesRateLimitExceeded?
I'm getting crashes when debugging with an iOS 8.x device. What should I practice?
What's the touch on of rounded and wider screens on the Google Maps iOS SDK?

Google Maps SDK for Android

How do I resolve the mistake: 9001 Performance failed due to exceeding the quota usage limit?
My app merely shows blank grey tiles instead of a map. How can I resolve this?

URL signing

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

Getting Started

What is the Google Maps Platform?

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

Maps:

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

Routes:

Directions API
Distance Matrix API
Roads API

Places:

Places API
Places SDK for Android
Places SDK for iOS
Places Library, Maps JavaScript API
Geocoding API
Geolocation API
Time Zone API

How do I become started with Google Maps Platform?

Run across Become Started with Google Maps Platform.

Which API do I need?

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

How do I offset 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, bank check out the guides for Maps SDK for Android or Maps JavaScript API.

Which countries does the Google Maps Platform comprehend?

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 tiptop of the page. Please note that coverage information can modify if licensing agreements with the data providers modify.

Besides see:

How can I go Google Maps Platform products to display 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?

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

How do I deliver Maps applications on mobile devices?

To incorporate maps in an Android application, 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 equally the Apple iPhone.

For applications targeted at devices not suitable for using the Maps JavaScript API, the Maps Static API delivers map images in GIF, JPG, and PNG formats, including markers and polylines. Note that use of the Maps Static API exterior of browser based applications requires that the map epitome be linked to Google Maps.

Which web browsers do the Maps JavaScript API and Maps Embed API back up?

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 current and previous versions of Safari (macOS)

In order to gratis upward resource to deliver client-requested features available to modern browsers, Google Maps Platform is catastrophe support for Internet Explorer 11. Microsoft concluded support for IE11 in 2022 and encouraged migration to Microsoft Edge.

Showtime in August 2022, a warning message started to announced to Internet Explorer 11 users at the pinnacle of maps. The final version of the Maps JavaScript API to support Cyberspace Explorer eleven is v3.47. Support for Internet Explorer 11 will be entirely discontinued in November 2022. This also applies to the IE mode in Edge.

Android

The current version of Chrome on Android 4.ane+.
Chrome WebView on Android 4.four+.

iOS

Mobile Safari on the current and previous major versions of iOS.
UIWebView and WKWebView on the current and previous major versions of iOS.
The current version of Chrome for iOS.

Tin can I print maps from the Maps JavaScript API?

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

How tin I be notified when at that place are changes to Google Maps Platform products?

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

How practise I contact technical support?

Run into Google Maps Platform Support and Resources for information about bachelor support options.

When is technical support available?

The back up squad is available 24x5 (weekdays from Monday ix a.yard. Tokyo fourth dimension to Friday 5 p.m. Pacific time) excluding regional holidays for "service unusable" issues.

How tin can I recover access to my Google Account?

If y'all lost admission to your Google Account (due east.g. joe@mycompany.com or joe@gmail.com), you can effort restoring the business relationship access by retrieving or resetting your countersign. Visit the How to recover your Google Account or Gmail article in Google Account Help.

Note: To restore access to a G Suite business relationship, enquire your Organisation admin to undelete the business relationship.

How can I recover access to a specific project?

If you lost admission to the project where you lot manage your Google Maps Platform implementation, you tin effort to recover information technology.

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

If you know the Projection Possessor and have access to your Google Account: Enquire the Project Owner to add you as a Projection Owner or Project Editor.
- If your project is part of an Organization: Contact your Organization admins and ask them to add together you lot as a Project Possessor.
If you practice non know any of the electric current Project Owners: If y'all 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 projection.

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

If yous lost admission to your Google Account: try to recover your username or password for your account.
If y'all cannot recover access to your Google Account: Create a new Google Account, then contact an existing projection possessor and ask them to add together your new Google Business relationship to the projection.

Tin can I utilise the Maps and Places SDK for iOS on Arm-based Macs?

Developing on the new Arm-based Macs is possible, nonetheless, it requires edifice and running on a physical iOS device. This is a temporary limitation while we look into calculation 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 available at:

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

Does my site meet the Google Maps Platform Terms of Service?

You can use the Google Maps Platform within your applications every bit long as your site meets the Google Maps Platform Terms of Service.

However, at that place are some uses of the Google Maps Platform that nosotros just don't want to see: maps that identify the places to purchase illegal drugs in a urban center, for instance, or any other illegal activity. We also respect people'south privacy, and so the Google Maps Platform shouldn't be used to identify private data about individuals.

You should employ your own counsel to determine whether your awarding complies with the Google Maps Platform Terms of Service earlier you lot develop and launch it. Google engineers tin can only offer technical aid and are not qualified to offer legal advice. Google reserves the right to suspend or end your use of the service at any time, so please read the Maps APIs Terms carefully.

Tin I directly admission map tiles and satellite imagery?

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

Tin I use 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 application complies with the Google Maps Platform Terms of Service.

Can I utilise 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 ane of the supported browsers.

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

Yes, Google Maps, Routes, Places services tin be used with private-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 document?

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

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

Nosotros are no longer collecting this data. The use of the indexing parameter has been deprecated and has no effect. You no longer demand to opt out explicitly, but nosotros encourage you lot to remove this parameter at your primeval convenience.

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

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

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

Usage limits and billing

How practise I set upwardly billing for my project?

Come across Become Started with Google Maps Platform.

How do Google Cloud Platform Free Tier customers upgrade to a paid account?

The Google Cloud Platform Free Tier program provides customers a no-charge trial with a $300 credit to use with whatever Google Cloud Platform (GCP) service, including the Google Maps Platform (GMP) APIs. When the no-charge trial ends, yous must upgrade to a paid business relationship to continue using these services. To upgrade to a paid account, visit the Cloud Console.

Does the Google Maps Platform have usage limits?

At that place are no maximum daily limits on the number of requests yous can make to Google Maps Platform products, and the merely usage limits are related to the maximum number of queries per second (QPS). (For Altitude Matrix, the limit is set in events per second (EPS) calculated as the sum of client-side and server-side queries.) The following table shows the usage limit for each API.

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

In club to govern expenditures, y'all 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 see the Pricing Sheet.

To acquire more well-nigh how Google Maps Platform APIs are billed, please see Understanding billing for Maps, Routes, and Places.

How are map loads counted on the Google Maps Platform?

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

A web folio or awarding displays a map using the Maps JavaScript API.
An application requests a single map image from the Maps Static API.

Street View panoramas are charged separately from map loads:

A static Street View panorama is charged for each asking to the Street View Static API to embed a static (not-interactive) Street View panorama.
A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, Maps SDK for iOS application.

Afterwards a web folio or awarding loads a map, or a static map image, or a Street View panorama, whatever user interactions with information technology, such equally panning, zooming, or switching map layers, practise not generate additional map loads or touch usage limits.

How practice I monitor my usage?

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

Select the project that contains the API y'all desire to review.
From the list of APIs on the Dashboard, click the proper noun of the API.
About the top of the folio, click Metrics or Quotas.

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

If you haven't already done so, set up billing.
Go to the Cloud Console billing page.
Select a project.
In the left sidebar, click Reports. Use the filters on the right sidebar to view reports on your billing business relationship.

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

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

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

If yous exceed the request QPS limits or otherwise abuse the service, requests will return a specific error message. If you proceed to exceed limits, your access to the Google Maps Platform may be blocked.

Annotation: Four of the web service APIs accept an equivalent customer-side service bachelor in the Maps JavaScript API: Directions, Altitude Matrix, Height, and Geocoding.

Usage limits exceeded

If you lot exceed the usage limits yous will become an OVER_QUERY_LIMIT status code as a response.

This means that the spider web service volition cease providing normal responses and switch to returning simply status code OVER_QUERY_LIMIT until more than usage is immune over again. This can happen within a few seconds, if the fault was received considering your awarding sent too many requests per second.

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

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

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

If my web site or application becomes suddenly pop, will my maps finish working?

Once you have a billing business relationship, if you exceed the no-accuse, $200-monthly usage limit and you exercise non accept a valid payment method on your billing account (credit carte, bank transfer, ...), the API ceases to part until you add together a valid payment method.

How volition usage exist calculated and billed?

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

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

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

Is pricing available in other currencies?

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

I've prepare upward billing. How practice I view my bill?

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

Boosted resources:

Larn how to view your cost and payment history.
Learn how to get an invoice or payment receipt.
Learn how to ready and manage billing alerts.

How practice I avoid a big bill if my usage unexpectedly increases?

The Google Maps Platform provides ways to prepare daily request limits and set maximum daily billable limits. Yous can cap the maximum daily limit on usage to protect against unexpected increases. You can also ready upkeep alerts to receive email notifications when the charges on the billing account reach a threshold y'all set.

Capping the maximum daily billable limit:

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

Go to the APIs & Services Dashboard.
Select a project if prompted.
Select an API from the list, then click the Quotas tab.
Click the edit icon next to the "requests per twenty-four hours" quota.

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

Setting and managing budget alerts:

Set up upkeep alerts to send email notifications to billing administrators when the charges on the billing account achieve a threshold you set. Billing administrators volition be sent email notifications when the estimated charges on the billing account exceed l%, 90%, and 100% of the threshold.

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

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

Create a new billing business relationship (if you already have a billing account, you tin skip this stride).
Associate the billing account with your project.

Why is my quota limit set up to 1 request per twenty-four hour period? How tin I enhance this limit?

If you have not created and attached a billing account to your projection, your Maps Platform APIs will exist limited to 1 request per twenty-four hours. You can get higher quota past creating and attaching a billing account. To practise this, see Become Started with Google Maps Platform.

Once you take created and fastened a billing account, your daily quota limit volition be removed. You can decide to prepare a limit to prevent unexpected spend, in the Cloud Panel.

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

You accept received this notice because Google has determined that your account has been using multiple billing accounts. This is a violation of Google's terms, as divers in section 3.2.4 of the Google Maps Platform Terms of Service. Nether these terms, information technology is forbidden to create multiple billing accounts. To learn more than, run into the Billing Account Violation FAQ.

Using the Google Maps Platform

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

Each time y'all employ Google Maps Platform products, you must include an API key to validate your request. The Google Maps Platform is available for Android, iOS or Web apps, and via HTTP web services.

API Key:

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

Digital Signature:

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

Restrictions:

API key restrictions are optional, simply we strongly recommend you restrict all API keys for greater security. See API security best practices for more than details.
You can add together an application restriction to the API key. Once restricted, a cardinal will only work on platforms that support that type of restriction. Four types of application restrictions are available. APIs enforcing the aforementioned restriction type can employ the same restricted key.
- IP addresses (private servers) - for use with the web service APIs.
- HTTP referrers (spider web sites) - for use with the web APIs.
- Android app restriction (by package name and fingerprint) - for use with the Maps SDK for Android.
- iOS app restriction (by iOS packet identifier) - for use with the Maps SDK for iOS.
Y'all tin also add together an API brake to the API key. For more information, see Get, add, and restrict an API cardinal.

The tabular array below indicates the central/credential and application restriction for each Google Maps Platform API/SDK.

API/SDK	Credential & Application Restriction
Maps SDK for Android	API key with Android brake^ane
Places SDK for Android	API key with Android brakeⁱ
Maps SDK for iOS	API central with iOS restriction^ane
Places SDK for iOS	API cardinal with iOS brakeⁱ
Maps JavaScript API	API cardinal with HTTP referer restriction¹
Maps Static API	API key with HTTP referer restrictionⁱ + Digital Signature²
Street View Static API	API key with HTTP referer restriction¹ + Digital Signatureⁱⁱ
Maps Embed API	API key with HTTP referer restriction^ane
Directions API	API primal with IP address restrictionⁱ
Altitude Matrix API	API primal with IP address brake¹
Elevation API	API fundamental with IP accost brake^ane
Geocoding API	API key with IP address brake^ane
Geolocation API	API fundamental with IP accost restriction¹
Roads API	API central with IP accost brakeⁱ
Fourth dimension Zone API	API fundamental with IP address restriction¹
Places API	API key with IP address brake^one

¹ API key restrictions are optional, but we strongly recommend you restrict all API keys for greater security.

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

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

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

Before you switch the API fundamental restriction type from HTTP referer to IP accost, ensure that all the APIs that utilize the API primal support the IP brake type. APIs of the same brake type can utilise the aforementioned restricted key. If you need to enforce more than one restriction, add a carve up key with the required restriction. See how to add together a new API central.

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

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

Get to the Credentials page of the Deject Console.
Select the project that contains the API central yous desire to edit.
On the Credentials page, from the list of API keys, select the name of the API primal to edit the details of the key.
In the Key restriction section of the folio, select "IP addresses (web servers, cron jobs, etc.)" and insert the appropriate server IP addresses, so click Save.

How practise I become a new API central?

Encounter Become Started with Google Maps Platform.

How tin I observe 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
Distance Matrix API
Maps SDK for Android
Places SDK for Android
Maps SDK for iOS
Places SDK for iOS

You lot tin also 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 can I load the API into a page asynchronously later on the page has loaded?

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

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

By default the API will attempt to load the nigh appropriate linguistic communication based on the users location or browser settings. Some APIs allow you lot to explicitly prepare a language when you make a request. More data on how to set the language is available in the documentation for each API:

Maps JavaScript API
Geocoding API
Directions API
Altitude Matrix API
Places API

Supported Languages:

Google often updates supported languages. This list may not exist exhaustive and is subject to change.

Language Code	Language	Language Lawmaking	Linguistic communication
af	Afrikaans	ja	Japanese
sq	Albanian	kn	Kannada
am	Amharic	kk	Kazakh
ar	Arabic	km	Central khmer
hy	Armenian	ko	Korean
az	Azerbaijani cluster	ky	Kyrgyz
eu	Basque	lo	Lao
exist	Belarusian	lv	Latvian
bn	Bengali	lt	Lithuanian
bs	Bosnian	mk	Macedonian
bg	Bulgarian	ms	Malay
my	Burmese	ml	Malayalam
ca	Catalan	mr	Marathi
zh	Chinese	mn	Mongolian
zh-CN	Chinese (Simplified)	ne	Nepali
zh-HK	Chinese (Hong Kong)	no	Norwegian
zh-TW	Chinese (Traditional)	pl	Polish
hour	Croation	pt	Portuguese
cs	Czech	pt-BR	Portuguese (Brazil)
da	Danish	pt-PT	Portuguese (Portugal)
nl	Dutch	pa	Punjabi
en	English	ro	Romanian
en-AU	English (Australian)	ru	Russian
en-GB	English (U.k.)	sr	Serbian
et	Estonian	si	Sinhalese
fa	Farsi	sk	Slovak
fi	Finnish	sl	Slovenian
fil	Filipino	es	Spanish
fr	French	es-419	Castilian (Latin America)
fr-CA	French (Canada)	sw	Swahili
gl	Galician	sv	Swedish
ka	Georgian	ta	Tamil
de	High 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	half-dozen	Vietnamese
id	Indonesian	zu	Zulu
it	Italian

Y'all tin can come across what the map will look like in any of the languages listed to a higher place in this sample application.

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

The Maps JavaScript API, Maps Static API, and Web Service APIs tin can be accessed over secure (HTTPS) connections. Delight run across the documentation for the API concerned for information on how to admission the API over SSL.

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

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

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

If you wish to asking a feature, please too commencement raise it in the relevant forum to confirm that a solution that meets your requirements is not already available.

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

Earlier adding a bug or characteristic asking to the Event Tracker please exist certain to check that the issues or feature concerned has not already been added. If information technology has, you tin star the outcome to register your interest and be notified of updates.

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS utilize cookies discipline to Google's Privacy Policy, such equally calculating daily and 7-mean solar day active users and service abuse prevention. These cookies are not associated with any signed-in Google Account and are non logged with the residue of the information collected from the API calls.

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

Google'south Developer Relations squad maintains a presence on Stack Overflow — a collaboratively-edited question and respond site for programmers. It'southward a groovy place to ask technical questions well-nigh developing and maintaining Google Maps applications. More information most asking questions on Stack Overflow is available on the Back up page.

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

Search the current discussions. Chances are someone else has experienced a similar result and found a set up.
Submit a link to your site if possible. But post code snippets if the code is not hands viewable online.
Provide all relevant information including browser versions, errors, and all other facts that may exist useful in troubleshooting this trouble.

Errors and troubleshooting

What does this mistake mean?

If y'all encounter an error while loading or running the Google Maps APIs, please run into the following links to detect explanations for the fault codes:

Maps JavaScript API
Maps Static API
Street View Static API
Maps Embed API
Acme API
Geocoding API
Geolocation API
Directions API
Distance Matrix API
Roads API
Fourth dimension Zone API
Places API

My maps appear darker than usual. What's happening?

Under certain circumstances, a darkened map, or 'negative' Street View epitome, watermarked with the text "for evolution purposes only", may be displayed. This behavior typically indicates issues with either an API cardinal or billing. To utilise Google Maps Platform products, you must have a billing account and all requests must include a valid API cardinal. The following menstruum will assist troubleshoot this:

Are you using an API key?

I'm non sure. How tin can I check if I am using an API key?

An API key is passed equally the central parameter in the URL that is used to load the Maps JavaScript API. Here are a few options to check if y'all are using an API key:

Use the Google Maps Platform API Checker Chrome extension. This allows y'all to determine if your website is properly implementing Google'south licensed Maps APIs.
If you are using a library or plugin to load the Maps JavaScript API, check the settings for that library and look for an API key option.
Check errors in your browser. If you see the post-obit letters, y'all are not using your API key correctly:

Google Maps JavaScript API warning: NoApiKeys
Google Maps JavaScript API error: MissingKeyMapError

For web developers:

If you have admission to the source code of your application, expect for the <script> tag which is used to load the Maps JavaScript API. When loading the Maps JavaScript API, substitute YOUR_API_KEY in the code below with your API primal.
```
                                <script async defer     src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">   </script>                              
```
Check the network traffic generated by your website in the browser. In Chrome, this tin be viewed using the DevTools Network tab. Hither you will see the network requests fabricated by your website. Requests fabricated using the Maps JavaScript API volition be nether the path maps/api/js. Here you can confirm if the requests are using the key parameter. It may be helpful to filter your network traffic by maps/api/js when viewing the Network tab.

No, I am not using an API key.

To get an API fundamental, click the button below. If you do not run across a guided setup, follow the full instructions at Go Started with Google Maps Platform.
Get Started

Yep, I am using an API key.

Great! Let's motility on and bank check if a billing account is attached to your project.

Is a billing account attached to your projection?

I'grand not sure. How can I check if billing account is fastened to my projection?

Go to the Billing page in the Google Cloud Panel and select the project nether which your API key was created. To confirm the fundamental is associated with the project:

Go to the Credentials section, which can exist accessed from the left side bar under Google Maps Platform > Credentials.
Bank check that the API cardinal you currently use on your website is listed. If that'south not the instance, switch to a different projection, and check the credentials in that location.
If you lot cannot locate the project for your API key, y'all may have lost admission to this project. Enquire others in your organisation for aid. If the original project cannot exist located, you lot should:
1. Create a new project. This tin can be done by selecting New Project from the projects list, or past selecting Create Projection via the Resource Managing director page.
2. Create a new API key. This can be done on the Credentials folio. Once there click Create credentials and then select API key.

In one case yous accept located your projection in the Deject Console, check if a billing account is fastened by navigating to the Billing department in the left side card.

No, a billing business relationship is not attached to my project.

Become to the Enable Billing page in the Deject Console and add together a billing business relationship to your project. For additional information, see Get Started with Google Maps Platform.

Aye, a billing account is fastened to my project.

Not bad! Let'due south brand sure the provided billing method is valid.

Is the provided billing method no longer valid (for case an expired credit card)?

You can add, remove, or update a payment method in the Deject Console.

Is there an exceeded self-imposed daily limit on the API?

If you have prepare a daily limit on any of your APIs, which is common to prevent unexpected increases, you can resolve this by increasing your daily limit.

You can check your daily limits past going to the APIs & Services Dashboard in the Deject Console. One time there:

Select a project if prompted.
Select an API from the list, then click the Quotas tab.

Does your API key have an IP addresses restriction?

API keys with an IP addresses restriction can simply exist used with spider web services that are intended for use from the server side (such every bit the Geocoding API and other Web Service APIs). Most of these web services accept equivalent services within the Maps JavaScript API (for example, come across the Geocoding Service). To use the Maps JavaScript API client side services, you will demand to create a split up API key which can exist secured with an HTTP referrers restriction (see Get, add, and restrict an API cardinal).

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 asking.
The provided API cardinal is invalid.
The projection does not have a billing account attached.
A self-imposed usage cap has been exceeded.
The provided method of payment is no longer valid (for example, a credit card has expired).
You take exceeded the QPS limits for a given API.

To utilize Google Maps Platform products, you lot must take a billing business relationship, and all requests must include a valid API key. To fix this, take the post-obit steps:

Gear up a billing account.
Become a new API key.
Adapt your usage cap to increment your daily limit (if applicative).

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, yous 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 error: "This IP, site or mobile application is non authorized to apply this API cardinal."?

There are various scenarios which may crusade this error:

Yous've enabled IP address (server) restrictions on your API fundamental, and an unauthorized IP accost is attempting a request.
You've enabled HTTP referrer (website) restrictions on your API primal, and an unauthorized referrer is attempting a request.
You lot've restricted usage to your Android apps by setting a package proper name and fingerprint, and an unauthorized Android app is attempting a request.
You've restricted requests from iOS apps by specifying bundle identifiers and an unrecognized iOS app is attemting to ship a request.
It used to be possible to get this fault if y'all used any of the 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 central restriction blazon from an HTTP referer restriction to an IP address restriction. For more information about restricting API keys, see API Fundamental Best Practices.

View and Edit your API Key Credentials

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

Go to the Credentials page of the Cloud Panel.
Select the project that contains the API primal you want to review.
To view credential details, including any restrictions set for the central, from the listing of API keys, click the name of the fundamental.
The full credentials of the selected API primal are displayed, including any restrictions fix upwards for the primal. From here, the restrictions tin can be changed, deleted, or updated as needed.

How practise I resolve the mistake: "API keys with referer restrictions cannot be used with this API."?

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

Google Maps Platform Services

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

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

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

Which countries is geocoding available in?

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

The accurateness of geocoded locations may vary per country, so you lot should consider using the returned location_type field to determine if a good 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, and so it is subject to modify.

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

The API geocoder and Google Maps geocoder sometimes employ unlike information sets (depending on the land). The API geocoder occasionally gets updated with new data, then you lot can await to encounter results changing or improving over fourth dimension.

How should I format my geocoder queries to maximise the number of successful requests?

The geocoder is designed to map street addresses to geographical coordinates. We therefore recommend that yous format geocoder requests in accordance with the post-obit guidelines to maximize the likelihood of a successful query:

Specify addresses in accordance with the format used by the national postal service of the state concerned.
Practise not specify additional address elements such every bit business names, unit numbers, flooring numbers, or suite numbers that are not included in the address as defined by the postal service of the country concerned. Doing so may result in responses with ZERO_RESULTS.
Format plus codes every bit shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %xx):
- global code is a 4 graphic symbol surface area code and half dozen grapheme or longer local lawmaking (849VCWC8+R9 is 849VCWC8%2BR9).
- compound code is a 6 character or longer local lawmaking with an explicit location (CWC8+R9 Mountain View, CA, United states is CWC8%2BR9%20Mountain%20View%20CA%20USA).
Utilize the street number of a premise in preference to the building name where possible.
Apply street number addressing in preference to specifying cantankerous streets where possible.
Do non provide 'hints' such as nearby landmarks.

How should I format a U.Southward. accost on a numbered highway for geocoding?

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

Canton Roads: "Co Road NNN" where NNN is the road number. eg. "Co Road 82"
State Highways: "Land NNN" where State is the full name of the country and NNN is the highway number. eg. "California 82"
U.S. Highways: "U.Due south. NNN" where NNN is the highway number. eg. "U.Southward. 101"
U.Due south. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"

When should I use an API geocoder form and when should I use 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 lot to provide driving directions for single and multi-leg journeys. Routing options help you shape directions with a travel fashion (driving), a unmarried or a fix of routes, and restrictions (no cost roads). The service is bachelor 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. Meet the Directions API for more information.
JavaScript API, for client-side applications, allows you to provide driving directions via the google.maps.DirectionsService class. The DirectionsRenderer course can automatically create the overlays and directions panel for you. Additional examples are provided in the documentation.
Java, Python, become, and Node.js client interfaces, for server-side applications, provide the same functionality. Reference documentation is available at these links: Java Client 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 run into countries currently supported past Driving Directions in the Google Maps Platform products, consult the Google Maps coverage information. Please annotation that the availability of driving directions data depends on our contracts with data providers, and is subject to modify.

In which countries are transit directions available?

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

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

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

What are the limits on the size and complication 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 return KML files that are hosted on intranet sites on a map?

The KmlLayer form that generates KML overlays in the Maps JavaScript API uses a Google hosted service to remember and parse KML files for rendering. Consequently it is not possible to display KML files that are not hosted at a URL that is bachelor 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 lot render the KML on the client side by using third-party JavaScript libraries. As the KML file is analyzed past the browser, functioning may be lower than by using the KmlLayer class.

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

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

Notation that Maps Static API URLs can comprise a maximum of approximately 8,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 information on how the number of decimal places used relates to the accuracy on the Globe see the Wikipedia commodity on Decimal Degrees.

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

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

How practice I report a problem on the Google basemap?

Send feedback through Google Maps for incorrect or missing map information such equally:

Wrong addresses or mark locations
Wrong road names
Wrong data virtually one-style and two-mode roads
Incorrectly fatigued road
Closed roads
Roads that don't be

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

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

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

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

Some client-side features are instrumented to written report success or failure for the purpose of calculating the SLO (Service Level Objective). This information is sent to Google at maps.googleapis.com/maps_api_js_slo/log in calls that log SLO information. This information includes success status, latency, and version/channel of the Maps JavaScript API in utilise. The calls may be batched for performance. 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 instance: Content-Security-Policy: default-src 'cocky' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> with HTML Meta Tags.

Maps JavaScript API

How long volition the Maps JavaScript API piece of work afterward it has been loaded?: You need to refresh the page that loads the Maps JavaScript API at least once every 5 days.

Google Maps SDK for iOS

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

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

For more information, see the post-obit StackOverflow thread.

How do I resolve the error: kGMSPlacesRateLimitExceeded?

If yous are seeing this mistake, you lot may exist 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 before long equally possible. See the migration guide for details.

I'm getting crashes when debugging with an iOS eight.10 device. What should I do?

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

In XCode, choose Product, Scheme, Manage Schemes.
Select a scheme and choose Edit....
Set the GPU Frame Capture option to Disabled. Note that this option may not be present for all devices.

What's the bear upon of rounded and wider screens on the Google Maps iOS SDK?

Starting time with the iPhone X, iPhones have a screen shape featuring rounded corners, a notch at the height for the device'due south sensor housing, and an indicator at the bottom of the screen for accessing the Habitation screen. Equally of iOS 11.0 SDK, Apple added the Safety Area API allowing developers to position elements in an area which is safe 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 trouble link. With version 2.4, these visual elements and controls could be clipped past the new screen shape. In landscape mode, the indoor floor picker may be clipped by either the notch or the dwelling house push 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 then that the visual elements aren't clipped.

By default, we volition ever include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe expanse. If you pattern your interface with the supposition that everything is positioned within the condom area, this will work without any actress effort.

If you accept designed an interface which doesn't piece of work with our default aligning, we take introduced a new property to GMSMapView, called paddingAdjustmentBehavior. GMSMapView now allows you to selection from one of three padding adjustments behaviors: 'E'er' (default), 'Automatic', and 'Never'.

If GMSMapView is ready to use the 'Ever' padding beliefs, it volition e'er add together the safe area insets to the padding. This allows y'all to design your interface with the assumption that all placement is from the edges of the safe area. This is the default value.

If GMSMapView is set to use the 'Automated' padding behavior, it will always choose the larger of padding or safe area inset. This will allow you to add together padding from the screen border while always ensuring that all elements stay inside the safe area.

If GMSMapView is gear up to use the 'Never' padding beliefs, it volition never add together the safety 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 safety area, or if our other behaviors don't human action 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 belongings. This ways that there is no padding to suit and GMSPanoramaView will 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 you are seeing this mistake, you lot 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 bachelor. Please update your app to use the latest version as shortly as possible. Run into the migration guide for details.

My app only shows bare grey tiles instead of a map. How tin I resolve this?

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

Brand sure y'all have adb installed. If not, you tin follow the guide hither.
Install the app that shows the problem on a device or an Android emulator. If you lot use Android emulator, make sure the emulator settings has Play Store included.
In Android Studio terminal, run adb logcat -e "Google Maps Android API". This volition simply print lines where the log message matches "Google Maps Android API" (Optionally, you lot can output the log to a text file by appending: > logcat.txt)
Reproduce the issue on your device and check for common errors such as:

The wrong/unintended API Key is being referenced in Manifest.
Billing isn't enabled on Projection.
The SDK isn't enabled on projection APIs.
The incorrect SHA1 fingerprint is added to the API Central 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 as this would expose your URL signing secret to end users. Therefore signatures should simply be generated past server side components.

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

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

A signature has been specified simply is wrong for this request.
The request specifies a Google Maps Platform Premium Plan an API fundamental but does not specify a signature, and the service being called requires that requests made using an API fundamental include a valid signature.
A signature has been specified but the associated Google Maps Platform Premium Programme API primal has not been specified.

Except equally otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2022-04-20 UTC.