Autocomplete Google Places

Description

Google address autocomplete for WooCommerce and any form

Autocomplete Google Places adds Google address suggestions to your address fields. Customers type a few letters, pick their address from the list, and the street, city, postcode, state and country are filled in for them. Fewer typing errors, fewer failed deliveries, a faster checkout.

Where it works

• WooCommerce classic checkout: billing and shipping addresses.
• WooCommerce block checkout: the default checkout of recent WooCommerce versions.
• My Account addresses: billing and shipping address editing.
• Any other form: Contact Form 7, Gravity Forms, Elementor and custom HTML forms, targeted by field ID or CSS class.

What gets filled automatically

• Address line 1, written in each country’s format (“12 Rue de la Paix” in France, “Hauptstraße 12” in Germany).
• City, postcode, state or region, and country (matched by ISO code, so it works whatever your shop language).
• On the classic checkout, the state dropdown is updated and WooCommerce recalculates shipping right away.
• On custom forms, nearby city and postcode fields are detected and filled too.

Settings

• Google API key with a one-click Test API key button that checks both Places API (New) and Places API (Legacy) and tells you which one works with your key.
• Google Places API mode: Automatic (recommended: Places API New with fallback to Legacy), New only, or Legacy only.
• Country scope: worldwide, or restricted to up to 5 countries chosen from 37 (Europe, USA, Canada, Mexico, Japan, Australia, New Zealand…).
• Suggestion type: street addresses, addresses & areas, cities only, regions (postal codes, areas), or businesses & places.
• Custom fields: add the IDs and/or CSS classes of extra address fields (for example #my-address, .address-field). Fields added later by JavaScript (React or Vue forms, Ajax modals, multi-step forms) are detected automatically.

Built for speed

• Google Maps is loaded only when a visitor first clicks an address field, never on page load.
• On WooCommerce stores, the plugin’s small script only loads on the checkout and My Account pages.
• Deferred script, inline styles, no jQuery, no extra requests.
• Fewer billed Google requests: suggestions start after 3 characters, wait for a short pause in typing, and use Google billing sessions.
• No double loading: if your theme or another plugin already loads Google Maps, it is reused.

Modern, compliant and accessible

• Uses Google’s current Places API (New), so API keys created since March 2025 work. Older keys keep working through the automatic fallback.
• Its own suggestion list, usable with the keyboard (arrows, Enter, Escape) and screen readers. Pressing Enter in the list never submits the checkout by accident.
• Shows the “Google Maps” attribution required by Google’s terms.
• Follows your WordPress site language and region, so suggestions appear in your visitors’ language.

Privacy and security

• Nothing is sent to Google until a visitor uses an address field.
• The API key format is validated, all settings are validated again before output, and the configuration is safely encoded.
• All plugin data is removed when you delete the plugin.

Compatibility

• WordPress 5.6 or later, tested up to 7.1.
• WooCommerce 6.0 or later, tested up to 11.3. Compatible with High-Performance Order Storage (HPOS) and the Cart & Checkout blocks.
• PHP 7.4 or later.
• WooCommerce is optional: without it, the plugin works on your custom form fields.

What you need

Your own Google Maps Platform API key, from a Google Cloud project with:

• Maps JavaScript API and Places API (New) enabled;
• an active billing account linked to the project (Google requires it, even within the free monthly usage);
• the key restricted to your website (HTTP referrers), so nobody else can use it.

Quick setup

1. Install and activate the plugin.
2. Open the Google Places menu in your WordPress admin.
3. Paste your API key and click Test API key.
4. Choose your country scope and suggestion type, then save. Done.

For developers

• autocomplete_gp_load_on_page: force the script on a custom checkout page that WooCommerce does not report as checkout.
• autocomplete_gp_min_chars: change the number of characters typed before suggestions are requested (1 to 10, default 3).

Free and open source (GPLv2 or later). Also available on WordPress.org.