Come convertire le geozone ED-269 ed ED-318 in GeoJSON o KML

Una conversione richiede l’ambito di entrambi i suoi formati: kml-ed318 richiede CONVERT_KML e CONVERT_ED318, mentre ed269-geojson richiede solo CONVERT_ED269. GeoJSON non ne richiede nessuno. In tutto sono dodici coppie orientate; la documentazione dell’API le elenca tutte.

1. Crea una chiave API con gli ambiti dei tuoi formati: vedi primi passi con l’API.
2. Invia con POST il documento di origine come document: il JSON analizzato per ED-269, ED-318 o GeoJSON, oppure il testo XML come stringa per KML.
3. Leggi document dalla risposta, poi controlla errors e warnings prima di pubblicare il risultato.

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: quante feature conteneva l’origine.
• errors: le feature che non è stato possibile convertire, ciascuna con il suo indice, il suo identificatore e il motivo. Il resto del documento viene comunque convertito: una feature errata non compromette le altre.
• warnings: i punti in cui il formato di destinazione non ha modo di esprimere ciò che diceva l’origine, come un effetto per cui ED-269 non ha un termine o un datum altimetrico a cui non può fare riferimento. Ognuno indica cosa è stato scritto al suo posto.

Un solo caso fa invece fallire l’intera richiesta: convertire in ED-269 un documento che mescola aree con linee o punti, perché una zona ED-269 può contenere solo aree. La richiesta viene rifiutata con un 400 nel formato di errore RFC 9457: invia solo le aree, oppure scegli un altro formato di destinazione.

• ED-269: lo standard EUROCAE in cui molte autorità nazionali pubblicano e accettano le zone.
• ED-318: il suo successore, una specifica basata su GeoJSON che sta comparendo nei feed nazionali.
• KML: per Google Earth e le app di mappe dei piloti; i limiti di altitudine di una zona sono riportati come altezze, quando presenti.
• GeoJSON: il formato neutro per mappe web e pipeline GIS, e il lato attraverso cui ogni conversione legge o scrive.

In cosa differiscono ED-269 ed ED-318 campo per campo, e le insidie riscontrate nei feed nazionali reali, lo trovi in ED-269 ed ED-318 a confronto.

Una conversione cambia il formato, non i fatti. Non verifica le zone rispetto ad alcuna fonte ufficiale, e un file convertito è aggiornato quanto quello che hai inviato.