CW Geo-Names

Version 0.1.0-alpha2

Release-Datum: 2026-09-10

• Fix gegenüber alpha1:
• Geo-Names Backend-CSS wurde wegen eines fehlerhaften Versionsparameters nicht geladen.
• cw_module_asset_url() liefert in CW bereits eine URL mit Query-String; alpha1 hängte fälschlich ein zweites '?' an.
• alpha2 verwendet nun query-sichere Versionierung (? bzw. &).
• Funktional unverändert:
• GeoNames cities500 Remote-Check
• Download + Staging-Import in SQLite
• Ortssuche
• Nächster-Ort-Resolver
• interne PHP-API
• optionale öffentliche REST-API mit API-Key

Version 0.1.0-alpha1

Erster Release / Geo Service Foundation

Neu

• Eigenständiges CW-Modul für Ortsnamen, Koordinatenauflösung und gemeinsame Geo-Dienste.
• Modulicon und Teaser im visuellen Stil von CW Environment.
• Weltweite Ortsbasis über GeoNames cities500.
• GeoNames-Daten werden direkt im Modulbackend heruntergeladen; keine manuellen ZIP-Uploads nötig.
• Leichte Remote-Stand-Prüfung im Backend nach konfigurierbarem täglichem/wöchentlichem/monatlichem Intervall; verfügbare Updates werden markiert.
• Zusätzlicher Download von Admin1/Admin2 und Länderinformationen.
• Chunkweiser SQLite-Import mit Staging-Datenbank und atomarem Aktivieren.
• Zwei vorherige Datenbankstände können als Rollback im Storage erhalten bleiben.
• Serverprüfung für PDO SQLite, ZipArchive und HTTPS-Download.
• Resolver
• cw_geo_names_search(): lokale Ortssuche.
• cw_geo_names_nearest(): nächstgelegene Orte zu Latitude/Longitude.
• cw_geo_names_location(): kombinierte Antwort aus Referenzkoordinate und nächstem Ort.
• Entfernungsberechnung über Haversine/WGS84.

API

• Öffentliche REST-API optional und standardmäßig deaktiviert.
• API-Basis standardmäßig /api/geo/v1.
• Endpunkte: status, nearest, location, search.
• Authentifizierung optional ohne Key oder per Bearer API-Key.
• API-Keys werden nur einmal vollständig angezeigt und gehasht gespeichert.
• Rate-Limit pro Minute und optionale CORS-Origin-Liste.
• Transparenz
• GeoNames: CC BY 4.0.
• Daten werden nicht im Releasepaket gebündelt.
• alpha1 unterscheidet ausdrücklich zwischen „nächster Ort“ und exakter Punkt-in-Verwaltungsgebiet-Auflösung.
• BKG VG250 / Eurostat GISCO / geoBoundaries sind für eine spätere Polygonauflösung vorgesehen.