GeoLocation BL

Was ist neu in Version 1.2

Version 1.2 bringt den neuen Namen, ein eigenes Programmsymbol und zwei Aenderungen, die vor allem auf einem neu eingerichteten Rechner wichtig sind.

Rueckblick: Was Version 1.1 gebracht hat

Version 1.1 war eine Fehlerbehebung nach den ersten Praxistests von Version 1.0.

1. Programm starten – welche Fassung?

Es gibt zwei Wege, das Programm zu starten. Sie tun dasselbe, unterscheiden sich aber deutlich in Voraussetzungen und Bequemlichkeit:

Warum die EXE die richtige Wahl ist

• Kein Python noetig. Die EXE enthaelt den Python-Unterbau und alle benoetigten Bibliotheken. Auf einem frischen Windows-Rechner laeuft sie ohne jede Installation.
• Keine Versionskonflikte. Eine spaetere Python- oder PyQt-Aktualisierung auf dem Rechner kann das Programm nicht mehr stoeren.
• Ein Doppelklick statt einer Batch. Verknuepfung auf den Desktop legen, fertig.
• Transportabel. Der Ordner dist mit EXE und Handbuch.html laesst sich vollstaendig kopieren.

Erzeugt wird die EXE einmalig mit build_GeoLocation-BL.bat (siehe Abschnitt 10). Danach wird sie nur noch benutzt.

Beim ersten Start warnt Windows ("SmartScreen") moeglicherweise vor einer unbekannten Anwendung, weil die EXE nicht digital signiert ist. „Weitere Informationen“ → „Trotzdem ausfuehren“.

2. Erste Schritte

1. Programm starten.
2. Ortsdatenbank laden (einmalig, Internet noetig): Extras → Ortsdatenbank laden / aktualisieren. Ohne diesen Schritt arbeitet das Programm mit einer eingebauten Notfallliste von rund 250 Orten – das reicht nur fuer eine sehr grobe Zuordnung.
3. Fotoordner hinzufuegen: Werkzeugleiste → Ordner hinzufuegen (lokal) oder Netzwerkordner (NAS, UNC-Pfad).
4. Das Programm durchsucht den Ordner samt Unterordnern, liest die EXIF-Daten und ordnet jedem Foto mit GPS-Koordinaten den naechstgelegenen Ort zu.
5. Auswerten: links Jahre und Orte anklicken, rechts die Einzelheiten lesen, im Reiter Karte die Aufnahmeorte ansehen.

3. Ortsdatenbank

Ein Foto enthaelt nur Koordinaten (z. B. 47.9990 / 7.8421), keinen Ortsnamen. Den Namen ermittelt das Programm auf zwei Wegen:

Offline (Standard)

Eine Ortsliste von GeoNames wird einmalig heruntergeladen und in eine lokale Datei orte.sqlite umgewandelt. Danach laeuft die Zuordnung ohne Internet und sehr schnell (mehr als 20.000 Zuordnungen pro Sekunde). Drei Umfaenge stehen zur Wahl:

Zugeordnet wird immer der naechstgelegene Ort. Liegt er weiter als 30 km entfernt (z. B. Aufnahme auf hoher See oder im Gebirge), steht die Entfernung in Klammern dabei: Zermatt (58 km entfernt).

Online (auf Wunsch, genauer)

Extras → Ortsnamen online nachschlagen fragt fuer die aktuell angezeigte Auswahl den Dienst Nominatim (OpenStreetMap) ab und liefert die tatsaechliche Adresse statt der naechsten Stadt – also z. B. den Ortsteil.

4. Bedienung im Einzelnen

Werkzeugleiste

Linke Spalte: Jahre und Orte

• Jahre – ein Jahr anklicken filtert; mit Strg oder Umschalt lassen sich mehrere Jahre gleichzeitig waehlen. Alle Jahre hebt die Auswahl auf.
• Orte – dreistufiger Baum: Land → Region → Ort. Ein Klick auf eine beliebige Ebene filtert entsprechend: Klick auf „Italien“ zeigt alle Italien-Fotos, Klick auf „Rom“ nur die aus Rom. In Klammern steht jeweils die Anzahl.
• Ohne GPS-Daten – eigener Zweig ganz unten: alle Fotos, in denen keine brauchbaren Koordinaten stehen.

Jahres- und Ortsfilter wirken zusammen: Jahr 2024 und Ort Rom zeigt nur die Rom-Fotos aus 2024. Der Ortsbaum passt seine Anzahlen an den gewaehlten Jahresfilter an.

Mitte: Bilder und Karte

