9 min read Store Locator
Google Maps API Error: Fix It or Use a No-Key Map
Diagnose the exact Google Maps API error, fix the key or billing configuration, or migrate your store locator to a map that needs no merchant API key.
A Google Maps API error usually comes from a missing or restricted key, a disabled API, or billing that is not enabled for the project. Read the exact code in your browser console first, then either fix that configuration or replace the map with a provider that does not require your own API key.
Find the exact Google Maps API error
Do not diagnose from a blank map alone. A zero-height map container, a blocked script, an invalid key, and disabled billing can look similar on the page but require different fixes.
Common errors and the correct check
BillingNotEnabledMapError
ApiNotActivatedMapError
The Maps JavaScript API is not enabled in the project connected to the key. Enable that API in Google Cloud Console and confirm that the page loads the key from the same project.
ApiTargetBlockedMapError
The key is blocked from using the required API. Review API restrictions and allow the Maps JavaScript API. Keep restrictions narrow enough to protect the key, but include every API the page actually calls.
RefererNotAllowedMapError
The current website address is not on the key’s allowed referrer list. Add the production hostname and any required subdomains using the exact HTTP referrer pattern.
InvalidKeyMapError or MissingKeyMapError
The page is sending an unrecognized key or no key. Check the script URL, deployment environment, copied value, and whether a theme or plugin still injects an older key.
Fix Google Maps or remove the key dependency?
Fix the existing Google setup when the site relies on Google-specific services or when the configuration error is isolated and understood. Replace it when the store locator only needs location search, directions, markers, and a map, and the team does not want to maintain a Google Cloud project and key.
A no-key setup does not mean every provider is keyless. In the locator covered here, the built-in maps, two OpenStreetMap styles, and three Apple Maps styles work without a merchant-supplied key. Google Maps and Mapbox remain optional and require the merchant’s own key.
Map options verified in the product code
- Built-in maps: five styles without a merchant API key.
- OpenStreetMap: two styles without a merchant API key.
- Apple Maps: three styles currently available without a merchant API key.
- Google Maps: four styles plus its style catalog, using the merchant’s key.
- Mapbox: six styles, using the merchant’s key.
That is ten verified styles that do not require a merchant key. The earlier claim of 23,000+ styles was not supported by the code and has been removed.
How to migrate a store locator
1. Export and clean the location list
Keep one row per location and verify the address, name, phone, opening hours, and website fields. Remove duplicates before importing.
2. Import locations
The product code supports CSV, XLS, XLSX, Numbers files, and Google Sheets as location sources. Map each source column to the matching location field and inspect failed rows.
3. Choose a map provider
Start with a no-key provider if removing API administration is the goal. Choose Google Maps or Mapbox only when their specific map experience is required and a key is configured.
4. Replace the old locator
On Shopify, add the theme block. On WordPress, use the [progus-store-locator] shortcode. Wix has a dedicated app, while other sites can use the hosted embed code.
5. Test before removing the old map
Test address search, geolocation fallback, mobile layout, directions, marker clicks, and several known locations. Keep the previous locator available until the replacement passes those checks.
For a broader setup guide, see the store locator without a Google Maps API key.
Pricing when the map does not need a merchant key
The Free plan supports one location. Paid Shopify plans are Basic at $9.99 per month for 100 locations, Standard at $19.99 for 500, and Premium at $29.99 for 2,000.
Paid plans have a 14-day trial; annual billing is 10% lower. WordPress and Wix also have a Starter plan at $3.99 per month for 10 locations.
These are application plan limits, not map-load quotas. Higher plans exist for larger location lists, so check the current platform page before choosing a plan.
Frequently asked questions
Why is my Google map blank?
Check the browser console. The cause may be billing, an API restriction, a referrer restriction, a missing key, a blocked script, or a map container with no height.
Can I use a store locator without a Google Maps API key?
Yes. Choose a provider that does not require your own key. In this product, the built-in, OpenStreetMap, and Apple Maps options provide ten verified no-key styles.
Can I keep Google Maps as an option?
Yes. Google Maps remains available, but it requires your own Google Maps API key and correctly configured billing and restrictions.
Can I import my current locations?
Yes. The verified import formats are CSV, XLS, XLSX, Numbers, and Google Sheets.
Does the same locator work outside Shopify?
Yes. The verified routes include Shopify, WordPress, Wix, and a hosted embed for other websites.
Final thoughts
Show your stores on a map without Google Maps API. About Store Locator ›