Summary

This article shows you how to set up the Owner's Map with Google Maps API keys. The map shows your owners by address.

Before You Begin

If you already use the Address Lookup feature, skip to step 6. If you already have a maps API key for address lookup, you do not need a new project. You can create a separate, unrestricted API key for the Owner Map. Make a new project only if you want to bill the Owner Map and Address Lookup separately.

Steps

1. Go to https://cloud.google.com/maps-platform/#get-started.
2. In the Enable Google Maps Platform box, select Maps, then select Continue.
3. Name your project.
4. Create your billing account and select Preferences.
5. Create your new project.
6. Make sure two API keys exist. To create one, go to APIs and Services » Credentials » Create Credentials » API Key.

   

7. On the API Key settings page, restrict one of your keys. If you already have a restricted key for Address Lookup, skip to the next step.
   1. Set Application Restrictions to HTTP referrers (websites).

      

   2. Under Accept requests from these HTTP referrers (websites), enter your Gingr app URL: https://businessname.gingrapp.com/*. The * at the end is required. It lets the API talk to the Gingr pages that call the Google API.
8. Make sure your second API key is unrestricted, with no application or API restrictions.
9. Turn on the Geocoding API and Maps Javascript API. Go to APIs and Services » Library, search for each one, and turn it on.
10. In Gingr, go to Left-hand Navigation: Admin » Google.
11. Enter the HTTP-referrer-restricted key in the Google Maps API Key field. Enter the unrestricted key in the Google Maps Secret API Key field. Save.

    

12. Go to Left Navigation: Owners and Pets » View Map to see your owners by address.

    

Warning: Do not put an unrestricted API key in the Google Maps API Key field.

If Something Goes Wrong

The first time you load the Owner Map page, it takes longer than you expect. This is normal. Gingr asks Google for the latitude and longitude of each owner. It does this in the background over a few days after you enter your API key, so the map can take a few days to fill in. If you have more than 5,000 owners, contact Support for help.

Related Articles

• Google Maps API Feature Overview
• Set Up Address Lookup How-To