Google Maps API error codes: complete troubleshooting guide ​
When your Google Map does not load, the browser console contains an error code that tells you exactly what went wrong. This guide covers every common error, its cause, and the fix.
ApiNotActivatedMapError ​
Cause: One or more required APIs are not enabled on your Google Cloud project.
Fix: Click this link to enable all four required APIs at once: Enable APIs. Make sure you select the correct project.
InvalidKeyMapError ​
Cause: The API key you provided is not valid. It may be misspelled, deleted, or belong to a different project.
Fix: Go to Google Cloud Console → Credentials and verify your key exists. Copy it again and paste it in WP Google Street View → Settings.
RefererNotAllowedMapError ​
Cause: Your API key has HTTP referrer restrictions, and your domain is not in the allowed list.
Fix: Edit your API key in the Cloud Console. Under Application restrictions → HTTP referrers, add:
https://yourdomain.com/*
https://www.yourdomain.com/*Changes take up to 5 minutes to propagate.
MissingKeyMapError ​
Cause: No API key was provided in the request.
Fix: Go to WP Google Street View → Settings and enter your API key. If the field is already filled, the key may not be saving correctly — check for trailing spaces.
ExpiredKeyMapError ​
Cause: The API key has been deleted or the associated billing account has been suspended.
Fix: Check your billing status in the Cloud Console. Reactivate billing or create a new API key.
OverQueryLimitMapError ​
Cause: You have exceeded your Google Maps API quota for the current period.
Fix: Check your usage in Cloud Console → APIs & Services → Dashboard. Consider enabling budget alerts. For most sites, this error means billing is not enabled (Google treats it as a $0 quota).
"For development purposes only" watermark ​
Cause: Billing is not enabled on the project, or the free trial has expired without a billing account linked.
Fix: Enable billing. Google provides $200/month in free credits, so you likely will not pay anything.
Grey or blank map ​
Cause: Multiple possible causes: invalid key, missing API, JavaScript conflict with a caching plugin, or missing billing.
Fix: Open your browser's Developer Tools (F12), go to the Console tab, and look for one of the error codes above. Fix the specific error reported.
Map loads in admin but not on front end ​
Cause: A caching or JavaScript optimization plugin is interfering.
Fix: Exclude maps.googleapis.com from JS minification and deferral. See our caching compatibility guide.
Street View shows a blank panorama ​
Cause: No Street View coverage exists at the specified coordinates.
Fix: Open Google Maps, drop the Pegman on your location, and verify that panoramic imagery is available. If not, use the Google Maps mode instead.
Error persists after fixing ​
If you have corrected the configuration but the error persists:
- Clear all caches (browser, WordPress caching plugin, CDN)
- Wait 5 minutes (API key restriction changes are not instant)
- Test in an incognito/private browser window
- Check the browser console again for a different error