BookmarkBookmark this page!
Jul 29, 2025

Google Maps API Key Setup for the Unified Storefront

 

ℹ️Google Maps API Key usage DOES have a cost associated with it. Google will charge you according to your usage. Please thoroughly read all documentation provided by Google regarding pricing policies and structure.

 

The article explains how to obtain and configure a dedicated Google Maps API key—enabling the Maps JavaScript, Places, and Geocoding APIs—so it works securely with the Elite Unified Storefront. It also highlights Google’s usage-based costs and recommends applying HTTP-referrer restrictions (e.g., *.pormanage.com/*) before saving the key in the Storefront Setup.
      

Topics included in this article

 

Setting up Google Maps API Key

You will first need to register for a Google Developer account on developer.google.com. Once you have an account, you will need to navigate to the Maps Platform product.

 

If this is your first time using Google's Maps APIs, you may have to click the "Get Started" button.

 

You will need to choose APIs and enable at a minimum the Maps JavaScript API, the Places API, and the Geocoding API.

 

At some point in this process, you will be prompted to activate or confirm your account if you have not previously done so. Once you have confirmed your account and provided a credit card, return to the cloud console for the Maps product.

You will then need to go to the credentials tab and select credentials.

 

Record the API Key and then choose Edit API Key to apply restrictions if desired.

 

We recommend editing and using Application Restrictions of type HTTP referrers and setting that to .pormanage.com/ (or for other geographic regions, your regional Storefront Setup URL).

We recommend that you create a key specifically for the Unified Storefront application and not use it in any other integrations.

 

Once complete, you can enter your Google Map API Key in the Storefront Setup to access all the enhanced features Google provides.
      

Troubleshooting Google Maps "RefererNotAllowedMapError" in Unified Storefront

       
If you're seeing a Google Maps error on your Store Locator page (e.g., RefererNotAllowedMapError), it likely means your Google Maps API key is restricted to specific site URLs (HTTP referrers), and the page you’re using isn’t included in that allowed list.
      

How to Fix It

  1. Go to Google Cloud Console > APIs & Services > Credentials.

  2. Select the API key used on your Unified Storefront.

  3. Under "Application restrictions," select "HTTP referrers (web sites)".

  4. Under "Website restrictions," add a wildcard entry for your storefront URL. For example:
    https://abcrental.rentalesign.com
    (You can tighten this if needed to a specific path.)

  5. Click Save.

  6. Wait a minute, then hard-refresh the page or open it in an incognito window to test.
        

Things to Double-Check

  • Make sure you're editing the same API key that the storefront is actually using.

  • Include the correct protocol (https://) and use wildcards — Google won’t match without them.

  • Verify that the "Maps JavaScript API" is enabled for your Google Cloud project.

  • Confirm that billing is active on your Google Cloud account.

If the map is loaded inside an iframe from another domain, that iframe’s URL must also be added to the allowed referrer list.

 

Related Articles