GitHupdatatorium/kartana
Kartana ist leider offline. Ich möchte mich bei allen bedanken, die Kartana genutzt haben!

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.

        Themawechsel: Nebenkosten

        nebenkosten-klartext.de ist Kartanas Schwester-Projekt. Wenn du eine Wohnung mietest, könnte es auch interessant für dich sein. Klartext scannt deine Nebenkostenabrechnung für dich und zeigt dir, wo do vielleicht zu viel zahlst: Nebenkostenabrechnung jetzt kostenlos prüfen

        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.