Why a Different Key for Imports?
When using the CSV import feature in Omnium Maps, you'll need a second Google Maps API key configured specifically for geocoding. This guide walks you through creating and setting up this import key.
Understanding the Difference
CSV import uses a faster Google Geocoding endpoint that performs direct API requests and does not send an HTTP referrer header. Because browser keys protected by referrer restrictions won't work for these requests, a second API key is required specifically for CSV geocoding. Restrict that key to the Geocoding API and to your server IPs (or proxy the requests through your backend) to minimize exposure.
Never use your second key publicly and do not set it as the main key for our app!
Creating Your Import API Key
Let's create a new API key specifically for CSV imports. You'll use the same Google Cloud project that contains your existing maps configuration.
Open the Google Cloud Console and navigate to APIs & Services → Credentials.
Verify you're in the correct project by checking the project name at the top of the console.
Click the "Create Credentials" button at the top of the page, then select "API key" from the dropdown menu.
Google will generate your new API key instantly and display it in a dialog box.
Click the "Edit API key" button in the dialog. At the top of the configuration page, give your key a descriptive name like "CSV Import Key" or "Private Geocoding Key".
Configuring Restrictions
Now let's configure the security restrictions for your import key. This setup is crucial for both functionality and security.
Scroll down to the "API restrictions" section and select "Restrict key".
In the dropdown list of APIs, find and select only the "Geocoding API". Make sure no other APIs are checked.
Before your import key will work, make sure the Geocoding API is enabled in your project. To verify:
- Navigate to APIs & Services → Enabled APIs & Services
- Look for "Geocoding API" in the list
- If it's not there, click "Enable APIs and Services" and enable it
Click the "Save" button at the bottom of the page.
Note: It may take 5-10 minutes for Google's servers to propagate your configuration changes. Don't worry if the key doesn't work immediately after creation.
Using Your Import Key
You've successfully created and configured a Google Maps API key specifically for CSV imports. You can use it when importing locations via CSV in the Omnium Maps app. Simply paste this key into the import page when prompted.
