Cum convertești zonele ED-269 și ED-318 în GeoJSON sau KML

O conversie cere scopul ambelor formate: kml-ed318 cere CONVERT_KML și CONVERT_ED318, iar ed269-geojson doar CONVERT_ED269. GeoJSON nu cere niciunul. Rezultă douăsprezece perechi orientate; referința API le listează pe toate.

1. Creează o cheie API cu scopurile formatelor tale — vezi primii pași cu API-ul.
2. Trimite prin POST documentul sursă ca document: JSON-ul parsat pentru ED-269, ED-318 sau GeoJSON, ori textul XML ca șir pentru KML.
3. Citește document din răspuns, apoi verifică errors și warnings înainte să publici rezultatul.

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 — câte elemente avea sursa.
• errors — elementele care nu au putut fi convertite, fiecare cu indexul, identificatorul și motivul. Restul documentului se convertește oricum: un element greșit nu le afectează pe celelalte.
• warnings — locurile unde formatul țintă nu poate spune ce spunea sursa, de exemplu un efect pentru care ED-269 nu are termen sau un sistem de altitudine pe care nu-l poate indica. Fiecare spune ce s-a scris în loc.

Un singur caz face să eșueze toată cererea: conversia în ED-269 a unui document care amestecă zone cu linii sau puncte, pentru că o zonă ED-269 poate conține doar suprafețe. Cererea e refuzată cu 400, în forma de eroare RFC 9457 — trimite doar suprafețele sau alege alt format țintă.

• ED-269 — standardul EUROCAE în care multe autorități naționale publică și acceptă zone.
• ED-318 — succesorul lui, o specificație bazată pe GeoJSON care apare acum în fluxurile naționale.
• KML — pentru Google Earth și aplicațiile de hărți ale piloților; limitele de altitudine ale zonei sunt păstrate ca înălțimi acolo unde există.
• GeoJSON — formatul neutru pentru hărți web și fluxuri GIS, prin care trece fiecare conversie.

Cum diferă ED-269 și ED-318 câmp cu câmp și capcanele găsite în fluxurile naționale reale sunt în ED-269 vs ED-318.

O conversie schimbă formatul, nu faptele. Nu verifică zonele față de vreo sursă oficială, iar un fișier convertit e la fel de actual ca cel trimis.