Gatemi Address Autocomplete FAQ and Troubleshooting

The search box does not appear

Work through these in order:

  1. Is a key saved and the switch on? With no key, or with Use address autocomplete off, nothing is loaded at all.
  2. Is at least one address switched on? With both On the billing address and On the shipping address off, nothing loads.
  3. Are you on the checkout, or My Account → Addresses while editing an address? Those are the only pages the plugin loads on — not the rest of My Account, which has no address on it.
  4. Does Google accept the key? Open the browser's developer console on the checkout. Google prints its own errors there — for example RefererNotAllowedMapError (the referrer restriction does not include this domain), ApiNotActivatedMapError (the Maps JavaScript API is not enabled) or a billing error (the project has no billing account).
  5. Is the Places API enabled? The new autocomplete element needs it, as well as the Maps JavaScript API.
  6. Is an ad or privacy blocker active? Some block maps.googleapis.com. Try a private window without extensions.

In every one of these cases the ordinary address fields keep working, so no order is lost while you fix it.

Does it work on the Checkout block?

Yes. On the classic checkout (the [woocommerce_checkout] shortcode) and the My Account address editor, the search box attaches to WooCommerce's own address-line field. The Checkout block draws its own address fields after the page has loaded, so the plugin watches for them and attaches when they appear. A picked address goes into the block through WooCommerce's own checkout data store (wc/store/cart), in one call with the country and the state together — the same way the block itself changes an address — so the block's shipping and totals update as usual.

Does it work with page caching?

Yes. The checkout and My Account pages are not cached by WooCommerce-aware cache plugins, and the plugin stores nothing per visitor. The key and the settings are printed into the page as data for the script.

Who pays Google, and how do I keep the bill down?

You do, on your own Google Cloud account, for what shoppers type. Two settings reduce it:

  • switch off the address you do not need (most shops need only billing), and
  • restrict suggestions to the countries you ship to.

The plugin also loads nothing on pages without an address form.

Why is my key shown in plain text?

Because it is not secret. Google's loader sends the key to every shopper's browser. Protect it with an HTTP-referrer restriction to your domain and an API restriction to the Maps JavaScript API and Places API.

Can I restrict suggestions to more than five countries?

No. Google accepts at most five region codes and refuses the whole request if given more. The plugin keeps the first five when you save. Leave the box empty to allow every country.

The state or county is not filled in

The state is written after the country, from Google's administrative_area_level_1 short name. If that short name is not one of WooCommerce's codes for the country, or the country has no state field in WooCommerce, the state stays as it was and the shopper picks it. Full edition: you can change how that field is built with the gmaa_field_map filter.

The town shows a district instead of the town

For UK addresses the plugin prefers Google's postal_town and uses locality only when there is no post town. Other countries use locality.

Does it work with HPOS?

Yes. The plugin stores nothing on orders. Both editions declare compatibility with HPOS and the Cart and Checkout blocks.

Can my customers still type an address by hand?

Always. The ordinary fields stay visible and editable under the search box.

I am moving from the free edition to the full edition

Install and activate the full edition. It reads the same gmaa_settings option, so your key, switches and countries are already there. The free edition stands down while the full edition is active; deactivate and delete it afterwards.

What happens when I uninstall?

  • Full edition: deleting it removes gmaa_settings, gmaa_license, the cached update data and the licence-check cron event.
  • Free edition: deleting it removes gmaa_settings — unless the full edition has been licensed on the site (gmaa_license exists), in which case it leaves the settings for the full edition.

The plugin stores nothing else: no tables, no order or customer data.

Does the plugin send data anywhere?

Only to Google, from your shoppers' browsers: what they type in the search box, with your key. The plugin itself contacts nothing — except the full edition, which contacts gatemi.com for licence checks and updates once a licence key is entered.

Shopping Cart
Scroll to Top