• Bilder – Vorschauraster. Die Vorschaubilder werden im Hintergrund erzeugt und dauerhaft zwischengespeichert; beim zweiten Anzeigen sind sie sofort da. Doppelklick oeffnet das Foto im Standardprogramm von Windows.
• Vorschaugroesse – unter Ansicht zwischen 120 und 320 Pixel umschaltbar.
• Karte – siehe Abschnitt 6.

Rechte Spalte: Einzelheiten

Zum gewaehlten Foto: Ort, Region, Land, Koordinaten, Hoehe, Aufnahmedatum (mit Quelle: EXIF, Dateiname oder Dateidatum), Kamera, Bild- und Dateigroesse sowie der vollstaendige Pfad. Ueber die Schaltflaechen lassen sich der enthaltende Ordner im Explorer und der Aufnahmeort in OpenStreetMap oeffnen.

Menue Extras

• Ortsdatenbank laden / aktualisieren – siehe Abschnitt 3.
• Orte neu zuordnen (offline) – ordnet alle bereits eingelesenen Fotos anhand der aktuellen Ortsdatenbank neu zu. Sinnvoll nach dem Wechsel auf einen groesseren Datenbestand.
• Ortsnamen online nachschlagen – siehe Abschnitt 3.
• Index vollstaendig zuruecksetzen – loescht alle Eintraege aus der Datenbank. Die Fotos bleiben unangetastet, die Ordnerliste bleibt erhalten.

5. Netzwerkordner und NAS

Netzlaufwerke werden auf zwei Arten unterstuetzt:

\\NAS\Fotos\Urlaub        (UNC-Pfad, empfohlen)
Z:\Bilder                (verbundenes Netzlaufwerk)

Beide Schreibweisen funktionieren mit Netzwerkordner in der Werkzeugleiste. Ist der Pfad nicht erreichbar, meldet das Programm dies sofort, statt in einen langen Wartezustand zu laufen.

Worauf man achten sollte

• Der erste Durchlauf dauert. Jedes Foto muss ueber das Netz geoeffnet werden, um die EXIF-Daten zu lesen. Ueber WLAN sind 1.000 bis 3.000 Fotos pro Minute realistisch, ueber Gigabit-Kabel deutlich mehr.
• Der zweite Durchlauf ist schnell. Unveraenderte Dateien (gleicher Pfad, gleiche Groesse, gleiches Aenderungsdatum) werden uebersprungen.
• Unterbrechungen sind unkritisch. Faellt das Netzlaufwerk aus oder brechen Sie ab, bleibt alles bis dahin Eingelesene erhalten. Einzelne unlesbare Dateien werden uebersprungen und am Ende aufgelistet.
• Anmeldung zuerst. Das Netzlaufwerk muss im Explorer bereits erreichbar sein (Anmeldedaten hinterlegt). Das Programm fragt keine Zugangsdaten ab.
• Verknuepfungen werden nicht verfolgt – das verhindert Endlosschleifen bei rekursiven Freigaben.

6. Karte

Im Reiter Karte erscheint jeder Aufnahmeort als Kreis; seine Groesse richtet sich nach der Anzahl der Fotos. Ein Klick auf einen Kreis springt zurueck zur Bilderansicht und filtert auf diesen Ort. Der Jahresfilter wirkt auch auf die Karte.

• Die Karte benoetigt Internet (Kartenkacheln von OpenStreetMap).
• Die eingebettete Karte setzt das Paket PyQt6-WebEngine voraus. Fehlt es, bleibt der Reiter leer – die Schaltflaeche Karte im Browser oeffnen funktioniert aber immer und zeigt dieselbe Karte im Standardbrowser.

7. Wo liegen die Daten?

Alle vom Programm erzeugten Dateien liegen ausserhalb Ihrer Fotosammlung. Seit Version 1.2 neben dem Programm:

<Ordner der EXE>\Daten\
   index.sqlite      Index der Fotos (Pfade, Koordinaten, Orte, Datum)
   orte.sqlite       heruntergeladene Ortsdatenbank
   vorschau\         zwischengespeicherte Vorschaubilder

Der Vorteil: Kopieren Sie den Programmordner auf einen anderen Rechner oder einen USB-Stick, ziehen Index und Ortsdatenbank mit. Auf dem neuen Rechner muss nichts erneut heruntergeladen und nichts neu eingelesen werden.

Wann das Programm ausweicht

Ist der Programmordner nicht beschreibbar – etwa bei einer Installation unter C:\Programme –, legt das Programm die Daten stattdessen hier ab:

