Jotform offers many mapping widgets for your forms. We have a map widget that can display your business location, calculate the distance between the origin and the destination, or geostamp your form submission without requiring users to enter it.
Jotform’s mapping widgets work with the default API key we have. However, we highly recommend setting up your API key to avoid interruptions.
Having a separate key for the widget is recommended because once the default API key reaches its limit, Jotform cannot notify you. If you own the key, Google will notify you if there’s an issue or your billing needs to be updated.
Here are the prerequisites before you can create the API Key:
- You must have a Google Cloud Project. For more information on creating one, visit Creating and Managing Projects.
- You must create a Google Cloud Billing Account. For more details, see Create a new Cloud Billing Account.
- You must link the Billing Account to your Project. For more information, check out How to Enable Billing on an Existing Project.
Creating and Setting up the API Key
If you’ve already set up the above prerequisites, let’s go ahead and create and set up the API Key. This is how it’s done:
- In your Google Cloud dashboard, click on the Three Lines icon at the top-left side of the page.
- Then, under the Products section, hover your mouse over the APIs & Services menu.
- Next, in the Side menu that appears, click on Credentials.
- On the Credentials page, click on Create Credentials at the top-center of the screen.
- Then, in the Dropdown menu that opens, click on API Key.
- Next, in the Create API Key menu that opens on the right side of the page, enter a unique name for the API key in the Name field.
- Now, click on the Select API Restrictions Dropdown menu to open the list of enabled API keys for the selected project.
- In the list of enabled API Keys, select all Maps API. In most mapping widgets, the Maps JavaScript and Places API are used.
- Then, click on OK to confirm your selection.
Note
Only APIs that are enabled for your project will appear in the dropdown menu. If the API you need is not listed, make sure it has been enabled before creating and configuring your API key. You can find the steps to enable an API below.
- Next, scroll down to the Application Restrictions section and select Websites.
- Now, under the Website Restrictions section, click on Add.
- In the Add Website field, enter our domains listed below, including the domain for our widgets.
- Then, click on Done.
- Now, click on Create to create the API Key.
- Finally, in the API Key Created menu, copy the generated API Key from the Your API Key box, and then click on Close at the bottom.
Jotform Domains
Jotform uses different domains for various regions, along with a separate domain for widgets. You can copy the relevant domains below.
| Region | Domain |
| Main Domain | *.jotform.com/* |
| Old Premium or Pro Accounts | *.jotformpro.com/* |
| Canada | *.jotform.ca/* |
| Asia | *.jotform.me/* |
| Africa | *.myjotform.com/* |
| South America | *.jotformz.com/* |
| Others | *.jotform.co/* |
| USA | *.jotform.us/* |
| EU | *.jotformeu.com/* |
| Jotform Widgets | *.jotform.io/* |
Notes
- You don’t need to add all Jotform domains. If you’re in the US, we recommend adding both jotform.com and jotform.us.
- If you’re in the EU region or using an account with HIPAA features enabled, there’s no need to specify the EU or HIPAA domains; they’re already included in the restriction list under jotform.com.
Enabling APIs
APIs won’t function unless they’re enabled in the list. As mentioned above, we recommend enabling all Maps APIs. Here’s what to do:
- Go to the filtered Maps API Library.
- Then, click the Maps API you want to enable. For example, the Maps Embed API.
- Now, click on Enable.
That’s it! The page will redirect you to the list of enabled APIs under your current project in your Google Cloud account.
Send Comment:
7 Comments:
August 14, 2025
Hi I need a widget that customer inputs the Post code and then a list of addresses pop down and he need to select from them
March 18, 2025
These instructions are out of date. I spent three days troubleshooting until I found the answer. I sent it up the line to Jotform so hopefully they update it soon. When you choose a Maps API on the google console, it gives you 24 maps related API's and enables them all, including "Places API" (new). That never worked for my Auto complete address widget on Jotform. You have to manually search for the old "Places API" and manually enable that one. That's the one that jot form is set to work with. It will not work with the new places API.
February 15, 2025
Is this the right link for a jotform developer to assist me in setting up a Google api?
Here is the link that shows what things I would need for the API: https://www.jotform.com/help/597-how-to-get-google-maps-api-key-for-jotform-mapping-widgets/#:~:text=Here%20are%20the,existing%20project.
I can assist with Jotform Apps!
February 11, 2025
Comment ajouter l'API au WIDGET ? Une fois que nous avons la clé API
November 27, 2024
How to add the API to the WIDGET ? once we have the API key, where does it go ? there are no instructions for that, an I cant find anywhere for it to go
November 4, 2024
This is the best set of instructions on how to do this that I've seen thus far. My only suggestion is that some of the screenshots will need to be updated. Google as updated their platform and less tech-savvy people trying to follow this may get confused.
July 30, 2024
Por essa API eu consigo preencher dados de endereço automaticamente após inserir um código postal?