Näin muunnat ED-269- ja ED-318-geovyöhykkeet GeoJSON- tai KML-muotoon

Muunnos tarvitsee molempien muotojensa käyttöoikeuden: kml-ed318 tarvitsee oikeudet CONVERT_KML ja CONVERT_ED318, kun taas ed269-geojson tarvitsee vain oikeuden CONVERT_ED269. GeoJSON ei tarvitse mitään. Suunnattuja pareja on siis kaksitoista; API-dokumentaatio luettelee ne kaikki.

1. Luo API-avain muotojesi käyttöoikeuksilla – katso API:n käytön aloittaminen.
2. Lähetä lähdeasiakirja POST-pyynnöllä kentässä document: jäsennetty JSON ED-269:lle, ED-318:lle tai GeoJSONille, tai XML-teksti merkkijonona KML:lle.
3. Lue vastauksesta document ja tarkista errors ja warnings ennen kuin julkaiset tuloksen.

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 – kuinka monta piirrettä lähteessä oli.
• errors – piirteet, joita ei voitu muuntaa, kukin indekseineen, tunnisteineen ja syineen. Muu asiakirja muunnetaan silti: yksi virheellinen piirre ei maksa muita.
• warnings – kohdat, joissa kohdemuodolla ei ole keinoa ilmaista sitä, mitä lähde sanoi, kuten vaikutus, jolle ED-269:ssä ei ole sanaa, tai korkeusdatumi, johon se ei voi viitata. Kukin kertoo, mitä kirjoitettiin sen sijaan.

Yksi tapaus hylkää koko pyynnön: sellaisen asiakirjan muuntaminen ED-269-muotoon, jossa alueita on sekaisin viivojen tai pisteiden kanssa, koska ED-269-vyöhyke voi sisältää vain alueita. Pyyntö hylätään 400-vastauksella RFC 9457 -virhemuodossa – lähetä vain alueet tai valitse toinen kohdemuoto.

• ED-269 – EUROCAE-standardi, jossa monet kansalliset viranomaiset julkaisevat ja vastaanottavat vyöhykkeitä.
• ED-318 – sen seuraaja, GeoJSON-pohjainen määrittely, joka on nyt ilmestymässä kansallisiin syötteisiin.
• KML – Google Earthia ja lennättäjien karttasovelluksia varten; vyöhykkeen korkeusrajat välitetään korkeuksina, jos niitä on.
• GeoJSON – neutraali muoto verkkokartoille ja paikkatietoputkille, ja puoli, jonka kautta jokainen muunnos lukee tai kirjoittaa.

Miten ED-269 ja ED-318 eroavat kenttä kentältä ja mitä sudenkuoppia todellisista kansallisista syötteistä on löytynyt, kerrotaan oppaassa ED-269 vs ED-318.

Muunnos muuttaa muodon, ei tosiasioita. Se ei vertaa vyöhykkeitä mihinkään viralliseen lähteeseen, ja muunnettu tiedosto on vain yhtä tuore kuin lähettämäsi tiedosto.