====== std.geo ======

Geografische Koordinaten im WGS-84-System als ''GeoPoint'' (Längengrad/Breitengrad in Mikro-Grad: 1 Grad = 1.000.000 Einheiten). Berechnet Abstände über die Haversine-Formel (sphärische Erde, Erdradius 6.371.000 m), Peilung (''Bearing''), Mittelpunkte, Bounding-Boxes und prüft Punkt-in-Rechteck. Unterstützt DMS-Format (Grad, Minuten, Sekunden) und Umrechnung.

Einsatzbereiche: Standortdienste, Kartenanwendungen, Geo-Fencing, Umkreissuche (SEO-Local-Pack), Routenberechnungen, Point-of-Interest-Filterung.

**Autor:** Andreas Röne\\
**Copyright:** 2024-2025 Andreas Röne

----

===== Typen =====

==== GeoPoint (struct) ====

^ Feld ^ Typ ^ Bedeutung ^
| ''x'' | ''int64'' | Längengrad in Mikro-Grad (1 Grad = 1.000.000) |
| ''y'' | ''int64'' | Breitengrad in Mikro-Grad |

==== GeoBBox (struct) ====

Achsenparallele Bounding-Box. Felder sind flach (keine verschachtelten Structs — von Lyx nicht unterstützt); Min-/Max-GeoPoint über ''GeoBBoxGetMin''/''GeoBBoxGetMax'' extrahieren.

^ Feld ^ Typ ^ Bedeutung ^
| ''minX'' | ''int64'' | Minimaler Längengrad (Mikro-Grad) |
| ''minY'' | ''int64'' | Minimaler Breitengrad (Mikro-Grad) |
| ''maxX'' | ''int64'' | Maximaler Längengrad (Mikro-Grad) |
| ''maxY'' | ''int64'' | Maximaler Breitengrad (Mikro-Grad) |

----

===== Konstanten =====

