GitHupdatatorium/kartana

Kartana Adressformular

Deutschlandweite Adressvorschläge

Mit Kartana lässt sich dein Adressformular im Handumdrehen mit Autovervollständigung ausstatten. Kostenfrei und unlimitiert.

So geht's

Datenqualität beginnt bei der Eingabe

Kartana rüstet Deine Adressformulare mit Autovervollständigung aus. Während der Adresseingabe werden passende Adressen vorgeschlagen. Das ist komfortabel für den Benutzer und sorgt zugleich für eine verbesserte Datenqualität. Tippfehler gehören der Vergangenheit an.

  • Deutschlandweit

    Mehr als 1.2 Millionen Straßen in 11 Tausend Gemeinden.

  • Kostenlos

    Kostenfrei und unlimitiert. Für große und kleine Webprojekte.

  • Frei lizenzierte Daten

    Kartana basiert vollständig auf frei lizenzierten Daten.

  • Leicht zu integrieren

    Kartana lässt sich in nur wenigen Minuten in ein vorhandenes Adressformular integrieren.

Kartana macht glücklich
Benutzer

Mehr Zeit für schöne Dinge. Kartana spart Zeit und Nerven bei der Eingabe von Adressen.

Kartana macht glücklich
Entwickler

Sieht aus wie 14 Tage Arbeit, dauert aber nur 5 Minuten.

Kartana macht glücklich
Datenpfleger

Normierte Adressen ohne Tippfehler.

Kartana macht glücklich
Buchhalter

Auch wenn sie es vielleicht nie erfahren. Kartana kostet nichts.

In wenigen Schritten zur Autovervollständigung

Folge den nachfolgenden Schritten, um dein Adressformular mit der Autovervollständigung von Kartana auszustatten. Vollständige Beispiele findest du außerdem im Kartana GitHup Repository.

  1. 1. Herunterladen und Einbinden der Kartana Bibliothek

    Die Kartana Bibliothek besteht aus einem JavaScript-Modul und einem (minimalen) CSS-Stylesheet.

    DownloadDateigrößeBeschreibungVersionRelease
    kartana.js 19,4 kB Java Script Komponente. Alternativ kann auch eine Typescript-Version aus dem GitHup Repository heruntergeladen werden. 1.4 05.03.2022
    kartana.css 1,7 kB Funktionales CSS-Stylesheet 1.4 05.03.2022

    Die Heruntergeladenen Dateien werden wie folgt im <head>-Bereich eines HTML-Dokumentes eingebunden. 

    <script src="kartana.js"></script>
<link href="kartana.css" rel="stylesheet"/>

    Wenn sich die heruntergeladenen Dateien nicht im selben Order wie das HTML-Dokument befinden, muss der Pfad zu den Dateien angegeben werden (z.B. unterordner/kartana.js)

  2. 2. Aktivieren der Autovervollständigung

    Jedes Text-Eingabefeld kann mit automatischen Adressvorschlägen ausgerüstet werden. Hierzu genügt es, das Attribut data-kartana-field auf einen der folgenden Werte zu setzen.

    data-kartana-fieldAutovervollständigung
    postcodePostleitzahl
    municipalityOrtschaft (Gemeinde)
    streetStraße

    Nachfolgendes Beispiels zeigt ein einfaches Adresseingabeformular. 

    <input type="search" name="postcode" data-kartana-field="postcode"/>
<input type="search" name="municipality" data-kartana-field="municipality"/>
<input type="search" name="street" data-kartana-field="street"/>
<input type="search" name="house-number"/>

    Um zwischen mehreren Adressen auf derselben Seite zu unterscheiden, muss zusätzlich das Attribut data-kartana-address mit einem für die Adresse eindeutigen Bezeichner gefüllt sein.

    <!-- Lieferadresse -->
