Google Maps API (Address Look-Up and Owner Map)

Kathryn H.
Kathryn H.
  • Updated

Overview: What are we talking about?

This article will guide you through how to create and access your Google Maps API key and enter it into Gingr to enable features like Address Look-Up and Owner Map.

Note: On July 16, 2018, Google implemented a new pay-as-you-go pricing plan that went into effect for Maps, Routes, and Places. This caused a sharp increase in cost for Gingr to include this offer for free. Because of this, we have removed the address look-up feature in Gingr as an included feature. 

However, we've created a setting for an API entry so that you can set-up your own Google Maps account that connects with Gingr for Address Look-Up. This article will show you how to access that API key from Google and enter that API key into Gingr. 

 

This article includes:

 

 

Video Tutorial: A helpful tour.

 8FkpCYrL3j.gif

 

Helpful Hints: Before you get started.

You will need to set up and configure a Google Cloud Platform account to enable these features. Costs may apply. Please carefully understand these costs and your options by visiting Google's pricing page by clicking here.

If you have multiple locations in one app URL, you only need to implement these instructions one time. The setup will apply to all locations in your application.
 

Set it Up: Address Lookup.

  1. Navigate to: https://cloud.google.com/maps-platform/#get-started

  2. A box 'Enable Google Maps Platform' will populate and you will select 'Maps' > continue.

  3. Name your Project.

  4. Create your Billing Account and select Preferences.

  5. Create your New Project.

  6. Ensure that the Places API is enabled. To do this, navigate to APIs and Services » Library and search for Places API. Enable this API.

  7. On the API Key settings page you'll adjust these settings:

    • A.)  Application Restrictions: HTTP referrers (websites)

      • Accept requests from these HTTP referrers (websites): 
        Screen_Shot_2019-01-31_at_11.59.32_AM.png

    • B.) Insert your Gingr app URL: "https://businessname.gingrapp.com/*"

      • Note that there is an * at the end of the URL. This is required to allow the API to communicate with the various pages in Gingr that may use Address Look-Up

  8. Once your HTTP Referrers are properly set, copy your newly configured API Key

  9. Navigate to your Gingr app Left-hand Navigation: Admin » Google and Enter your copy/pasted API key, and save.

    Screen_Shot_2018-10-24_at_1.35.44_PM.png

 

Set it Up: Owner Map. 

  1. Navigate to: https://cloud.google.com/maps-platform/#get-started 

    Note: 
    If you are already using the Address Lookup feature, you can skip to step 6.

  2. A box 'Enable Google Maps Platform' will populate and you will select 'Maps' > continue.

  3. Name your Project.

  4. Create your Billing Account and select Preferences.

  5. Create your New Project.

  6. Ensure that two API keys exist. You can create a new API key by going to API's and Services » Credentials » Create Credentials » API Key
    Screen_Shot_2019-01-31_at_11.48.07_AM.png

    Important! 
    If you already have a maps API key for address lookup, you DO NOT need to create a new project (unless you want to bill the owner map and address lookup separately). You can instead create a separate, unrestricted API key for the Owner Map. 

  7. On the API Key settings page you'll adjust these settings to restrict one of your API keys: (Note: if you already have a restricted API key set up for the Address Lookup feature, you can move to the next step)
    1. Application Restrictions: HTTP referrers (websites)

      • Accept requests from these HTTP referrers (websites): 
        Screen_Shot_2019-01-31_at_11.59.32_AM.png

    2. Insert your Gingr app URL: "https://businessname.gingrapp.com/*"
      1. Note that there is an * at the end of the URL. This is required to allow the API to communicate with the various pages in Gingr that may call the Google API

  8. Ensure that your second API key is unrestricted (no application or API restrictions). 
  9. Ensure that the Geocoding API and Maps Javascript API are enabled. To do this, navigate to APIs and Services » Library and search for each of these APIs. Enable these APIs.

  10. Navigate to your Gingr app Left-hand Navigation: Admin » Google Enter your copy/pasted API key and save.

    Important! To fully enable the owner map feature, you must have an HTTP referrer restricted API key entered into the Google Maps API Key field in Gingr and an unrestricted API key entered into the Google Maps Secret API Key field in Gingr.


    Do not put an unrestricted API key into the Google Maps API Key field.


    Screen_Shot_2020-03-12_at_7.06.19_PM.png

  11. You're all set! You can now view your owners by address on a map by going to Left Navigation: Owners and Pets » View Map

    Important!
     
    The first time that you load the Owner Map page, you'll notice that the page takes a bit longer to load than you might expect! This is normal and occurs only on the first time that you access this page. The system has to go through all the owners and ask Google for the latitude/longitude for each owner in your system. Gingr will do this on the backend for you over a period of a few days once you enter your API key. Depending on how many owners your app has, this process can take a few days for the map to fully populate! If you have a considerable amount of owners in your Gingr database (+5k), reach out to support for assistance! 




    Screen_Shot_2019-01-31_at_2.53.51_PM.png

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.