Convertir des géozones ED-269 et ED-318 en GeoJSON ou KML

Une conversion exige la portée de ses deux formats : kml-ed318 demande CONVERT_KML et CONVERT_ED318, tandis que ed269-geojson ne demande que CONVERT_ED269. GeoJSON n’en exige aucune. Cela fait douze paires orientées ; la référence de l’API les liste toutes.

1. Créez une clé API avec les portées de vos formats — voir premiers pas avec l’API.
2. Envoyez en POST le document source dans document : le JSON analysé pour ED-269, ED-318 ou GeoJSON, ou le texte XML sous forme de chaîne pour KML.
3. Lisez document dans la réponse, puis vérifiez errors et warnings avant de publier le résultat.

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 — le nombre d’éléments de la source.
• errors — les éléments qui n’ont pas pu être convertis, chacun avec son index, son identifiant et la raison. Le reste du document est converti malgré tout : un élément défectueux n’en pénalise aucun autre.
• warnings — les endroits où le format cible ne peut pas dire ce que disait la source, comme un effet qu’ED-269 ne sait pas nommer ou une référence d’altitude qu’il ne peut pas indiquer. Chacun précise ce qui a été écrit à la place.

Un seul cas fait échouer toute la requête : convertir vers ED-269 un document qui mêle des surfaces à des lignes ou des points, car une zone ED-269 ne peut contenir que des surfaces. La requête est refusée avec un 400, dans la forme d’erreur RFC 9457 — n’envoyez que les surfaces, ou choisissez un autre format cible.

• ED-269 — la norme EUROCAE dans laquelle de nombreuses autorités nationales publient et acceptent les zones.
• ED-318 — son successeur, une spécification fondée sur GeoJSON qui apparaît dans les flux nationaux.
• KML — pour Google Earth et les applications cartographiques des télépilotes ; les limites d’altitude de la zone sont conservées comme hauteurs quand elle en a.
• GeoJSON — le format neutre des cartes web et des chaînes SIG, par lequel passe chaque conversion.

Les différences entre ED-269 et ED-318, champ par champ, et les pièges rencontrés dans de vrais flux nationaux sont dans ED-269 ou ED-318.

Une conversion change le format, pas les faits. Elle ne vérifie pas les zones auprès d’une source officielle, et un fichier converti n’est pas plus récent que celui envoyé.