Google Maps API Key Setup
Google requires a Cloud project with billing enabled and a restricted API key before Maps will work in production. Follow the path that matches your situation.
- New Project and New API Key (most common)
- You already have an API key but need to enable billing
- Restrict the API key to your domain (required for production)
1. New project and new API key (most common)
Use Google’s official interactive setup:
- Go to the Google Maps Platform Get Started page.
- Click the Get Started button. This opens the Cloud Console guided flow.
- Sign in with the Google account you want to own the project.
- Create a new project (or select an existing one).
- Enable billing when prompted. A credit card is required, but Google provides monthly free usage credits for Maps Platform. You will not be charged until you exceed the free tier.
- Enable the Maps JavaScript API (and any other Maps APIs you need).
- Create an API key.
- Immediately restrict the key (see section 3 below).
Official detailed guide: Set up the Maps JavaScript API
2. You already have an API key but need to enable billing
Billing must be active on the project or maps will not load (even for low usage).
- Go to the Google Cloud Console.
- Select the correct project in the top project picker.
- Open the menu (☰) → Billing.
- Link an existing billing account or create a new one and add a payment method.
- Confirm the project is now linked to an active billing account.
Once billing is enabled, your existing key should start working (after any restrictions are also set– see below).
3. Restrict the API key to your domain (required for production)
Unrestricted keys can be stolen and used by anyone, which can lead to unexpected charges. Always restrict the key.
- In Cloud Console, go to APIs & Services → Credentials.
- Click the name of your API key.
- Under Application restrictions:
- Choose Websites.
- Add your domain(s). Recommended format:
https://yourdomain.com/*https://*.yourdomain.com/*(covers subdomains)
- Under API restrictions:
- Choose Restrict key.
- Select only the Maps APIs you actually use (at minimum Maps JavaScript API).
- Click Save.
Full official instructions: Google Maps Platform security guidance
What to send Tiny Frog
Once the key is created, billing is enabled, and restrictions are set, copy the API key and send it to us. We will add it to your site.
Important notes
- Google gives a monthly free usage allowance for Maps Platform. Most small-to-medium sites stay within the free tier.
- You remain responsible for any charges that exceed the free allowance.
- Never share an unrestricted key.
- Keys can take a few minutes to become fully active after changes.
If you get stuck at any step, reply with a screenshot of the screen you are on and we can help.