%LOCALAPPDATA%\GeoLocation-BL\

Das entspricht in der Regel C:\Users\<Name>\AppData\Local\GeoLocation-BL. Welcher Ordner gerade benutzt wird, steht im Fenster Hilfe → Ueber.

Umstieg von Foto-GeoLocation

Beim ersten Start sucht das Programm nach Daten der Vorgaengerversion (%LOCALAPPDATA%\Foto-GeoLocation) und verschiebt sie in den neuen Datenordner. Der Index und die heruntergeladene Ortsdatenbank bleiben also erhalten; ein Vermerk uebernommen_aus.txt haelt fest, woher die Daten stammen. Enthaelt der neue Ordner bereits Daten, wird nichts angetastet.

Betrieb vom USB-Stick

Eine leere Datei namens portabel.txt neben der EXE erzwingt den Ordner Daten auch dann, wenn ein Schreibversuch scheitert.

8. Unterstuetzte Dateiformate

Fehlt in einem Bild das Aufnahmedatum, versucht das Programm zuerst, es aus dem Dateinamen zu lesen (Muster wie IMG_20230715_... oder 2023-07-15...), und nimmt sonst das Dateidatum. Welche Quelle benutzt wurde, steht in den Einzelheiten rechts.

9. Wenn etwas nicht klappt

Fehlerbericht

Tritt im Programm ein Fehler auf, erscheint seit Version 1.1 ein Hinweisfenster mit der vollstaendigen Meldung, und das Programm laeuft weiter. Zusaetzlich wird alles gespeichert:

<Datenordner>\Fehlerbericht.txt    (Fehler mit Zeilennummern)
<Datenordner>\Absturzbericht.txt   (harte Abstuerze, z. B. in Qt)

Der Datenordner ist in der Regel Daten neben der EXE, sonst %LOCALAPPDATA%\GeoLocation-BL – der genaue Pfad steht unter Hilfe → Ueber.

Beide Dateien lassen sich ueber Hilfe → Fehlerbericht anzeigen oeffnen. Wenn etwas nicht funktioniert, ist dieser Text die entscheidende Information – besonders bei der EXE-Fassung, die kein Konsolenfenster hat.

10. EXE selbst erzeugen

1. Alle Projektdateien in einen Ordner entpacken.
2. build_GeoLocation-BL.bat per Doppelklick starten.
3. Die Nachfrage nach PyQt6-WebEngine beantworten: j = eingebettete Karte, EXE etwa 130 MB groesser; n = schlanke EXE, Karte oeffnet sich im Browser.
4. Ergebnis: dist\GeoLocation-BL.exe samt Handbuch.html. Den Ordner dist an den gewuenschten Platz kopieren und eine Verknuepfung anlegen.

Der Bauvorgang ruft py -m PyInstaller auf – nicht pyinstaller, weil dessen Scripts-Ordner unter dem Python Install Manager nicht im PATH liegt.

11. Technische Hinweise

Aufbau

So wird der Ort ermittelt

Die Ortsliste wird in ein Gitter aus 1-Grad-Zellen einsortiert. Zu einer Koordinate wird zunaechst die eigene Zelle durchsucht, dann ringfoermig nach aussen, bis kein naeherer Ort mehr moeglich ist. Die Entfernung wird nach der Haversine-Formel auf der Kugel berechnet. Das Verfahren kommt ohne Zusatzpakete aus und liefert nachweislich dasselbe Ergebnis wie ein vollstaendiger Vergleich mit allen Orten – nur um den Faktor 1.700 schneller.

Was in Version 1.0 fehlt

• Keine Auswertung von Videodateien
• Kein Kopieren oder Verschieben von Fotos in eine Ordnerstruktur (bewusst weggelassen: Version 1.0 liest nur)
• Keine Zusammenfassung dicht beieinander liegender Orte zu Reisen
• Kein Export der Auswertung (CSV, KML)

12. Haftungsausschluss und Datenquellen

Datenquellen:

• Ortsdaten: GeoNames, Lizenz CC BY 4.0
• Adressabfrage: Nominatim (OpenStreetMap), Nutzungsbedingungen: max. 1 Abfrage pro Sekunde
• Kartendarstellung: OpenStreetMap-Mitwirkende (ODbL), Kartenbibliothek Leaflet

Hinweis zum Datenschutz: GPS-Daten aus Fotos sind personenbezogene Daten. Das Programm sendet Koordinaten nur dann ins Internet, wenn Sie die Online-Abfrage ausdruecklich starten oder die Karte oeffnen. Der Index bleibt auf Ihrem Rechner.