Google Maps Platform integration in **Google AI Studio (AIS)** allows developers
to rapidly prototype and deploy AI-driven web apps that feature interactive
maps, real-world place data, and routing capabilities.

With the **Maps Demo Key** integration, you can generate functional,
location-aware AI prototypes directly within AI Studio without needing to create
a Google Cloud billing account or leave your development context. If you already
use Google Cloud, you can connect a billed project to access all Google Maps
Platform products without daily demo quota limits, or start with a Maps Demo
Key and connect a project when you're ready to scale.

## Key features

- **Zero-friction onboarding**: Get a Maps Demo Key directly in AI Studio without entering a credit card or navigating the Google Cloud console, whether you're new to Google Cloud or already have Cloud projects.
- **Automatic intent detection**: AI Studio identifies geospatial prompts (such as searching for nearby places, displaying interactive maps, or calculating routes) and automatically configures Google Maps Platform recommendations and skills.
- **Instant prototyping**: Demo credentials are automatically provisioned behind the scenes so your AI-generated code runs immediately.
- **Seamless scaling**: When your app is ready to scale, link a Cloud Billing account or connect an existing billed Cloud project to remove any quota limitations.

## Ways to get started

AI Studio provisions Google Maps Platform credentials and stores them securely
in your app's secrets settings. How you get started depends on whether you're
new to Google Cloud:

- **New to Google Cloud**: AI Studio creates a free project and a Maps Demo Key for you to get started.
- **Existing Google Cloud users**: You can either choose no-cost prototyping with a Maps Demo Key (with a subset of APIs and daily quota limits) or get full access with production-grade quotas by connecting an existing billed Cloud project.

Maps Demo Keys are governed by the
[Maps Demo Project Terms of Service](https://cloud.google.com/terms/maps-platform/demo-project-terms).

| Feature | New user | Existing user (prototyping for free) | Existing user (connecting a billed Cloud project) |
|---|---|---|---|
| **Credential type** | Maps Demo Key | Maps Demo Key | Standard Google Cloud API key |
| **Billing setup** | No credit card or Google Cloud billing account required | No credit card or Google Cloud billing account required | Requires a Google Cloud Billing account |
| **API coverage** | All Google Maps Platform APIs (except Route Optimization, Solar, and Nav Connect), including: - [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript) (including Places UI Kit) - [Maps SDK for Android](https://developers.google.com/maps/documentation/android-sdk) and [iOS](https://developers.google.com/maps/documentation/ios-sdk) - [Places API](https://developers.google.com/maps/documentation/places) - [Routes API](https://developers.google.com/maps/documentation/routes) and Compute Routes Matrix - [Geocoding](https://developers.google.com/maps/documentation/geocoding) and [Geolocation APIs](https://developers.google.com/maps/documentation/geolocation) - [Address Validation API](https://developers.google.com/maps/documentation/address-validation) - [Maps Static](https://developers.google.com/maps/documentation/maps-static) and [Street View Static APIs](https://developers.google.com/maps/documentation/streetview) - [Air Quality](https://developers.google.com/maps/documentation/air-quality), [Pollen](https://developers.google.com/maps/documentation/pollen), and [Weather APIs](https://developers.google.com/maps/documentation/weather) - [Aerial View API](https://developers.google.com/maps/documentation/aerial-view) - [Maps Experience agent tools](https://developers.google.com/maps/ai/maps-experience-agent-tools.md.txt) | Commonly used prototyping APIs (see [supported features](https://developers.google.com/maps/demo-key.md.txt#supported-features)): - [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript) (including Places UI Kit) - [Places API](https://developers.google.com/maps/documentation/places) (excludes user-generated content such as photos and reviews) - [Routes API](https://developers.google.com/maps/documentation/routes) and Compute Routes Matrix - [Geocoding API](https://developers.google.com/maps/documentation/geocoding) - [Weather API](https://developers.google.com/maps/documentation/weather) - [Maps Experience agent tools](https://developers.google.com/maps/ai/maps-experience-agent-tools.md.txt) | 100% of Google Maps Platform API portfolio (including Route Optimization, Solar, and Nav Connect) |
| **Daily limits** | 100 calls per day per API | 100 calls per day per API | Standard quotas and monthly free usage |
| **Key restrictions** | Automated in-flow secret management | Automated in-flow secret management | Custom HTTP referrer, IP, or app restrictions |
| **Usage intent** | Prototyping, testing, and AI Studio web apps | Prototyping, testing, and AI Studio web apps | Production web and mobile apps |
| **Path to production** | Link a Cloud Billing account to the project; your key keeps working | Connect a billed Cloud project in AI Studio | Already production-ready |

> [!NOTE]
> **Note:** The Route Optimization, Solar, and Nav Connect APIs are not included in the Demo Key portfolio. These require upgrading to a standard Google Cloud API key.

## Troubleshooting and quotas

Demo Keys provided through AI Studio operate under daily request limits designed
for interactive development sessions. The daily request limit is 100 calls per
day per API.

### Quota Exceeded errors

If your app receives a `RESOURCE_EXHAUSTED` or quota exceeded error while using
a Demo Key:

1. **Daily Reset:** Demo key quotas automatically reset every 24 hours. You can resume testing after the reset cycle.
2. **Standard Key Quota Overlap:** If you are using a standard API key and encounter a quota error message mentioning demo environment limitations, verify your project's quota limits in the [Google Cloud Console Quotas page](https://console.cloud.google.com/iam-admin/quotas).
3. **Upgrade for Higher Volume:** If your prototyping needs exceed daily demo limits, upgrade to a standard Google Cloud account to unlock full production quotas.

### API not available errors

If you're an existing Google Cloud user prototyping with a Maps Demo Key and a
request fails with an API key restriction error (for example,
`ApiTargetBlockedMapError` in the Maps JavaScript API), the API isn't in the
[list of supported APIs](https://developers.google.com/maps/ai/ai-studio.md.txt#supported-apis) for that key. Connect a billed Cloud
project to use it.

## Upgrading to a production key

When your app is ready for production or requires higher quota limits, link a
Cloud Billing account in the
[Google Cloud console](https://console.cloud.google.com/welcome/new) to upgrade
your project. Your existing demo API key continues to work, so there's no need
to update your app code.

If you already have a Cloud billing account, you can also skip the Demo Key:
when you enable Google Maps Platform in AI Studio, choose one of your billed
Cloud projects to get a standard API key with full API coverage and standard
quotas from the start.

## Related resources

- [Get and use a Maps Demo Key](https://developers.google.com/maps/demo-key.md.txt)
- [Google Maps Platform Agent Skills](https://developers.google.com/maps/ai/agent-skills.md.txt)
- [Maps Grounding Lite (MCP)](https://developers.google.com/maps/ai/grounding-lite)
- [Google Maps Platform Code Assist](https://developers.google.com/maps/ai/code-assist.md.txt)