So wandeln Sie ED-269- und ED-318-Geozonen in GeoJSON oder KML um

Eine Umwandlung braucht den Scope beider Formate: kml-ed318 braucht CONVERT_KML und CONVERT_ED318, während ed269-geojson nur CONVERT_ED269 braucht. GeoJSON braucht keinen. Das ergibt zwölf gerichtete Paare; die API-Referenz listet jedes davon auf.

1. Erstellen Sie einen API-Schlüssel mit den Scopes für Ihre Formate — siehe Erste Schritte mit der API.
2. Senden Sie das Quelldokument per POST als document: das geparste JSON bei ED-269, ED-318 oder GeoJSON, oder den XML-Text als String bei KML.
3. Lesen Sie document aus der Antwort und prüfen Sie dann errors und warnings, bevor Sie das Ergebnis veröffentlichen.

curl -X POST "https://geopilot.space/api/v1/public/convert/ed269-kml" \
  -H "Authorization: Bearer $GEOPILOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{ "document": { "title": "Zones", "features": [ { "identifier": "ROU-001",
  "name": "Example zone", "restriction": "PROHIBITED", "geometry": [ {
  "uomDimensions": "M", "horizontalProjection": { "type": "Polygon",
  "coordinates": [[[26.05,44.40],[26.15,44.40],[26.15,44.47],[26.05,44.47],[26.05,44.40]]] } } ] } ] } }
JSON

{
  "document": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><kml …>…</kml>",
  "totalFeatures": 1,
  "errors": [],
  "warnings": []
}

• totalFeatures — wie viele Features die Quelle enthielt.
• errors — Features, die nicht umgewandelt werden konnten, jeweils mit Index, Kennung und Grund. Der Rest des Dokuments wird trotzdem umgewandelt: Ein fehlerhaftes Feature kostet kein anderes.
• warnings — Stellen, an denen das Zielformat nicht ausdrücken kann, was die Quelle sagte, etwa eine Wirkung, für die ED-269 kein Wort hat, oder ein Höhenbezug, auf den es nicht verweisen kann. Jede Warnung sagt, was stattdessen geschrieben wurde.

Ein Fall lässt stattdessen die ganze Anfrage scheitern: die Umwandlung nach ED-269 eines Dokuments, das Flächen mit Linien oder Punkten mischt, weil eine ED-269-Zone nur Flächen enthalten kann. Sie wird mit einer 400 in der Fehlerform nach RFC 9457 abgelehnt — senden Sie nur die Flächen oder wählen Sie ein anderes Zielformat.

• ED-269 — der EUROCAE-Standard, in dem viele nationale Behörden Zonen veröffentlichen und annehmen.
• ED-318 — sein Nachfolger, eine auf GeoJSON basierende Spezifikation, die nun in nationalen Datenquellen auftaucht.
• KML — für Google Earth und die Karten-Apps von Piloten; die Höhengrenzen einer Zone werden als Höhen übertragen, wo sie vorhanden sind.
• GeoJSON — das neutrale Format für Webkarten und GIS-Pipelines und die Seite, über die jede Umwandlung liest oder schreibt.

Wie sich ED-269 und ED-318 Feld für Feld unterscheiden und welche Fallen in echten nationalen Datenquellen stecken, steht in ED-269 vs. ED-318.

Eine Umwandlung ändert das Format, nicht die Fakten. Sie gleicht die Zonen mit keiner offiziellen Quelle ab, und eine umgewandelte Datei ist nur so aktuell wie die, die Sie gesendet haben.