Finnish Address Autocomplete: Einrichtung und Hilfe

• Vorschläge für Finnland und Åland. Digitransit-Adresssuche in nativen Konto- und Checkout-Formularen, auch für Gäste.
• Gemeinsam ergänzt. Straße mit Hausnummer, fünfstellige PLZ und Ort aus dem Treffer.
• Buchstaben erhalten. Treppenhausbuchstaben wie 5 A bleiben; fehlende Wohnungen ergänzen Sie manuell.
• Backoffice. Hilfe unter Kunden > Adressen und in nativen Adressfenstern.
• Alltagstaugliche Eingabe. Touch, Tastatur und Screenreader; manuelle Eingabe bleibt.
• Eigener Schlüssel. Kostenloses Modul, vier Schalter und ein Digitransit-Schlüssel pro Shop.

• Digitransit-Abonnementschlüssel: Der Primärschlüssel Ihres Abonnements Digitransit developer API (portal-api.digitransit.fi, Profile > Subscriptions).
• Adressen vorschlagen, während der Kunde tippt: Hauptschalter, nach dem Schlüssel.
• Im Adressformular des Kundenkontos: native Kundenadressen.
• In den Adressformularen des Bestellvorgangs (auch für Gäste und separate Rechnungsadressen): einschließlich Gästen und separaten Rechnungsadressen.
• Im Adressformular des Back-Office (Kundenadressen, neue Bestellungen): Kundenadressen und native neue Bestellungen.

Öffnen Sie Modul-Manager > Konfigurieren oder den Eintrag Finnish Address im Backoffice-Menü. Die eine Einstellungsseite enthält Konfiguration, Integrität, Lizenz, Update und Support. Sichtbare Reihenfolge: Digitransit-Abonnementschlüssel, die vier Schalter oben, Speichern. Alle vier Schalter sind standardmäßig an. Der Schlüssel umfasst 32 Hexadezimalzeichen; ein leeres Feld entfernt ihn und deaktiviert den Dienst auf Formularen. Es gibt keine Länderauswahl. Wählen Sie im Multishop einen Shop, den Sie verwalten dürfen; Einstellungen und Schlüssel gelten pro Shop. Danach folgen Hinweise zu Abdeckung, Konto, manueller Eingabe, Datenschutz und CSP sowie der Hinweis zu weiteren Adressdiensten. Englischer Quelltext sowie deutsche, französische, polnische, italienische, spanische und finnische Einstellungen sind vorhanden. Schwedische Einstellungen fehlen; Anfragen verwenden lang=fi für Finnland (FI) und lang=sv für Åland (AX), unabhängig von der Seitensprache.

Für diese Länder verwenden gehört zu weltweiten Adressmodulen. Eine leere Liste umfasst alle im Formular verfügbaren Länder; eine Auswahl begrenzt den jeweiligen Dienst. Finnish Address deckt Finnland (FI) und Åland (AX) fest ab und hat keine Länderauswahl. Formulare für Åland (AX) erhalten schwedische Vorschläge, etwa Torggatan 1, 22100 Mariehamn. Die PLZ bestimmt das Land für Adressen und Straßen: 22xxx kennzeichnet Åland. FI- und AX-Formulare erhalten nur Ergebnisse für ihr eigenes Land; Zeilen ohne gültige PLZ werden verworfen. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle auf dem neuesten Stand. Französische BAN-Ziele sind von Finnland und Åland getrennt. Ein fehlgeschlagener Abruf wechselt nicht automatisch den Dienst.

Digitransit in einer Inhaltssicherheitsrichtlinie erlauben

Der aus dem Code ermittelte externe Ursprung lautet https://api.digitransit.fi in connect-src. Skripte und Styles kommen vom Shop; kein externes Digitransit-SDK, keine Schrift oder Karte wird geladen. Ergänzen Sie Ihre bestehende Richtlinie und behalten Sie Theme-, Inline-/Nonce- und Modulregeln. Für French Address Autocomplete erlauben Sie zusätzlich https://data.geopf.fr in connect-src. Der Portallink dient der Einrichtung und wird nicht vom Autocomplete geladen.

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

Wohnungs- und Lieferdetails behalten

Land, zweite Adresszeile, Name, Firma und Telefon bleiben unverändert. Ergänzen Sie Wohnung, Postfach, Etage und Eingang in Zeile zwei. Eine nach einem Treppenhausbuchstaben erkannte Wohnungsnummer muss zum Ergebnis passen; andernfalls erscheint kein Vorschlag. Eine reine Straßenauswahl leert die PLZ; Hausnummer und PLZ ergänzen Sie von Hand. Prüfen Sie die ganze Adresse vor dem Speichern. Manuelle Eingabe und Bearbeitung bleiben möglich.

Voraussetzungen

• Allgemeiner PrestaShop-Bereich: PS 1.6 – 9.x. Deklariertes Minimum: PrestaShop 1.6.1.0 und PHP ab 7.1.
• Native Adressfelder mit Bootstrap 3, 4 oder 5. Finnland oder Åland muss verfügbar sein; aktivieren Sie die Länder, in die Sie liefern.
• Prüfen Sie, dass Finnland oder Åland aktiv und in Ihren nativen Adressformularen verfügbar ist.

