Other articles in this category
Search More Content
Setting Up Your Google Maps API Key
Since June 2018, Google has required the use of an API key to use Google Maps features. The Events Calendar comes with a Google Maps API key built into it, but we strongly recommend adding your own API key, to unlock additional features.
How to Add Your Own API Key
- Head to Google’s API Key documentation and click the “Get Started” button underneath the “Get an API key” header.
- Prompts will guide you through the creation of a “project” within Google—complete this process until you end up with a Google Maps API key.
- Head to Events → Settings → APIs in the Admin of your BBWP site. Copy the API Key created in step #2 and paste it into the Google Maps API Key setting field.
- Click “Save Changes”…and that’s it!
Why You Should Add Your Own API Key
If you don’t use your own API key, then some Events Calendar features look different and have less functionality than they would prior to these June 2018 changes.
Here’s a breakdown of the differences in functionality and appearance of maps-related features based on what kind of API key you’re using:
|Feature||With Built-in API Key||With Your Own API Key (Recommended)|
|Venue map on single events||✅ Fully functional||✅ Fully functional|
|Venue map on single venues||✅ Fully functional||✅ Fully functional|
|Map View||🔶 Limited functionality—only one venue will be visible on the map||✅ Fully functional|
|Searching by location in the Tribe Bar||⛔️ Not functional||✅ Fully functional|
|Custom Map Pins||⛔️ Not functional||✅ Fully functional|
Securing and Restricting Your API Key
There’s often a limit on the number of API requests your API key is authorized to make per day. If you have a particularly high-traffic site, it’s recommended that you take some steps to restrict your API keys’ functionality a bit, and limit their use to only specifically white-listed domain names.
Google provides a number of options to help secure your API key and prevent unauthorized usage, which we highly recommend if you think restricting your API key is a necessary step.
Troubleshooting Maps Issues After Adding an API Key
Have you added your own API key but still experience some issues with map-related features? If so, it’s worth confirming each of the following things:
- First, confirm that you’ve actually entered your full, un-edited API key into the correct settings field in the Admin of your BBWP site.
- If neither is enabled, make a new API key and ensure that the new API key has both APIs enabled for it. If issues persist, contact Google’s support team by clicking the Support tab in the left-hand sidebar—they should be able to help ensure that both of these free APIs are enabled for your API key.
- Finally, confirm that your venues have valid longitude and latitude data. If you created venues before adding your own custom Google Maps API key, you will need to add your custom API key and then use the “Fix venue data” button (see screenshot) in The Events Calendar’s settings to update the data and make it accurate.