Summary

This article shows how to create a Google Maps API key and enter it into Gingr. The key turns on Address Lookup and Owner Map.

Reference: On July 16, 2018, Google started a pay-as-you-go pricing plan for Maps, Routes, and Places. This sharply raised the cost for Gingr to include Address Lookup for free, so Gingr removed it as an included feature. Gingr added a setting where you enter your own API key. That lets you set up your own Google Maps account to connect with Gingr.

Before You Begin

• You need a Google Cloud Platform account set up and configured. Costs may apply. See Google's Platform Pricing & API Costs page.
• If you have more than one location on one app URL, you only need to do this once. The setup applies to all locations in your app.

Steps

Set Up Address Lookup

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. Go to APIs and Services » Library, search for Places API, and enable it.
7. On the API Key settings page, set Application Restrictions to HTTP referrers (websites).

   

8. Under Accept requests from these HTTP referrers (websites), enter your Gingr app URL as https://businessname.gingrapp.com/*. The * at the end is required. It lets the API work with the Gingr pages that use Address Lookup.
9. Copy your new API key.
10. In Gingr, go to Left-hand Navigation: Admin » Google.
11. Paste the API key and save.

    

Set Up Owner Map

1. Go to https://cloud.google.com/maps-platform/#get-started. If you already use Address Lookup, skip to step 6.
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 a key, go to APIs and Services » Credentials » Create Credentials » API Key.

   

   Important: If you already have a Maps API key for Address Lookup, you do not need a new project. You only need a new project if you want to bill Owner Map and Address Lookup separately. You can create a separate, unrestricted API key for Owner Map.

7. Restrict one of your API keys. If your Address Lookup key is already restricted, skip to the next step. Set Application Restrictions to HTTP referrers (websites).

   

8. Under Accept requests from these HTTP referrers (websites), enter your Gingr app URL as https://businessname.gingrapp.com/*. The * at the end is required. It lets the API work with the Gingr pages that call the Google API.
9. Make sure your second API key is unrestricted. It must have no application or API restrictions.
10. Go to APIs and Services » Library. Search for the Geocoding API and the Maps JavaScript API, and enable both.
11. In Gingr, go to Left-hand Navigation: Admin » Google.
12. Enter your API keys and save.

    Important: To fully turn on Owner Map, enter an HTTP referrer restricted API key in the Google Maps API Key field. Enter an unrestricted API key in the Google Maps Secret API Key field.

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

    

13. To see your owners on a map, go to Left Navigation: Owners and Pets » View Map.

    

Important: The first time you load the Owner Map page, it takes longer to load. 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. The map may take a few days to fully fill in, based on how many owners you have. If you have more than 5,000 owners, contact support.

Related Articles

• API Topic Outline
• What Are Gingr API Functions? Reference
• Access API Keys How-To