Finnish Address Autocomplete

Finnish Address Autocomplete is a free PrestaShop module for entering addresses in Finland and Åland. A chosen Digitransit address fills the street and house number, a five-digit postcode and town. Digitransit is the Fintraffic and HSL geocoder using OpenStreetMap addresses. You need your own free Digitransit account and subscription key before suggestions start. Åland (AX) forms receive Swedish suggestions, such as Torggatan 1, 22100 Mariehamn.

Quick start

1. Upload and install the module ZIP. Register free at portal-api.digitransit.fi and subscribe to the Digitransit developer API product.
2. Copy the primary key from Profile > Subscriptions. Open Configure, or the Finnish Address entry in the back office menu; in multishop select one shop you can manage.
3. Check Finland or Åland is active and available on the native address forms you use.
4. Paste your own Digitransit subscription key first. Set the overall, account, checkout and back office switches, then save. There is no country selector.
5. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
6. Merge https://api.digitransit.fi into an existing CSP and mention the browser connection and key in your privacy notice. Check current service terms and quotas.
7. Select Finland and type mannerheimintie 10 helsinki. When returned, select Mannerheimintie 10 and check 00100 Helsinki. Also select Åland (AX) and test torggatan 1 mariehamn for Swedish suggestions. Test stairwell letters, street-only completion, manual entry, guests, invoice, staff/new-order, France with French Address Autocomplete and phone width.

Features

• Finland and Åland suggestions. Digitransit address search in native account and checkout forms, including guests.
• Filled together. Returned street and house number, five-digit postcode and town.
• Returned letters retained. Keep stairwell letters such as 5 A; missing flats require manual entry.
• Back office. Address help for staff in Customers > Addresses and native address windows.
• Everyday entry. Touch, keyboard and screen-reader announcements; manual entry remains.
• Your own key. Free module, four switches and a Digitransit subscription key per shop.

Configuration options

• Digitransit subscription key: The primary key of your Digitransit developer API subscription (portal-api.digitransit.fi, Profile > Subscriptions).
• Suggest addresses while the customer types: overall switch, after the key.
• 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 Finnish Address entry in the back office menu. One Settings page contains Configuration, Integrity, License, Update and Support sections. Visible order: Digitransit subscription key, the four switches above, then Save. All four switches default on. The key accepts 32 hexadecimal characters; blank clears it and disables this service on forms. There is no country selector. In multishop, select one shop you can manage; the settings and key are saved per shop. After the form: coverage, account setup, manual entry, privacy and CSP notes, then the sibling-service note. English source and German, French, Polish, Italian, Spanish and Finnish settings strings are supplied. Swedish settings are not supplied; requests use lang=fi for Finland (FI) and lang=sv for Åland (AX), regardless of page language.

Use for these countries belongs to worldwide address modules. An empty list means every country available to the form; selected countries narrow that service. Finnish Address has fixed Finland (FI) and Åland (AX) coverage and no country selector. Åland (AX) forms receive Swedish suggestions, such as Torggatan 1, 22100 Mariehamn. The postcode determines the country for both addresses and streets: 22xxx identifies Åland. FI and AX forms receive only their own country’s results; rows without a valid postcode are skipped. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. French BAN destinations are separate from Finland and Åland. A failed search does not automatically retry another service.

Customization examples

Allow Digitransit in your Content Security Policy

The source-derived external origin is https://api.digitransit.fi in connect-src. Scripts and styles are served by the shop; no external Digitransit SDK, font or map is loaded. Merge this example into your existing policy, keeping theme rules, inline/nonces and other modules. With French Address Autocomplete, also allow https://data.geopf.fr in connect-src. The merchant portal link is for setup and is not loaded by autocomplete.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.digitransit.fi;

Retain apartment and delivery details

The selected country, second address line, name, company and telephone remain unchanged. Keep apartment, box, floor and entrance details on line two. A flat number recognized after a stairwell letter must match the returned flat; otherwise no suggestion is offered. Street-only choices clear the postcode and leave the number and postcode to complete manually. Check the full address before saving; manual entry and editing remain available.

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. Finland or Åland must be available; activate the countries you deliver to.
• Check that Finland or Åland is active and available on the native address forms you use.

Use for these countries belongs to worldwide address modules. An empty list means every country available to the form; selected countries narrow that service. Finnish Address has fixed Finland (FI) and Åland (AX) coverage and no country selector. Åland (AX) forms receive Swedish suggestions, such as Torggatan 1, 22100 Mariehamn. The postcode determines the country for both addresses and streets: 22xxx identifies Åland. FI and AX forms receive only their own country’s results; rows without a valid postcode are skipped. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. French BAN destinations are separate from Finland and Åland. A failed search does not automatically retry another service.