^ Name ^ Typ ^ Wert ^ Sichtbarkeit ^

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''ParseLat(s: pchar): int64'' | pub | Parst Breitengrad-String zu Mikro-Grad |
| ''ParseLon(s: pchar): int64'' | pub | Parst Längengrad-String zu Mikro-Grad |
| ''FormatDecimal(coord: int64): pchar'' | pub | Formatiert Mikro-Grad als Dezimalstring |
| ''IsValidLat(lat: int64): bool'' | pub | Prüft Breitengrad auf WGS-84-Gültigkeit |
| ''IsValidLon(lon: int64): bool'' | pub | Prüft Längengrad auf WGS-84-Gültigkeit |
| ''IsValidGeoPoint(p: GeoPoint): bool'' | pub | Prüft GeoPoint auf gültige Koordinaten |
| ''GeoPointNew(lon: int64, lat: int64): GeoPoint'' | pub | Erstellt neuen GeoPoint aus Koordinaten |
| ''DistanceM(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet Abstand in Metern (Haversine) |
| ''DistanceMLegacy(lat1: int64, lon1: int64, lat2: int64, lon2: int64): int64'' | pub | Berechnet Abstand aus Einzelkoordinaten |
| ''DistanceKm(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet Abstand in Kilometern |
| ''DistanceSq(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet quadratischen Näherungsabstand |
| ''IsWithinDistanceM(p1: GeoPoint, p2: GeoPoint, thresholdM: int64): bool'' | pub | Prüft ob Abstand unter Schwellenwert liegt |
| ''Midpoint(p1: GeoPoint, p2: GeoPoint): GeoPoint'' | pub | Berechnet geografischen Mittelpunkt zweier Punkte |
| ''MidpointLat(lat1: int64, lat2: int64): int64'' | pub | Berechnet Mittel-Breitengrad |
| ''MidpointLon(lon1: int64, lon2: int64): int64'' | pub | Berechnet Mittel-Längengrad |
| ''IsPointInRect(p: GeoPoint, min: GeoPoint, max: GeoPoint): bool'' | pub | Prüft ob Punkt in Bounding-Box liegt |
| ''BoundingBoxMin(p1: GeoPoint, p2: GeoPoint): GeoPoint'' | pub | Berechnet Minimaleckpunkt der Bounding-Box |
| ''BoundingBoxMax(p1: GeoPoint, p2: GeoPoint): GeoPoint'' | pub | Berechnet Maximaleckpunkt der Bounding-Box |
| ''DoBoundingBoxesOverlap(min1: GeoPoint, max1: GeoPoint, min2: GeoPoint, max2: GeoPoint): bool'' | pub | Prüft Überschneidung zweier Bounding-Boxes |
| ''BoundingBoxCenter(min: GeoPoint, max: GeoPoint): GeoPoint'' | pub | Berechnet Mittelpunkt einer Bounding-Box |
| ''Bearing(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet Peilwinkel zwischen zwei Punkten |
| ''HaversineDistanceM(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet Haversine-Abstand in Metern |
| ''ParseDMS(degrees: int64, minutes: int64, seconds: int64, direction: int64): int64'' | pub | Parst Grad-Minuten-Sekunden zu Mikro-Grad |
| ''FormatDMS(coord: int64, isLatitude: bool): pchar'' | pub | Formatiert Koordinate als DMS-String |
| ''IsPointInRect2(p: GeoPoint, minLat: int64, minLon: int64, maxLat: int64, maxLon: int64): bool'' | pub | Prüft Punkt gegen explizite Bounding-Box |
| ''CalculateBoundingBoxMin(center: GeoPoint, radiusM: int64): GeoPoint'' | pub | Berechnet Min-Eckpunkt für Umkreis |
| ''CalculateBoundingBoxMax(center: GeoPoint, radiusM: int64): GeoPoint'' | pub | Berechnet Max-Eckpunkt für Umkreis |
| ''AddOffsetM(center: GeoPoint, bearing: int64, distanceM: int64): GeoPoint'' | pub | Verschiebt GeoPoint um Distanz in Richtung |
| ''CorrectLongitudeForLatitude(dLon: int64, lat: int64): int64'' | pub | Korrigiert Längengrad-Delta für Breite |
| ''DistanceMCorrected(p1: GeoPoint, p2: GeoPoint): int64'' | pub | Berechnet breitengradkorrigierten Abstand |
| ''BoundingBoxFromPoints(p1: GeoPoint, p2: GeoPoint): GeoBBox'' | pub | Kleinste Bounding-Box um zwei Punkte |
| ''CalculateBoundingBox(center: GeoPoint, radiusM: int64): GeoBBox'' | pub | Bounding-Box um Mittelpunkt mit Radius in Metern |
| ''GeoBBoxGetMin(bb: GeoBBox): GeoPoint'' | pub | Extrahiert Min-Eckpunkt (''minX''/''minY'') als ''GeoPoint'' |
| ''GeoBBoxGetMax(bb: GeoBBox): GeoPoint'' | pub | Extrahiert Max-Eckpunkt (''maxX''/''maxY'') als ''GeoPoint'' |
| ''GeoBBoxContains(bb: GeoBBox, p: GeoPoint): bool'' | pub | Prüft ob Punkt innerhalb der Bounding-Box liegt |
| ''GeoBBoxOverlaps(a: GeoBBox, b: GeoBBox): bool'' | pub | Prüft ob zwei Bounding-Boxes sich überschneiden |
| ''GeoBBoxCenter(bb: GeoBBox): GeoPoint'' | pub | Berechnet Mittelpunkt einer Bounding-Box |

----

===== Hinweise =====

  * **GeoBBox vs. alte BoundingBox-Helfer**: Die Funktionen ''BoundingBoxMin''/''BoundingBoxMax''/''DoBoundingBoxesOverlap''/''BoundingBoxCenter'' arbeiten mit zwei losen ''GeoPoint''-Argumenten. ''GeoBBox'' ist eine zusammengesetzte Struktur — bevorzuge die ''GeoBBox...''-API für neuen Code.
  * **Flache Felder**: Lyx unterstützt keine Structs als Struct-Felder. ''GeoBBox'' speichert deshalb ''minX''/''minY''/''maxX''/''maxY'' direkt als ''int64''. ''GeoBBoxGetMin(bb)'' und ''GeoBBoxGetMax(bb)'' bauen daraus einen ''GeoPoint''.
  * **GeoPoint anlegen**: Immer ''GeoPointNew(lon, lat)'' verwenden — keine Struct-Literal-Syntax (''GeoPoint{x:…}'' ist ein Compiler-Fehler). Reihenfolge: **Lon zuerst, dann Lat** (x = Längengrad, y = Breitengrad).
  * **Mikro-Grad-Divisor**: Distanzberechnungen dividieren intern durch ''1.000.000'' (Mikro-Grad → Grad). Ältere Code-Versionen verwendeten fälschlicherweise ''/ 1000'' — das erzeugte Werte um Faktor 1000 zu groß.
  * **CalculateBoundingBox vs. CalculateBoundingBoxMin/Max**: ''CalculateBoundingBox'' gibt eine vollständige ''GeoBBox'' in einem Aufruf zurück; ''CalculateBoundingBoxMin''/''Max'' sind die Einzelfunktionen für Min- bzw. Max-Eckpunkt.