In order to utilize the Google Maps mapping and routing functionality within the Prima back, currently at company and manifest level, it is vital that you register a Google Maps API key. 

Note: Recently Google have introduced some new features and I’m sure will continue to improve and update their API features in the future. Also, Prima will continue to introduce new features, for example showing all your customer addresses by Van Route on the location map, or adding estimated drop off times or re-routing for traffic (which is also available on mobile devices too) within the manifest map. The Google APP’s have been free up to $200pcm for a while and we believe this will continue for the medium term, however, Prima customer current usage per site is still on average a long way below the threshold at which charges will be incurred.

 

You will see from the current charges literally many thousand of mappings and routings would have to be performed to go over this ‘customer’ limit. Because Prima dealers are required to use their own API keys, this in turn will allow lots of exciting new features to be added both to the Prima APP and potentially dealer’s carts and for new features on their stores in general.

 

 


 

 

 

  1. Login to your Google account from https://console.cloud.google.com/.
    1. if you do not have a Google account, register for one via https://accounts.google.com/signup.
    2. You will also require a billing account to be attached to the Google account - this can be setup via https://console.cloud.google.com/project/_/billing/enable.
  2. Click into APIs & Services ► Library via the menu on the left of the page.
    1. If you do not have an existing project, please create one.
  3. Under Maps, click View All.
  4. Select Maps JavaScript API.
  5. Click Enable.
  6. Click the back arrow.
  7. Select Geocoding API.
  8. Click Enable.
  9. You need to repeat steps 6,7,8 to enable the Directions API and Distance Matrix API too
  10. Click into APIs & Services ► Credentials using the menu on the left of the page.
  11. Click Create Credentials ► API key.
  12. Click Restrict Key.
  13. Under API Restrictions, select Restrict key.
  14. In the drop-down list, select Maps JavaScript API and Geocoding API.
  15. Click Save.
  16. Copy the API key to your clipboard by clicking the copy button.
  17. Launch Prima and login to the Administration application.
  18. Navigate to System Keys ► Manifest ► Google Map API key.
  19. Paste the API key from your clipboard into the field.
  20. Click Save and Close.

 

To verify that the API key is functional: navigate to a company location with valid coordinates (longitude/latitude) set, click into the Map tab and ensure that the Google Map is loaded correctly.