RefererNotAllowedMapError 🔌 API

Google Maps: This API project is not authorized to use this API / RefererNotAllowedMapError / ApiNotActivatedMapError

The Maps API key isn’t allowed for this site/API — the API isn’t enabled, the referrer restriction doesn’t include your domain, or billing is off.

Seen on: REST API

Meaning

Each Maps API (Maps JavaScript, Places, Geocoding) must be enabled in the key’s project, billing must be active, and HTTP referrer restrictions must match the page URL (with wildcards).

Common causes

  • Specific API not enabled (ApiNotActivatedMapError)
  • Referrer restriction doesn’t match the domain (RefererNotAllowedMapError)
  • Billing not enabled
  • API restrictions on the key exclude the API

⚡ Quick fix

  1. Enable the needed API in Google Cloud
  2. Add https://example.com/* (and subdomains) to referrers
  3. Enable billing; check key’s API restrictions

Detailed fix by platform

Google Cloud

  1. bash
    # APIs & Services → Library → enable "Maps JavaScript API", "Places API"
# Credentials → API key → Website restrictions: https://*.example.com/*

How to diagnose

  1. Console — Exact error name in browser console
  2. APIs — Enabled list
  3. Restrictions — Referrers and APIs

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.