offline_demo

Offline POI explorer

Kleines Local-first-Beispiel für einen durchsuchbaren POI-Snapshot. Es läuft ohne SQLite, externen Dienst oder Netzverbindung und kann denselben Snapshot wahlweise per CLI oder in einem Browser-Explorer durchsuchen.

Start

# Flüchtiger Beispieldatensatz im Speicher
go run ./cmd/offline_demo

# Wiederverwendbaren Snapshot erzeugen oder erneut öffnen
go run ./cmd/offline_demo -snapshot /tmp/tinysql-poi.snapshot -query museum

# Maschinenlesbare Ausgabe
go run ./cmd/offline_demo -snapshot /tmp/tinysql-poi.snapshot -json

# POIs im Umkreis des Marienplatzes, nach Entfernung sortiert
go run ./cmd/offline_demo -near 11.5756,48.1372 -radius-m 1500

# Umkreissuche mit zusätzlichem Textfilter
go run ./cmd/offline_demo -near 11.5756,48.1372 -radius-m 1500 -query museum -json

# Browser-Explorer für denselben Snapshot
go run ./cmd/offline_demo -web -addr 127.0.0.1:8086 \
  -snapshot /tmp/tinysql-poi.snapshot
# http://localhost:8086

Snapshot-Lebenszyklus

Ohne -snapshot erzeugt das Programm den kleinen Beispieldatensatz im Speicher. Mit einem Pfad lädt es einen vorhandenen Snapshot oder erzeugt ihn beim ersten Aufruf. -rebuild ignoriert einen vorhandenen Snapshot und schreibt den Beispieldatensatz neu. -read-only ist standardmäßig true und sperrt die Datenbank nach dem Laden bzw. Anlegen gegen weitere Änderungen.

Bei -near ohne explizites -query werden alle Kategorien durchsucht. Mit -query lässt sich der Umkreis auf passende Namen, Städte oder Kategorien eingrenzen. Die Entfernung berechnet tinySQL mit GEO_DISTANCE als Luftlinie auf einer Kugel; sie ist keine Wegstrecke. Die Grenzen sind inklusive, und Treffer werden nach Entfernung, Name und ID sortiert. Die Umkreissuche ist auch bei erneut geöffneten Snapshots schreibgeschützt möglich.

-near und -radius-m gelten für CLI-Suchen. Im Webmodus werden die Felder im Browser verwendet; die Kombination dieser CLI-Optionen mit -web wird ausdrücklich abgelehnt.

Der Browser startet mit leerem Suchfeld und zeigt zunächst alle POIs. Ein Textbegriff filtert die Ergebnisse optional; so lässt sich beispielsweise eine Umkreissuche in Berlin ohne vorheriges Löschen eines Ortsnamens ausführen. Der CLI-Standard ohne Umkreissuche bleibt München.

Browser-API und Datenschutz

Der Webmodus stellt nur lesende Endpunkte bereit:

Für die Umkreissuche müssen lon, lat und radius_m gemeinsam angegeben werden. Ungültige Koordinaten oder ein nicht positiver Radius liefern HTTP 400. Die Einträge enthalten distance_m nur bei einer Umkreissuche; bei einer Textsuche bleibt die bestehende JSON-Struktur erhalten. Die Karte zeigt gefundene Orte als rote Punkte und das Suchzentrum als Ring.

Die Oberfläche lädt keine externen Kartenkacheln und überträgt den Snapshot nicht an einen Kartendienst. Ein eventuell sichtbarer OpenStreetMap-Link wird erst nach einem bewussten Klick geöffnet; dabei sendet der Browser die Koordinaten an OpenStreetMap. Für lokale Nutzung den Webserver an 127.0.0.1:8086 binden.

Der kleine Datensatz zeigt nur den Snapshot- und Read-only-Lebenszyklus. Für größere Kartenbestände sind die dedizierten POI-Index- oder MBTiles-Pfade vorgesehen.