Google Address Autocomplete

Google Address Autocomplete adds real-time address suggestions to your funnel's address fields. As visitors type, they see address predictions powered by Google, and selecting one automatically fills in all address components (street, city, state, zip code, country). This reduces form abandonment, eliminates typos, and ensures you receive clean, standardized address data.

Setup Overview

Google Address Autocomplete requires configuration at three levels:

1. Account level: Provide your Google API key.
2. Funnel level: Enable autocomplete for specific funnels.
3. Field level: Configure address type and component mapping on each address field.

Step 1: Connect Your Google API Key

1. Go to Settings in your dashboard.
2. Click the Integrations tab.
3. Find Google Places and click Configure.
4. Enter your Google API key.
5. Click Validate and Connect.

Your API key must have the "Places API" enabled in Google Cloud Console. Google charges per request, so make sure you have billing set up on your Google Cloud account.

Your API key is encrypted before it is stored and never exposed in client-side code. All requests go through LeadCapture's secure proxy.

Step 2: Enable on Your Funnel

1. Open your funnel in the builder.
2. Go to the Settings tab.
3. Toggle Enable Google Address Autocomplete on.
4. Optionally set a Location Radius to bias suggestions toward the visitor's area (default: 30 miles). Options: 10, 20, 30, 50, 100 miles, or None.

The location radius uses the visitor's approximate location (based on their IP address) to prioritize nearby addresses in the suggestions. No browser permission prompt is shown.

Step 3: Configure Address Fields

1. Select an address field in your funnel.
2. In the field properties, find the Google Address Autocomplete section.
3. Enable the autocomplete toggle.
4. Choose the Address Type:
   • Residential Only: Show only street addresses.
   • Business Only: Show only business establishments.
   • Both (default): Show all types of addresses.

When you enable autocomplete on a field, component fields are automatically created for street, city, state, postal code, country, and business name. These are hidden fields that get populated when the visitor selects an address.

Address Component Fields

When a visitor selects an address from the suggestions, these hidden fields are automatically populated:

You can customize the webhook field name for each component in the field properties. These names are what your CRM or webhook endpoint receives.

How It Looks to Visitors

1. The visitor starts typing in the address field.
2. After a few characters, a dropdown appears with address suggestions.
3. The visitor can select an address using the mouse or keyboard (arrow keys + Enter).
4. The full formatted address fills the main field, and all components (street, city, state, zip, country) are captured behind the scenes.
5. A "Powered by Google" badge appears below the suggestions (required by Google's terms of service).

Webhook Payload

When a lead submits the form, the address data appears as separate fields in your webhook payload:

{
  "address": "642 Baltimore Pike, Springfield, PA 19064, USA",
  "address_street": "642 Baltimore Pike",
  "address_city": "Springfield",
  "address_state": "PA",
  "address_postal_code": "19064",
  "address_country": "US"
}

Graceful Degradation

If there is an issue with the Google API (invalid key, quota exceeded, network error), the address field works as a normal text input. The visitor can still type their address manually. No errors are shown and the form continues to function normally.

Pro Tips

• Use the "Residential Only" setting for insurance and mortgage funnels to avoid business addresses in results.
• The location radius helps when your leads are in a specific geographic area. Set it to "None" for national campaigns.
• Google bills autocomplete sessions, not individual keystrokes. A session covers all the typing and the final place details lookup.
• Address autocomplete works in both hosted funnel pages and embedded funnels on external websites.
• All component field names are customizable, so you can match exactly what your CRM expects.