Address Providers #

Address Providers are one of the provided integrations with Formie, and are used specifically for the Address field.

Address Providers have settings only at the plugin level, where you should enter API settings, in order to connect to the third-party provider. The specific provider can then be selected on individual Address fields.

For the address fields, these providers will render a single input for the user to type into. It will then suggest geocoded addresses in a structured format. If an address matches, it will populate all additional address fields with the individual parts of the address.

For instance, you might type "1 Infinite Loop", resolving to Apple's HQ. Formie will then populate the following fields with content:

  • Address 1 = 1 Infinite Loop
  • City = Cupertino
  • ZIP / Postal Code = 95014
  • State / Province = CA
  • Country = United States

It should also be mentioned that you don't even have to have all these separate fields enabled. It's up to you and your needs!

Formie provides 3 address providers.

Google Places #

Use Google Places Autocomplete to use their service to suggest addresses.

Step 1. Create the Integration #

  1. Navigate to FormieSettingsAddress Providers.
  2. Click the New Integration button.
  3. Select Google Places as the Integration Provider.

Step 2. Connect to the Google Places API #

  1. Go to the Google Cloud Platform Console.
  2. Click the Select a project button. Either create a new project, or select an existing one.
  3. Select Credentials from the left side menu, and click + Create Credentials, selecting API Key.
  4. From the left side menu, select Library.
  5. From the list of APIs enable both Places API and Maps JavaScript API.

Step 3. Field Setting #

  1. Go to the form you want to enable this integration on.
  2. Add an Address field to your form.
  3. Enable the Auto-Complete sub-field option.
  4. Select Google Places for the Auto-Complete Integration.

You can also provide Options in the table field. The value content must be JSON-compatible, so ensure you encase strings in " characters. For example, the below might restrict suggested addresses to Australia.

OptionValue
componentRestrictions{ "country": "au" }

Algolia Places #

Use Algolia Places to use their service to suggest addresses.

Step 1. Create the Integration #

  1. Navigate to FormieSettingsAddress Providers.
  2. Click the New Integration button.
  3. Select Algolia Places as the Integration Provider.

Step 2. Connect to the Algolia Places API #

  1. Login to your Algolia account.
  2. In the left-hand sidebar, click API Keys.
  3. Copy the Application ID and enter this in the App ID field in Formie.
  4. Copy the Search-Only API Key and enter this in the API Key field in Formie.

Step 3. Field Setting #

  1. Go to the form you want to enable this integration on.
  2. Add an Address field to your form.
  3. Enable the Auto-Complete sub-field option.
  4. Select Algolia Places for the Auto-Complete Integration.

You can also provide Reconfigurable Options in the table field. The value content must be JSON-compatible, so ensure you encase strings in " characters. For example, the below might restrict suggested addresses to Australia.

OptionValue
countries["AU"]

Address Finder #

Use Address Finder to use their service to suggest addresses. Address Finder is specifically for Australian and New Zealand addresses, and handles their addresses better than other options.

Step 1. Create the Integration #

  1. Navigate to FormieSettingsAddress Providers.
  2. Click the New Integration button.
  3. Select Address Finder as the Integration Provider.

Step 2. Connect to the Address Finder API #

  1. Login to your AddressFinder account.
  2. Click the account dropdown in the top-right corner of the screen, and select Settings.
  3. Under the Account section, copy the key into the API Key field in Formie.

Step 3. Field Setting #

  1. Go to the form you want to enable this integration on.
  2. Add an Address field to your form.
  3. Enable the Auto-Complete sub-field option.
  4. Select Address Finder for the Auto-Complete Integration.

You can also provide Widget Options in the table field. The value content must be JSON-compatible, so ensure you encase strings in " characters. For example, the below might return the location (street, suburb and city) results.

OptionValue
show_locationstrue

Get started with Formie

Available for Craft 3. Get it from the plugin store.