Como converter zonas geográficas ED-269 e ED-318 para GeoJSON ou KML

Uma conversão precisa do âmbito de ambos os formatos: kml-ed318 precisa de CONVERT_KML e CONVERT_ED318, enquanto ed269-geojson precisa apenas de CONVERT_ED269. O GeoJSON não precisa de nenhum. Isso dá doze pares orientados; a referência da API lista todos.

1. Crie uma chave de API com os âmbitos dos seus formatos — consulte primeiros passos com a API.
2. Envie por POST o documento de origem como document: o JSON interpretado para ED-269, ED-318 ou GeoJSON, ou o texto XML como cadeia para KML.
3. Leia document na resposta e verifique errors e warnings antes de publicar o resultado.

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 — quantos elementos continha a origem.
• errors — os elementos que não foi possível converter, cada um com o índice, o identificador e o motivo. O resto do documento é convertido na mesma: um elemento com problemas não prejudica nenhum outro.
• warnings — os pontos em que o formato de destino não tem forma de dizer o que a origem dizia, como um efeito para o qual o ED-269 não tem termo, ou um datum de altitude que não consegue referenciar. Cada um indica o que foi escrito em seu lugar.

Há um caso que faz falhar todo o pedido: converter para ED-269 um documento que mistura áreas com linhas ou pontos, porque uma zona ED-269 só pode conter áreas. É recusado com um erro 400 na estrutura de erro do RFC 9457 — envie apenas as áreas ou escolha outro formato de destino.

• ED-269 — a norma da EUROCAE em que muitas autoridades nacionais publicam e aceitam zonas.
• ED-318 — o seu sucessor, uma especificação baseada em GeoJSON que começa a surgir nos feeds nacionais.
• KML — para o Google Earth e as aplicações de mapas dos pilotos; os limites de altitude de uma zona são indicados como alturas quando os tem.
• GeoJSON — o formato neutro para mapas web e fluxos de trabalho SIG, e o lado através do qual todas as conversões leem ou escrevem.

Como diferem o ED-269 e o ED-318, campo a campo, e as armadilhas encontradas em feeds nacionais reais, está em ED-269 vs ED-318.

Uma conversão muda o formato, não os factos. Não verifica as zonas face a nenhuma fonte oficial, e um ficheiro convertido só é tão atual quanto o que enviou.