Så konverterar du geozoner i ED-269 och ED-318 till GeoJSON eller KML

En konvertering kräver behörigheten för båda sina format: kml-ed318 kräver CONVERT_KML och CONVERT_ED318, medan ed269-geojson bara kräver CONVERT_ED269. GeoJSON kräver ingen. Det blir tolv riktade par; API-referensen listar vart och ett.

1. Skapa en API-nyckel med behörigheterna för dina format – se kom igång med API:et.
2. Skicka källdokumentet med POST som document: den tolkade JSON:en för ED-269, ED-318 eller GeoJSON, eller XML-texten som en sträng för KML.
3. Läs document i svaret och kontrollera sedan errors och warnings innan du publicerar resultatet.

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 – hur många objekt källan innehöll.
• errors – objekt som inte kunde konverteras, vart och ett med index, identifierare och orsak. Resten av dokumentet konverteras ändå: ett felaktigt objekt påverkar inga andra.
• warnings – ställen där målformatet saknar sätt att uttrycka det som källan angav, till exempel en verkan som ED-269 saknar ord för, eller ett höjddatum som det inte kan referera till. Varje varning anger vad som skrevs i stället.

Ett fall får i stället hela begäran att misslyckas: att konvertera till ED-269 ett dokument som blandar områden med linjer eller punkter, eftersom en ED-269-zon bara kan innehålla områden. Det avvisas med 400 i felformatet enligt RFC 9457 – skicka bara områdena, eller välj ett annat målformat.

• ED-269 – EUROCAE-standarden som många nationella myndigheter publicerar och tar emot zoner i.
• ED-318 – dess efterföljare, en GeoJSON-baserad specifikation som nu dyker upp i nationella dataflöden.
• KML – för Google Earth och piloters kartappar; en zons höjdgränser förs över som höjder där den har sådana.
• GeoJSON – det neutrala formatet för webbkartor och GIS-kedjor, och den sida som varje konvertering läser eller skriver via.

Hur ED-269 och ED-318 skiljer sig åt fält för fält, och fällorna i riktiga nationella dataflöden, finns i ED-269 och ED-318.

En konvertering ändrar formatet, inte fakta. Den kontrollerar inte zonerna mot någon officiell källa, och en konverterad fil är aldrig nyare än den du skickade.