<input type="search" data-kartana-address="shipping" data-kartana-field="postcode"/>
<input type="search" data-kartana-address="shipping" data-kartana-field="municipality"/>
<input type="search" data-kartana-address="shipping" data-kartana-field="street"/>
...
<!-- Rechnungsadresse -->
<input type="search" data-kartana-address="invoice" data-kartana-field="postcode"/>
<input type="search" data-kartana-address="invoice" data-kartana-field="municipality"/>
<input type="search" data-kartana-address="invoice" data-kartana-field="street"/>

  3. 3. Styling (für Puristen optional)

    Kartana stellt einige CSS-Klassen bereit, mit denen sich das Eingabefeld und die Adressvorschläge leicht gestalten lassen.

    Visualisierung der CSS Klassen des Eingabefeldes.
    Abb. 1: CSS-Klassen des Eingabefeldes.
    CSS SelektorBeschreibung
    div.kartana.comboboxÄußerer Container
    input.inputTexteingabefeld
    ul.menuContainer für Vorschläge
    option.optionVorschlag
    span.valueVorgeschlagener Wert
    z.B. 42103 für das Eingabefeld Postleitzahl
    span.contextVorgeschlagener Wert für ein anderes Eingabefeld (Kontext)
    z.B. Wuppertal als Kontext zur Postleitzahl 42103
    span.context.contextmatchKontext, der zum Inhalt der anderen Eingabefelder passt
    span.context.nocontextmatchKontext, der nicht zum Inhalt der anderen Eingabefelder passt

Datengrundlage

Kartana basiert vollständig auf Transformationen frei lizenzierten Adressdaten.

Nutzungsbedingungen

Kartana darf kostenfrei für die Autovervollständigung von Adressen verwendet werden. Alle Bestandteile werden "so wie sie sind" und ohne Gewährleistungen jedweder Art angeboten. Der Link zu kartana.de darf aus dem Vorschlagsmenü entfernt werden, sofern an anderer Stelle im Kontext des Adressformulars ein entsprechender Link eingefügt wird.

Datenschutz

Verantwortlich im Sinne des Datenschutzgesetzes bin ich:

Raphael Bögel
Hauptstraße 18C
40699 Erkrath

Im Nachfolgenden möchte ich Dich darüber informieren, welche personenbezogenen Daten von Kartana erhoben und verarbeitet werden. Du hast jederzeit das Recht auf Auskunft darüber, welche Daten über Dich erfasst sind und kannst deren Korrektur oder Löschung verlangen. Wende Dich hierfür oder bei jedweden Fragen zum Thema Datenschutz entweder per E-Mail an raphael@datatorium.de oder schriftlich an die oben genannte Adresse.

Erhebung personenbezogener Daten und deren Verwendung

Beim Besuch dieser Webseite oder bei der Nutzung der Kartana Autovervollständigung auf dieser oder einer anderen Webseite werden technische und personenbezogene Daten von Deinem Browser an Kartana sowie AWS als auftragsverarbeitender Dienstleister übermittelt. Insbesondere beinhalten diese Informationen Deine IP-Adresse, Inhalt und Zeitpunkt der Anfrage sowie technische Informationen zu Deinem Browser und Betriebssystem.

Sofern nicht ausdrücklich genannt, werden personenbezogene Daten ausschließlich temporär zur Gewährleistung der technischen Funktionsfähigkeit der angebotenen Dienste genutzt.

Zur Erstellung von Nutzungsstatistiken und zur stetigen Verbesserung des Services werden bei der Nutzung eines Kartana Adressformulars folgende Daten erhoben und gespeichert:

  • Die Domain der Webseite, auf welcher das Adressformular verwendet wird (Referrer Origin).
  • Der Zeitpunkt der Anfrage.
  • Die zur Vervollständigung übermittelten Angaben sowie die daraufhin vorgeschlagenen Adressen.
    Da diese Adressangaben keine Hausnummer beinhalten, ist kein Bezug zu einer natürlichen Person möglich.
  • Die verwendete API Version und ggf. weitere technische Daten zur Anfrage.

Kartana verwendet keine Cookies 🍪

Auftragsverarbeitung durch Amazon Web Services

Kartana nutzt den Cloud-Anbieter Amazon Web Services (AWS) als Dienstleister für die technische Infrastruktur. AWS verarbeitet übermittelte Daten ausschließlich im Rahmen einer Auftragsverarbeitung, um den technischen Betrieb zu ermöglichen. Hierzu hat AWS mit allen AWS Kunden (z.B. Kartana) einen Auftragsverarbeitungsvertrag (AV) geschlossen. Dieser regelt die Datenschutzkonforme Datenverarbeitung durch AWS.