Für diese Länder verwenden gehört zu weltweiten Adressmodulen. Eine leere Liste umfasst alle im Formular verfügbaren Länder; eine Auswahl begrenzt den jeweiligen Dienst. Finnish Address deckt Finnland (FI) und Åland (AX) fest ab und hat keine Länderauswahl. Formulare für Åland (AX) erhalten schwedische Vorschläge, etwa Torggatan 1, 22100 Mariehamn. Die PLZ bestimmt das Land für Adressen und Straßen: 22xxx kennzeichnet Åland. FI- und AX-Formulare erhalten nur Ergebnisse für ihr eigenes Land; Zeilen ohne gültige PLZ werden verworfen. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle auf dem neuesten Stand. Französische BAN-Ziele sind von Finnland und Åland getrennt. Ein fehlgeschlagener Abruf wechselt nicht automatisch den Dienst.

Der Filter prüft erkannte Hausnummern, Treppenhausbuchstaben und Wohnungsnummern. Ein einzelner Buchstabe hinter der Nummer kann beim Schreiben des Orts kurz als Treppenhaus gelten. Eine erkannte Wohnungsnummer ohne passenden Treffer blendet die Liste aus. Eigene Formulare, Themes, Bestellrouten und gemischte Modulversionen benötigen Tests.

Vorschläge beginnen nach drei Zeichen und 300 ms Pause. Der Browser sendet einen direkten GET an https://api.digitransit.fi/geocoding/v1/autocomplete mit layers=address%2Cstreet, size=10, lang=fi für Finnland (FI) oder lang=sv für Åland (AX), text und digitransit-subscription-key. Der Adapter trennt angehängte Hausbuchstaben, entfernt alleinstehende fünfstellige PLZ und fasst Leerzeichen zusammen. Der ursprüngliche Text filtert die Ergebnisse weiterhin lokal. Höchstens fünf eindeutige gültige Optionen erscheinen. Adresstreffer haben Vorrang vor Straßen. Erkannte Hausnummern, Treppenhausbuchstaben und Wohnungsnummern müssen zum Treffer passen. Wortanfänge und Teilnummern grenzen die Liste ein; ein Treffer ist nicht garantiert.

Bei einem langsamen Dienst erscheint nach 600 ms die schlichte Zeile „Adressen werden gesucht…“. Nach zehn Sekunden endet der Abruf. Kunden können die Adresse weiter von Hand eingeben.

Felder der gewählten Adresse

Die Auswahl übernimmt Straße und Hausnummer aus dem Ergebnis, etwa Mannerheimintie 10 oder Hämeenkatu 5 A. Ein vorhandener Treppenhausbuchstabe A bleibt erhalten, ebenso ein angehängter Buchstabe wie 81a. Die PLZ behält fünf Ziffern, einschließlich der führenden Nullen in 00100. Der Ort stammt aus locality, ersatzweise localadmin. Auf Åland-Formularen wird Maarianhamina als Mariehamn geschrieben. Die Schreibweise des Orts wird nicht in Großbuchstaben umgewandelt. Land, zweite Adresszeile, Name, Firma und Telefon bleiben unverändert. Ergänzen Sie Wohnung, Postfach, Etage und Eingang in Zeile zwei. Eine nach einem Treppenhausbuchstaben erkannte Wohnungsnummer muss zum Ergebnis passen; andernfalls erscheint kein Vorschlag. Eine reine Straßenauswahl leert die PLZ; Hausnummer und PLZ ergänzen Sie von Hand. Prüfen Sie die ganze Adresse vor dem Speichern. Manuelle Eingabe und Bearbeitung bleiben möglich.

Für diese Länder verwenden gehört zu weltweiten Adressmodulen. Eine leere Liste umfasst alle im Formular verfügbaren Länder; eine Auswahl begrenzt den jeweiligen Dienst. Finnish Address deckt Finnland (FI) und Åland (AX) fest ab und hat keine Länderauswahl. Formulare für Åland (AX) erhalten schwedische Vorschläge, etwa Torggatan 1, 22100 Mariehamn. Die PLZ bestimmt das Land für Adressen und Straßen: 22xxx kennzeichnet Åland. FI- und AX-Formulare erhalten nur Ergebnisse für ihr eigenes Land; Zeilen ohne gültige PLZ werden verworfen. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle auf dem neuesten Stand. Französische BAN-Ziele sind von Finnland und Åland getrennt. Ein fehlgeschlagener Abruf wechselt nicht automatisch den Dienst.

