In order to detect the latitude and longitude of an address, an geocoding API key is required. Multi-Terr supports the following geocoding providers Geoapify, Google and Here maps.
The application comes with a default API key but since the number of calls is limited and shared among all congregations using the application, we recommend that each congregation obtains their own API keys.
🔧 Setup Instructions
- Obtain an API Key
Follow the instructions under one of the three options listed below to generate your API key. - Copy the Key
Once your API key is created, copy it to your clipboard. - Access the API Menu
Navigate to the Admin tab and open the API Keys section to enter your key. - Enter the API Key
Insert the copied key into the designated input field using either right-click > Paste or the keyboard shortcut Ctrl + V. And click on the Save button.
Geoapify API key (recommended)
Geoapify API keys are highly recommended since they offer a generous free daily usage limit and don’t require a credit card to get started.
🛠️ Step-by-Step Guide to Getting a Geoapify API Key
- Create a Geoapify Account
- Head to the Geoapify website and sign up for a free account. No credit card is required.
- Getting Started with Geoapify: Part 1 - Create an account created by Geoapify walks you through the sign-up process and email verification.
- Head to the Geoapify website and sign up for a free account. No credit card is required.
- Set Up a Project
- Once logged in, go to the “My Projects” section.
- Click “Create a project” and give it a name (for example: MT_MY_CONGREGATION).
- Copy your API key
- Click on the Copy icon in the API Keys section
Google API key
Google API requires a credit card for activation; however, you can configure a daily usage cap to prevent unexpected charges—once the limit is reached, you'll receive an error instead of incurring fees. Additionally, we recommend restricting the API key to be used exclusively on https://multi-terr.com, which helps safeguard it from unauthorized use on other domains. Please note that Multi-Terr is not liable for any fees resulting from API usage.
🗺️ How to Get a Google Geocoding API Key
1. Create a Google Cloud Project
- Go to the Google Cloud Console.
- Click "Select a project" → "New Project" → give it a name and click "Create".
2. Enable Billing
- Navigate to Billing in the sidebar.
- Link a billing account to your project (required for API usage, even if within free tier).
3. Enable the Geocoding API
- Go to APIs & Services > Library.
- Search for Geocoding API and click Enable.
4. Create an API Key
- Go to APIs & Services > Credentials.
- Click "Create Credentials" → choose API Key.
- A key will be generated—copy it somewhere safe.
🔒 How to Restrict API Key to One Website
1. Set Application Restrictions
- In the Credentials section, click on your API key.
- Under Application restrictions, choose HTTP referrers (web sites).
- Add your domain like: https://multi-terr.com
2. Set API Restrictions
- Scroll down to API restrictions.
- Select Restrict key.
- Choose only Geocoding API from the list.
3. Save Changes
- Click Save to apply restrictions.
📊 Set Daily Quota Limit for Geocoding API
1. Open the Google Cloud Console
- Go to Google Cloud Console.
- Select your project from the top navigation bar.
2. Navigate to Quotas
- In the left sidebar, go to IAM & Admin > Quotas.
3. Filter for Geocoding API
- Use the filter bar to search for Geocoding API.
- Look for the quota labeled Requests per day.
4. Edit the Quota
- Check the box next to Requests per day.
- Click Edit Quotas at the top of the page.
- Fill out the form with your desired limit (e.g., 300).
- Submit the request.
Here API key (not recommended)
HERE Maps requires a credit card and does not offer the ability to set a daily usage limit, which poses a risk of incurring substantial charges. For this reason, we do not recommend this option unless it is configured by someone with expertise in the HERE Maps API and the congregation is prepared to assume full responsibility for any associated costs. Please note that Multi-Terr is not liable for any fees resulting from API usage.
🛠️ Step-by-Step: Set Up HERE Geocoding API
1. Create a HERE Developer Account
- Go to the HERE Developer Portal and sign up or log in.
2. Create a Project
- Once logged in, navigate to your dashboard.
- Click “Create a Project” and give it a name (e.g., “GeocodingApp”).
3. Generate an API Key
- Inside your project, go to “REST” credentials.
- Click “Create API Key”.
- Copy the key—you’ll use it in your API requests.
Notes
- IMPORTANT: Multi-Terr is not liable for any fees resulting from API usage.
Related articles
🕘 Last Updated: 2025-08-28