The filter checks recognized house, stairwell and flat tokens. A single letter just after a number can briefly be read as a stairwell while a town is being typed. A recognized flat without a returned match hides the list. Custom forms, themes, new-order routes and mixed module versions need checking.

How it works

Suggestions begin after three characters and a 300 ms pause. The browser directly GETs https://api.digitransit.fi/geocoding/v1/autocomplete with layers=address%2Cstreet, size=10, lang=fi for Finland (FI) or lang=sv for Åland (AX), text and digitransit-subscription-key. The adapter separates an attached house letter, removes standalone five-digit postcodes and collapses spaces before sending the query. It still filters rows against the original input. Up to five unique valid options are shown. Address rows take precedence over street rows. A recognized house number, stairwell letter or flat must match the offered result; partial numbers and word prefixes can narrow the list. No result is guaranteed.

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

Selected address fields

A chosen address keeps the returned street and number together, such as Mannerheimintie 10 or Hämeenkatu 5 A. The letter A is kept when present; an attached letter such as 81a also stays as returned. Postcodes keep all five digits, including the leading zeros in 00100. The town comes from the returned locality, falling back to the local administrative name. On Åland forms, Maarianhamina is written as Mariehamn. There is no postal-town capitalization change. The selected country, second address line, name, company and telephone remain unchanged. Keep apartment, box, floor and entrance details on line two. A flat number recognized after a stairwell letter must match the returned flat; otherwise no suggestion is offered. Street-only choices clear the postcode and leave the number and postcode to complete manually. Check the full address before saving; manual entry and editing remain available.

Use for these countries belongs to worldwide address modules. An empty list means every country available to the form; selected countries narrow that service. Finnish Address has fixed Finland (FI) and Åland (AX) coverage and no country selector. Åland (AX) forms receive Swedish suggestions, such as Torggatan 1, 22100 Mariehamn. The postcode determines the country for both addresses and streets: 22xxx identifies Åland. FI and AX forms receive only their own country’s results; rows without a valid postcode are skipped. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. French BAN destinations are separate from Finland and Åland. A failed search does not automatically retry another service.

Staff entering an address after a telephone enquiry get suggestions in Customers > Addresses. Choosing an address in Finland or Åland 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 © OpenStreetMap contributors, © Digitransit 2026. 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 prepared search text, layers=address,street, size=10, lang=fi for Finland (FI) or lang=sv for Åland (AX) and your subscription key as URL parameters to https://api.digitransit.fi. No separate name, email, phone, company, second-line or country parameter is added. Anything typed into the search can be transmitted. The key is visible to form visitors and the service. Credentials are disabled; the connection exposes visitor IP and may carry browser/origin/referrer information under browser policy. Selection needs no details request. Engine diagnostics omit queries, keys, URLs and responses; normal addresses save through PrestaShop. Mention this in your privacy notice. Credit: © OpenStreetMap contributors, © Digitransit YEAR, with the current server year.

Honest limits

• Coverage: Finland and Åland, the addresses of OpenStreetMap served by the Digitransit geocoder (Fintraffic and HSL): very good in towns, some rural addresses are missing. Suggestions start once the subscription key is saved. Current completeness, freshness, ranking and unlimited free use are not promised. The recorded Itäinen Rantakatu 2 result has two different postcodes; check the chosen address.
• Address rows need a five-digit postcode and town. Missing or malformed rows and duplicates are discarded. With no valid address and no recognized house number, a street-only option can fill street and town while clearing postcode. Complete the number and postcode manually. No separate apartment, box or unnamed-street coverage is established.
• A missing key prevents requests; service authorization can fail with 401/403. A 429 response pauses requests for Retry-After or ten seconds. Network, response and timeout failures leave manual entry. There is no automatic service failover.
• The filter checks recognized house, stairwell and flat tokens. A single letter just after a number can briefly be read as a stairwell while a town is being typed. A recognized flat without a returned match hides the list. Custom forms, themes, new-order routes and mixed module versions need checking.
• No map, geolocation, coordinate storage, submit-time validation, country selection or delivery guarantee. Free module with lifetime updates and no included support commitment. Service terms, quotas and browser-key use need current verification.

Troubleshooting

• No Finland or Åland results: select Finland or Åland, check its active status and the overall/form switches, then try full street + number + town. Digitransit subscription key: 32 hex; 401/403.
• 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 Digitransit, 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.