Unter Kunden > Adressen können Mitarbeiter Adressen in Finnland oder Åland nach einer telefonischen Anfrage schneller erfassen. Ein Vorschlag füllt Straße, PLZ und Ort. Der Backoffice-Schalter arbeitet unabhängig von Kundenkonto und Checkout. Der Code berücksichtigt auch native Adressfenster neuer Bestellungen, wenn sie über die Kundenadressseite laufen. Eigene Routen und Fremdformulare benötigen eine Prüfung. Die gemeinsame Adress-Engine unterstützt entsprechend gekennzeichnete Formulare, etwa von Checkout Revolution. Beide Module verwenden dieselben Diensteinstellungen pro Shop.

Auf dem Smartphone tippen Ihre Kunden auf einen Vorschlag. Mit den Pfeiltasten wird navigiert, Enter wählt aus, Escape oder Tab schließt die Liste. Screenreader erhalten Ergebnisansagen. Die gemeinsame Liste verwendet die Bootstrap-Darstellung des Themes. Unter den Treffern steht © OpenStreetMap contributors, © Digitransit 2026. Ohne Treffer bleibt die Liste geschlossen; ein Dienstausfall wird angesagt. Eingabe und Bearbeitung von Hand bleiben möglich. Speichern verlangt keinen Vorschlag und führt keine Lieferadressprüfung aus.

Datenschutz und Datenquelle

Der Browser sendet aufbereiteten Suchtext, layers=address,street, size=10, lang=fi für Finnland (FI) oder lang=sv für Åland (AX) und Ihren Abonnementschlüssel als URL-Parameter an https://api.digitransit.fi. Keine eigenen Parameter für Name, E-Mail, Telefon, Firma, zweite Zeile oder Land. Inhalte im Suchfeld können übertragen werden. Der Schlüssel ist für Formularbesucher und Dienst sichtbar. Browser-Zugangsdaten sind deaktiviert; die Verbindung legt die IP offen und kann nach Browserrichtlinie Browserdaten (Kopfzeilen Origin und Referer) enthalten. Die Auswahl benötigt keinen Detailabruf. Die Diagnose enthält keine Suchtexte, Schlüssel, URLs oder Antworten; PrestaShop speichert die Adresse. Erwähnen Sie dies im Datenschutzhinweis. Hinweis: © OpenStreetMap contributors, © Digitransit YEAR, mit aktuellem Serverjahr.

• Abdeckung: Finnland und Åland, die Adressen von OpenStreetMap über den Digitransit-Geocoder (Fintraffic und HSL): sehr gut in Städten, einige ländliche Adressen fehlen. Die Vorschläge beginnen, sobald der Abonnementschlüssel gespeichert ist. Vollständigkeit, Aktualität, Rangfolge und unbegrenzte kostenlose Nutzung sind nicht zugesichert. Das aufgezeichnete Ergebnis Itäinen Rantakatu 2 enthält zwei PLZ; prüfen Sie die Auswahl.
• Adresstreffer benötigen eine fünfstellige PLZ und einen Ort. Unvollständige oder fehlerhafte Zeilen und Duplikate entfallen. Ohne gültigen Adresstreffer und erkannte Hausnummer kann eine reine Straße erscheinen. Ihre Auswahl leert die PLZ; ergänzen Sie Nummer und PLZ. Eine eigene Wohnungs-, Postfach- oder Abdeckung namenloser Straßen ist nicht belegt.
• Ohne Schlüssel erfolgt kein Abruf; Dienstberechtigungen können mit 401/403 scheitern. Bei 429 pausieren Anfragen gemäß Retry-After oder zehn Sekunden. Netzwerk-, Antwort- und Zeitlimitfehler lassen manuelle Eingabe zu. Kein automatischer Dienstwechsel.
• Der Filter prüft erkannte Hausnummern, Treppenhausbuchstaben und Wohnungsnummern. Ein einzelner Buchstabe hinter der Nummer kann beim Schreiben des Orts kurz als Treppenhaus gelten. Eine erkannte Wohnungsnummer ohne passenden Treffer blendet die Liste aus. Eigene Formulare, Themes, Bestellrouten und gemischte Modulversionen benötigen Tests.
• Keine Karte, Standortabfrage, Koordinatenspeicherung, Prüfung beim Absenden, Länderwahl oder Liefergarantie. Kostenloses Modul mit lebenslangen Updates ohne enthaltene Supportzusage. Aktuelle Bedingungen, Kontingente und Nutzung des Browserschlüssels müssen geprüft werden.

• Keine Treffer für Finnland oder Åland: Länderauswahl, Aktivierung und Haupt-/Formularschalter prüfen; vollständige Straße mit Nummer und Ort eingeben. Digitransit-Abonnementschlüssel: 32 Hexadezimalzeichen; 401/403.
• Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.
• Reine Straße oder kein Treffer: Ergänzen Sie Hausnummer, PLZ und Postort von Hand und prüfen Sie die Adresse vor dem Speichern.
• Dienst nicht verfügbar: Netzwerk/CSP für Digitransit prüfen, bei Rate-Limit warten und manuell fortfahren.
• Eigenes Formular oder Layout: natives Formular, Tastatur/Smartphone und Bestellroute testen; gemeinsame Diensteinstellungen pro Shop prüfen.