Estonian Address Autocomplete

Estonian Address Autocomplete is a free PrestaShop module for entering addresses in Estonia. A chosen result fills the street with returned house, flat or building numbers, a five-digit postcode and town. Maa- ja Ruumiamet supplies national ADS address data through In-AKS without an account, key or cost per lookup.

Quick start

1. Upload and install the module ZIP in PrestaShop. No In-AKS account, key or payment setup is needed.
2. Open Configure, or the Estonian Address entry in the back office menu; in multishop select one shop you can manage.
3. Check that Estonia is active and available on the native address forms you use.
4. Choose the overall, account, checkout and back office switches, in that order, and save. There is no country selector here.
5. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
6. Merge the In-AKS origin into an existing CSP and mention the browser connection in your privacy notice.
7. Select Estonia and type narva mnt 5 tallinn. Pick Narva mnt 5 and check 10117 Tallinn when returned. Also test a flat such as Narva mnt 5-10, a named farm, street-only completion, manual entry, guests, invoices, staff/new orders, France with French Address Autocomplete and phone width.

Features

• Estonian address suggestions. Official In-AKS ADS data in native account and checkout forms, including guests.
• Filled together. Street or farm name, returned house/flat numbers, NNNNN postcode and town.
• Fixed Estonia coverage. National ADS data, flats and named farms; street-only results need completion.
• Back office. The same postal address help for staff in Customers > Addresses.
• Everyday entry. Phone taps, keyboard navigation and screen-reader announcements; manual entry remains.
• No service account. A free module using free national data, with four separate switches and no key.

Configuration options

• Suggest addresses while the customer types: overall switch, first in the form.
• On the address form in the customer account: native account addresses.
• On the checkout address forms (guests and separate invoice addresses included): native checkout.
• On the address form in the back office (customer addresses, new orders): native Customers > Addresses.

Open Configure in Module Manager, or the Estonian Address entry in the back office menu. This release has one Settings page with Configuration, Integrity, License, Update and Support sections. The four switches above appear in that order, followed by Save. All default to on. There is no provider key, account or country field. In multishop select one authorized shop; settings are stored for that shop. After the form the notes cover coverage/free service, manual entry, privacy and CSP, followed by the shared sibling-service note. English, German, French, Polish, Italian, Spanish and Estonian settings strings are supplied; this does not promise address data in seven languages.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. In-AKS remains fixed to EE. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Estonian Address for Estonia. No failed search automatically retries another service.

Customization examples

Allow In-AKS in your Content Security Policy

The source-derived external origin is https://aks.geoportaal.ee in connect-src. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. No external In-AKS SDK or stylesheet is loaded. Merge this example with your existing policy, keeping theme rules, inline/nonces and other modules. With French Address Autocomplete also allow https://data.geopf.fr in connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://aks.geoportaal.ee;

Retain apartment and delivery details

The selected country, second address line, name, company and telephone remain unchanged. A returned flat number stays in line one; keep extra floor or entrance details on line two. Check street or property name, all numbers, postcode and town before saving. Customers can edit the result or enter an address manually. A street-only choice clears the postcode and leaves the house number and postcode to complete.

Installation

Requirements

• General PrestaShop range: PS 1.6 – 9.x. Exact declared floor: PrestaShop 1.6.1.0, PHP 7.1 or later.
• Native address fields and Bootstrap 3, 4 or 5 presentation. Estonia must be available; activate it if you deliver there.
• Check that Estonia is active and available on the native address forms you use.

Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. Estonian Address works alone.

Installation does not certify service availability or every platform/theme combination. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.

How it works

Suggestions begin after three characters and a 300 ms pause. The browser sends a direct GET to Maa- ja Ruumiamet In-AKS with results=10 and the trimmed typed query in address. Up to five unique valid suggestions are shown. Partial town text is passed to the service without local expansion or parallel searches; results and ranking depend on the service.

While the service is slow, the plain line “Searching addresses…” appears after 600 ms. After ten seconds the request gives up; customers can continue entering the address manually.

Selected address fields

The adapter takes address1 from aadresstekst and the unspaced five-digit postcode from sihtnumber. The town uses asustusyksus and omavalitsus: districts ending in linnaosa use their municipality, towns lose the suffix linn, and other settlements keep both parts. Missing parts fall back to the available one. No town means no result. Flat and building suffixes already in the address line are retained; kort_nr is not appended separately. Named farms are accepted without a number. Non-street rows require a postcode; liik 2 streets require none. Address rows take priority; streets appear only without typed digits and clear the postcode when chosen. Typed numbers must be accounted for, and a joined flat number must prefix the returned house token. These filters are not address validation. The options show street/property and numbers, then postcode + town. No state is supplied. Selection uses the returned address without another retrieval call.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. In-AKS remains fixed to EE. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Estonian Address for Estonia. No failed search automatically retries another service.

Staff entering an address after a telephone enquiry get suggestions in Customers > Addresses. Choosing an Estonian address fills the same native street, postcode and town fields. The back office switch is independent of the account and checkout switches.

The code also targets native new-order address windows served by the customer address page. Custom routes and third-party forms need checking. The shared engine supports address forms marked by a host such as Checkout Revolution. The host and this module share the same per-shop service settings.

On a phone, tap a result beneath the street field. With a keyboard, use the arrows and Enter to select; Escape or Tab dismisses the list. Screen readers receive result announcements. The shared dropdown uses the theme’s Bootstrap presentation.

The list shows the credit © Maa- ja Ruumiamet. No match leaves the list closed, and service failure announces that suggestions are unavailable. Customers keep manual entry and editing. Saving an address never requires a suggestion, and the module does not validate delivery addresses on submission.

Privacy and data credit

The browser sends the trimmed street-search text in address, with results=10, directly to In-AKS at https://aks.geoportaal.ee. It adds no key, selected-country, language, name, email, phone, company or second-line parameter. Anything typed into the search is sent. The direct connection exposes the visitor’s IP and may carry browser/origin/referrer information under browser policy. Credentials are disabled. Requests give up after ten seconds; manual entry remains. No search history or shop proxy is implemented; diagnostics omit queries and returned addresses. Normal saving stays with PrestaShop. Mention the transfer in your privacy notice. Visible credit: © Maa- ja Ruumiamet.

Honest limits

• Coverage and availability depend on In-AKS; neither every address nor continuous service is guaranteed. No exhaustive postcode directory or unlimited-use promise.
• Address rows need address text, a town and a five-digit postcode; a named farm needs no house number. Malformed rows are discarded. Street-only results can appear when no address survives and no digit is typed; choosing one clears the postcode. Complete the house number and postcode manually. Number filters narrow results but do not validate the address. Inspect every field before saving.
• 429 responses pause requests according to Retry-After or ten seconds. Failures leave manual entry. No automatic service failover.
• Custom forms/themes and differently routed new-order windows need checking. Custom checkout forms need integration with the shared engine.
• No map, geolocation, coordinate storage, submit-time validation, automatic country selection or delivery guarantee. Free module with lifetime updates, no included support commitment.

Troubleshooting

• No Estonian results: select Estonia, check its active status and the overall/form switches, then try full street + number + town.
• Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
• Street-only or no result: complete the house number, postcode and post town manually, and check the address before saving.
• Unavailable suggestions: inspect browser network/CSP for In-AKS, wait after a rate limit and continue manual entry.
• Custom form or layout issue: test a native address form, phone/keyboard use and the new-order route; check the shared per-shop service settings.