Page Summary
-
Google Maps Platform provides APIs and SDKs for integrating maps and location-based services into your applications, covering functionalities such as mapping, routing, places, and environment data.
-
Getting started requires selecting desired APIs, obtaining an API key, and setting up billing, with usage limits and costs outlined in the pricing details.
-
Troubleshooting resources are available for common issues like API key errors, rate limits, authorization errors, and platform-specific problems on iOS and Android.
-
Usage is subject to terms of service, including restrictions on data access, tracking applications, and prohibited usage, with support available for technical and account-related inquiries.
-
The platform supports various features like geocoding, directions, transit information, and KML/GeoRSS overlays, with specific considerations for URL signing security and iOS/Android debugging.
Getting Started
- What is Google Maps Platform?
- How do I get started with Google Maps Platform?
- Which API do I need?
- How do I start using the APIs on my site?
- Which countries does Google Maps Platform cover?
- Can I put Google Maps on my site without using Google Maps Platform products?
- How do I deliver Maps applications on mobile devices?
- Which web browsers do the Maps JavaScript API and Maps Embed API support?
- Can I print maps from the Maps JavaScript API?
- How can I be notified when there are changes to Google Maps Platform products?
- How do I contact technical support?
- When is technical support available?
- How do I recover access to my Google Account?
- How do I recover access to a specific project?
- Can I use the Maps and Places SDK for iOS on Arm-based Macs?
Understand the terms of service
- What are the terms of service for Google Maps Platform products?
- Does my site meet the Google Maps Platform Terms of Service?
- Can I directly access map tiles and satellite imagery?
- Can I use Google Maps Platform products for tracking applications?
- Can I use Google Maps Platform products in my non-Web application?
- Can I use Google Maps Platform products on a site that is password protected?
- Can I create an application that includes Google Maps Platform data in a document?
- How can I opt out of including my content in Google Search results?
- Can I generate a map image using the Maps Static API which I store and serve from my website?
Usage limits and billing
- How do I set up billing for my project?
- What is the Google Cloud Free Trial and how do Free Trial users upgrade to a paid account?
- Does Google Maps Platform have usage limits?
- How is usage cost calculated?
- How are map loads counted on 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 website or application becomes suddenly popular, will my maps stop working?
- How will usage be calculated and billed?
- How much does it cost to use 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 large bill if my usage unexpectedly increases?
- I got a message saying that my project is linked to the "Google Maps Platform Transition Account", but I don't have access to that account. What do I do?
- Why is my quota limit set to 1 request per day? How can I raise this limit?
- I received a billing violation notice. How do I resolve this?
Use Google Maps Platform
- Which keys or credentials should I use for different Google Maps Platform products?
- How do I switch my key restriction type from an HTTP referer to an IP address restriction?
- How do I get a new API key?
- How can I find the changes introduced in each version of Google Maps Platform?
- How can I load the API into a page asynchronously after the page has loaded?
- How can I get Google Maps Platform products to display in a language other than English?
- Can the Google Maps Platform be accessed over HTTPS (TLS)?
- How do I report a bug or request a new feature in Google Maps Platform?
- How do Google Maps Platform APIs use site cookies?
- I can't find the answer to my question. Who should I contact?
Errors and troubleshooting
- What does this error mean?
- My maps appear darker than usual. What's happening?
-
How do I resolve the error codes
OVER_DAILY_LIMITorOVER_QUERY_LIMIT? -
How do I resolve the error codes:
kGMSPlacesRateLimitExceededor9005 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 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 US address on a numbered highway for geocoding?
- When should I use an API geocoder class and when should I use the HTTP Geocoding Service?
- How do I provide driving directions with 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 certain countries?
- How do I report a problem on the Google basemap?
- How is performance monitored for the services used with Maps JavaScript API?
Maps JavaScript API
Google Maps SDK for iOS
-
How do I resolve the error:
kGMSPlacesRateLimitExceeded? - I'm getting crashes when debugging with an iOS 8.x device. What should I do?
- What's the impact of rounded and wider screens on the Google Maps iOS SDK?
Google Maps SDK for Android
-
How do I resolve the error:
9001 Operation failed due to exceeding the quota usage limit? - My app only shows blank grey tiles instead of a map. How can I resolve this?
URL signing
- Can I sign URLs using JavaScript?
- Why am I receiving a HTTP 403 Forbidden response to my Maps API web service requests?
Getting Started
- What is Google Maps Platform?
-
Google Maps Platform is a set of APIs and SDKs that allows developers to embed Google Maps into mobile apps and web pages, or to retrieve data from Google Maps. There are several offerings. Depending on your needs, you may find yourself using one or a combination of these APIs and SDKs:
Maps:
- Maps JavaScript API
- Maps SDK for Android
- Maps SDK for iOS
- Map Tiles API
- Aerial View API
- Maps Static API
- Street View Static API
- Maps URLs
- Maps Embed API
- Maps Datasets API
Routes:
Places:
- Places API
- Places SDK for Android
- Places SDK for iOS
- Places Library, Maps JavaScript API
- Places Aggregate API
- Address Validation API
- Geocoding API
- Geolocation API
- Time Zone API
Environment:
- How do I get started with Google Maps Platform?
- Which API do I need?
-
For help in finding the right API based on your functional requirements, take a look at the Capabilities Explorer.
- How do I start using the APIs on my site?
-
See the Overview, Developer, and Get Started guides for the specific API or SDK you are interested in. For example, check out the guides for Maps SDK for Android or Maps JavaScript API.
- Which countries does Google Maps Platform cover?
-
The Google Maps team is constantly pushing new map data out and increasing our international coverage. Consult the Google Maps coverage data for the latest coverage information. You can filter the data with the filter box at the top of the page. Coverage data can change if licensing agreements with the data providers change.
Also see:
- 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 blog, without any programming or use of 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 an iOS application, use the Maps SDK for iOS.
The Maps JavaScript API has been developed to cater to mobile devices, and is suitable for browser applications targeted at both the desktop and devices that include a web browser with a full JavaScript implementation, such as the Apple iPhone.
For applications targeted at devices not suitable for using the Maps JavaScript API, the Maps Static API delivers map images in GIF, JPG, and PNG formats, including markers and polylines. Note that use of the Maps Static API outside of browser based applications requires that the map image be linked to Google Maps.
- Which web browsers do the Maps JavaScript API and Maps Embed API support?
-
The Maps JavaScript API and Maps Embed API support the following web browsers:
Desktop- The current version of Microsoft Edge (Windows), excluding IE mode.
- The two latest major stable versions of Firefox (Windows, macOS, Linux).
- The two latest major stable versions of Chrome (Windows, macOS, Linux).
- The two latest major stable versions of Safari (macOS).
- The current version of Chrome on Android 4.1+.
- Chrome WebView on Android 4.4+.
- Mobile Safari on the current and previous major versions of iOS.
- UIWebView and WKWebView on the current and previous major versions of iOS.
- The current version of Chrome for iOS.
- Can I print maps from the Maps JavaScript API?
-
Printing from the Maps JavaScript API is not supported. This is because printing support is inconsistent across commonly used browsers.
- How can I be notified when there are changes to Google Maps Platform products?
-
You should subscribe to the Google Maps Platform Blog for news updates across the various Google Geo developer offerings.
- How do I contact technical support?
-
See Google Maps Platform Support and Resources for information about available support options.
- When is technical support available?
- The support team is available 24x5 (weekdays from Monday 9 AM Tokyo time to Friday 5 PM Pacific time) excluding regional holidays for "service unusable" issues.
- How can I recover access to my Google Account?
-
If you lost access to your Google Account (e.g. joe@mycompany.com or joe@gmail.com), you can try restoring the account access by retrieving or resetting your password. Visit the How to recover your Google Account or Gmail article in Google Account Help.
- Note: To restore access to a G Suite account, ask your Organization administrator to undelete the account.
- How can I recover access to a specific project?
-
If you lost access to the project where you manage your Google Maps Platform implementation, you can try to recover it.
If you have access to your project-associated Google Account:
- If you know the Project Owner and have access to your Google Account: Ask the Project Owner to
add
you as a Project Owner or Project Editor.
- If your project is part of an Organization: Contact your Organization admins and ask them to add you as a Project Owner.
- If you don't know any of the current Project 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 don't have access to your project-associated Google Account:
- If you lost access to your Google Account: try to recover your username or password for your account.
- If you cannot recover access to your Google Account: Create a new Google Account, then contact an existing project owner and ask them to add your new Google Account to the project.
- If you know the Project Owner and have access to your Google Account: Ask the Project Owner to
add
you as a Project Owner or Project Editor.
- Can 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 building and running on a physical iOS device. This is a temporary limitation while we look into adding more support for developing on simulators.
Understand 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:
- Does my site meet the Google Maps Platform Terms of Service?
-
You can use Google Maps Platform within your applications as long as your site meets the Google Maps Platform Terms of Service.
However, there are some uses of Google Maps Platform that we just don't want to see. For example, maps that identify the places to buy illegal drugs in a city or any other illegal activity. We also respect people's privacy, so Google Maps Platform shouldn't be used to identify private information about individuals.
You should use your own counsel to determine whether your application complies with the Google Maps Platform Terms of Service before you develop and launch it. Google engineers can only offer technical assistance and are not qualified to offer legal advice. Google reserves the right to suspend or terminate your use of the service at any time, so read the Maps APIs Terms carefully.
- Can I directly access map tiles and satellite imagery?
-
You may not access map tiles or satellite imagery through any mechanism besides Google Maps Platform (such as the creation of your own mapping API or the use of a bulk tile download script). Your application's access to the tiles will be blocked if it accesses them outside of Google Maps Platform. See the Google Maps Platform Terms of Service for more details.
- Can I use Google Maps Platform products for tracking applications?
-
There is no restriction on displaying real-time data (tracking) with Google Maps Platform products provided that the application complies with the Google Maps Platform Terms of Service.
- Can I use Google Maps in my non-Web application?
-
Yes, Google Maps Platform products can now be used in non-Web applications, provided that they adhere to the other restrictions of the Google Maps Platform Terms of Service.
The Maps JavaScript API is only supported when run in one of the supported browsers.
- Can I use Google Maps Platform products on a site that is password protected?
-
Yes, Google Maps, Routes, Places, and Environment services can be used with private-access applications. See the Google Maps Platform Terms of Service for more details.
- Can I create an application that includes Google Maps Platform data in a document?
-
If your application generates a document, either in electronic or printed form, no data from Google Maps Platform, including images, may be included in the document. 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 use of the
indexingparameter 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 page or site from search results, follow the instructions provided in our help 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
srcattribute of an HTMLimgtag or the CSSbackground-imageattribute of an HTMLdivtag 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 end users by Google.
Usage limits and billing
- How do I set up billing for my project?
- See Get Started with Google Maps Platform.
- What is the Google Cloud Free Trial and how do Free Trial users upgrade to a paid account?
-
The Google Cloud Free Trial is a 91-day program that lets new users try the most popular Google Cloud products, including Google Maps Platform (GMP) APIs, without any financial commitment. Signing up for the Free Trial creates a Free Trial billing account that is preloaded with $300 in free Welcome credit, which you can spend on GMP.
If you don't upgrade to a Paid billing account before 91 days pass or if you spend the $300 in free credit, then your Free Trial billing account will be closed and all of its associated projects and resources will be stopped. To keep resources you create during the Free Trial and your services running un-interrupted, upgrade to a Paid billing account. Read more about the Free Trial.
- Does Google Maps Platform have usage limits?
-
There are no maximum daily limits on the number of requests you can make to Google Maps Platform products, and the only usage limits are related to the maximum number of queries per minute (QPM).
The following table shows the usage limit for each API. You can view and modify quota limits in the Cloud Console.
API Usage limit Address Validation 6,000 QPM Aerial View: Lookup Video 180 QPM and 100,000 QPD Aerial View: Render Video 100 QPM and 100 QPD Air Quality 6,000 QPM Maps JavaScript API: 3D Maps 30,000 QPM Maps JavaScript API: Dynamic Maps 30,000 QPM Elevation 6,000 QPM Geocoding 3,000 QPM Geolocation 6,000 QPM Maps Grounding Lite 300 QPM Map Tiles API: 2D Map Tiles 6,000 QPM and 15,000 QPD Map Tiles API: Street View Tiles 6,000 QPM and 15,000 QPD Map Tiles API: Photorealistic 3D Tiles 12,000 QPM and 10,000 root requests per day. Navigation: Set destination requests 30,000 QPM Places 6,000 QPM Places Aggregate 1,200 QPM