Google Maps API Key

You must have a Google Maps Javascript API key to use mapping features in the following tools and applications:

Before you start, make sure you can access the Google Cloud console: https://console.cloud.google.com/google/maps-apis/

Note: You must have a Billing Account to use API keys. There is an Always Free Tier and you won't be changed unless you upgrade. This tier is essentially a monthly credit from Google. You'll need to provide a credit card to cover any possible charges over the credit amount. Mapping data points does not incur a cost.

Need Help?

Review the Getting Started guide (devleopers.google.com) for additional help in completing the following steps. And check out the following resources from Google:

Enable the APIs

You'll need to enable all of the following APIs in the API Library of the Google Cloud console. To do so, select each one and click Enable. If you don't enable these APIs, your maps won't render.

Maps Embed API
Maps Javascript API
Maps Static API
Places API or Places API (New)
Note: If you see the option for Places API (New) in your list, select it. Otherwise, select Places API.

Create or Copy an API Key

In the API Library of the Google Cloud console, select Maps Embed API or Maps Javascript API.
Go to the Credentials page.
If an existing key is not listed, create or copy a new API Key.
Remember to restrict the API key before using it in production. For help with this, see API security best practices (developers.google.com).

Once you have an API Key, you can configure it for the Platform, tools and Life Apps, and/or Widgets.

Configure Key for Platform URL

Click the API Key on the Credentials page.
Under Application Restrictions, click HTTP Referrers (web sites).
Under Accept requests from these http referrers (web sites), enter your MinistryPlatform URL.

Your Platform URL will look like this, where "{domain-url}" is the URL for your MinistryPlatform instance: https://{domain-url}/*

Configure Key for Two Cloud URLs

Click the API Key on the Credentials page.
Under Application Restrictions, click HTTP Referrers (web sites).
Under Accept requests from these http referrers (web sites), enter your Cloud URL.
1. To find your Cloud URL, see Find your Cloud URL for Cloud Tools & Batch Manager and Find Your Cloud URL for Life Apps & Template Editor.
2. Add "/*" to the end of your URL.

Your Platform & Widgets Cloud URL will look like this: https://{churchname}.ministryplatform.cloud/*.

Your Tools & Life Apps Cloud URL will look like this: https://{churchname}.cloudapps.ministryplatform.cloud/*

Configure Key for Widgets URL

Note: Diocesan SPoCs: You must allow domains for each of your parishes for some widgets to work correctly.

Click the API Key on the Credentials page.
Under Application Restrictions, click HTTP Referrers (web sites).
Under Accept requests from these http referrers (web sites), enter your Widgets URL.
1. Your Widgets URL is the webpage (most likely on your church website) where you embedded the widgets you use.
2. Add "/*" to the end of your URL.

Add Key to the Configuration Setting

Copy your Google Maps API Key from the Google Cloud console.

In the Platform:

In the navigation menu, click Administration > Configuration Settings.
Find COMMON, GoogleMapsAPIKey.
Click Edit Record.
Paste your Google Maps API Key into the Value field.

Tip: Be sure that there are no spaces before or after your API key.
Click Save.

Add Key to Your Domain

Copy your Google Maps API Key from the Google Cloud console.

In the Platform:

In the navigation menu, click System Setup > Domains/Accounts.In the navigation menu, click System Setup > Domains/Accounts.
Open the Domain record.
Click Edit Record.
Locate Google Maps API Key, and paste the value into that field.
Click Save.