=== Address Autocomplete by GeoScale ===
Contributors: geoscale
Tags: woocommerce, address autocomplete, address validation, checkout, postcode
Requires at least: 6.7
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Reduce address errors with WooCommerce address autocomplete for Western Europe.

== Description ==

GeoScale adds address autocomplete to WooCommerce checkout, helping customers enter addresses faster and reducing
address errors.

As a customer types a billing or shipping address, GeoScale provides matching suggestions. Selecting a suggestion
automatically fills the relevant WooCommerce address fields.

GeoScale currently supports:

* Netherlands
* Belgium
* Luxembourg
* Germany
* Austria
* Switzerland
* France

The plugin works with both the WooCommerce Checkout Block and classic shortcode checkout.

A GeoScale account with an active subscription and API key is required. The plugin is open source, while the GeoScale
Address API is a separate usage-based paid service.

For pricing and more information, visit [GeoScale](https://www.geoscale.io/).

== Installation ==

Before installing the plugin, you need a GeoScale account with an active subscription and API key.

To get an API key:

1. [Sign up for GeoScale](https://dash.geoscale.io/auth/sign-up) if you haven't already.
2. Go to [Billing](https://dash.geoscale.io/billing) and choose **Add subscription**.
3. Go to [API keys](https://dash.geoscale.io/api-keys) and click **Create API key**.

To install and configure the plugin:

1. In WordPress, go to **Plugins > Add Plugin**.
2. Search for **Address Autocomplete by GeoScale**.
3. Click **Install Now**, then **Activate**.
4. Go to **WooCommerce > Settings > General**.
5. Find **Address autocomplete** and enable **Predictive address search**.
6. Enter your API key in the **GeoScale API key** field directly below it.
7. Save your changes.

GeoScale is now ready to provide address suggestions during checkout for supported countries.

== Frequently Asked Questions ==

= Which countries are supported? =

GeoScale supports address autocomplete for the Netherlands, Belgium, Luxembourg, Germany, Austria, Switzerland, and
France.

= Do I need a GeoScale account? =

Yes. A GeoScale account with an active subscription and API key is required to use the address autocomplete service.

= Does it work with both WooCommerce checkout types? =

Yes. GeoScale supports both the WooCommerce Checkout Block and classic shortcode checkout.

= What happens if the GeoScale service is unavailable? =

Customers can continue entering their address manually if address autocomplete is unavailable.

== External Services ==

This plugin connects to the GeoScale Address API at `api.geoscale.io` to provide address autocomplete.

When a customer uses address autocomplete during WooCommerce checkout, the plugin sends the following information to
GeoScale:

* Address search text entered by the customer
* Selected checkout country
* Customer's browser language
* GeoScale address identifier when a suggestion is selected

The store's GeoScale API key is sent with API requests for authentication. The API key is transmitted server-to-server
and is not exposed to the customer's browser.

This information is sent only when address autocomplete is used and is necessary to provide address suggestions and
retrieve selected addresses.

GeoScale: https://www.geoscale.io/

Terms of Service: https://www.geoscale.io/en/legal/terms

Privacy Policy: https://www.geoscale.io/en/legal/privacy

== Source Code ==

Human-readable source code for the compiled JavaScript in `public/js/index.js` is included in `src/index.js`.

The JavaScript can be built using the configuration in `package.json`:

`npm install`

`npm run build`

== Changelog ==

= 1.0.0 =

* Initial release.
