README_de.md

plzCrawler

Python command line tool das topografische Adressen anhand von Tabellendaten findet und automatisch Postleitzahlen hinzufügt

Versionsdatum: 2021-07-01

Geschwindigkeit: etwa 1 Sekunde/Zeile

Live Nutzung (Beispielanwendung)

exampleVideo.mp4

Installation & Ausführung (German🇩🇪 Windows 10)

Installation & Vorbereitung

1. ggf. Python auf PC installieren, sofern noch nicht geschehen

2. (ggf. Excelsheet entsprechend Rahmenbedingungen vorbereiten
   – sofern noch nicht geschehen)

   1. .xlsx-Format

   2. Tabellen-Spalten: Name, Straße (Format: Straßenname Hausnummer, PLZ (leer), Stadt

Ausführung

Hinweis: Während das Programm arbeitet am besten keine der Tabellen öffnen

Zu Software-Dateien navigieren

1. "Eingabeaufforderung" (CMD) öffnen

   1. Windows-Taste + R drücken > "cmd" eingeben > Enter drücken

2. In CMD zu Pfad navigieren, in dem sich Crawler-Dateien ("plzCrawler.py" & "plzMaker.py") und das requirements.txt befinden

   1. Text nach folgendem Muster eingeben:
      cd C:\Users\Username\Documents\plzcrawler

Virtuelle Umgebung (venv) erstellen

1. Folgenden Text in CMD eingeben & Eingabetaste drücken (um virtuelle Umgebung mit dem Namen "venv" zu erstellen):
   py -m venv venv

venv aktivieren

1. Folgenden Text in CMD eingeben & Eingabetaste drücken:
   venv\Scripts\activate.bat

Requirements.txt in venv installieren

1. Folgenden Text in CMD eingeben & Eingabetaste drücken:
   pip install -r requirements.txt

ausführende Datei ("plzMaker.py") ausführen und Anweisungen folgen

1. Folgenden Text in CMD eingeben & Eingabetaste drücken:
   py plzMaker.py

fertiges Tabellendokument finden

Das fertige Tabellendokument befindet sich im Ordner des ursprünglichen Tabellendokumentes.
Es ist erkennbar an der '+PLZ'-Endung.
Das neue Dokument sieht dem ursprünglichen Dokument sehr ähnlich und ist nun um die gefundenen Postleitzahlen ergänzt.
Außerdem enthält es ggf. Hinweise, weshalb einzelne Postleitzahlen nicht gefunden werden konnten.