How to convert ED-269 and ED-318 geozones to GeoJSON or KML

A conversion needs the scope of both its formats: kml-ed318 needs CONVERT_KML and CONVERT_ED318, while ed269-geojson needs only CONVERT_ED269. GeoJSON needs none. That makes twelve directed pairs; the API reference lists every one.

1. Create an API key with the scopes for your formats — see getting started with the API.
2. POST the source document as document: the parsed JSON for ED-269, ED-318 or GeoJSON, or the XML text as a string for KML.
3. Read document from the response, then check errors and warnings before you publish the result.

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 — how many features the source held.
• errors — features that could not be converted, each with its index, identifier and reason. The rest of the document still converts: one bad feature costs no other.
• warnings — places where the target format has no way to say what the source said, such as an effect ED-269 has no word for, or an altitude datum it cannot reference. Each says what was written instead.

One case fails the whole request instead: converting to ED-269 a document that mixes areas with lines or points, because an ED-269 zone can only hold areas. It is refused with a 400 in the RFC 9457 error shape — send the areas only, or pick another target format.

• ED-269 — the EUROCAE standard many national authorities publish and accept zones in.
• ED-318 — its successor, a GeoJSON-based specification now appearing in national feeds.
• KML — for Google Earth and pilots’ mapping apps; a zone’s altitude limits are carried as heights where it has them.
• GeoJSON — the neutral format for web maps and GIS pipelines, and the side every conversion reads or writes through.

How ED-269 and ED-318 differ field by field, and the traps found in real national feeds, is in ED-269 vs ED-318.

A conversion changes the format, not the facts. It does not check the zones against any official source, and a converted file is only as current as the one you sent.