Pāriet uz galveno saturu
GeoPilot

Kā konvertēt ED-269 un ED-318 ģeozonas uz GeoJSON vai KML

Atjaunināts

UAS ģeogrāfiskās zonas tiek publicētas ED-269 vai ED-318 formātā, bet tīmekļa kartēm vajag GeoJSON, un Google Earth vajag KML. GeoPilot API konvertē starp visiem četriem formātiem jebkurā virzienā ar vienu izsaukumu: POST /api/v1/public/convert/:from-:to, sūtot avota dokumentu laukā document. Atbildē ir konvertētais dokuments, kā arī saraksts ar objektiem, kurus neizdevās konvertēt, un brīdinājumi par visu, ko mērķa formāts nespēj izteikt.

Formāti un tvērumi

FormātsURLSūta kāTvērums
ED-269ed269JSON objektsCONVERT_ED269
ED-318ed318JSON objektsCONVERT_ED318
KMLkmlXML teksts kā JSON virkneCONVERT_KML
GeoJSONgeojsonJSON objektsnav

Konvertēšanai vajadzīgs abu tās formātu tvērums: kml-ed318 vajadzīgi CONVERT_KML un CONVERT_ED318, bet ed269-geojson vajadzīgs tikai CONVERT_ED269. GeoJSON neprasa nevienu. Kopā tas dod divpadsmit virzītus pārus; API dokumentācijā ir uzskaitīti visi.

Konvertējiet trīs soļos

  1. Izveidojiet API atslēgu ar jūsu formātiem vajadzīgajiem tvērumiem — skatiet darba sākšana ar API.
  2. Nosūtiet ar POST avota dokumentu kā document: parsētu JSON formātiem ED-269, ED-318 vai GeoJSON vai XML tekstu kā virkni formātam KML.
  3. Nolasiet document no atbildes un pirms rezultāta publicēšanas pārbaudiet errors un warnings.
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": []
}

Kā lasīt kļūdas un brīdinājumus

  • totalFeatures — cik objektu bija avotā.
  • errors — objekti, kurus neizdevās konvertēt, katrs ar savu indeksu, identifikatoru un iemeslu. Pārējā dokumenta daļa tiek konvertēta: viens kļūdains objekts neietekmē pārējos.
  • warnings — vietas, kur mērķa formātā nav iespējams izteikt to, ko teica avots, piemēram, iedarbību, kurai ED-269 nav apzīmējuma, vai augstuma atskaites sistēmu, uz kuru tas nevar atsaukties. Katrā norādīts, kas ierakstīts tās vietā.

Viens gadījums tā vietā liek neizdoties visam pieprasījumam: konvertēšana uz ED-269 dokumentam, kurā jaukti laukumi ar līnijām vai punktiem, jo ED-269 zonā var būt tikai laukumi. Tas tiek noraidīts ar kodu 400 RFC 9457 kļūdas formā — sūtiet tikai laukumus vai izvēlieties citu mērķa formātu.

Kurš formāts kuram darbam

  • ED-269 — EUROCAE standarts, kurā daudzas valstu iestādes publicē un pieņem zonas.
  • ED-318 — tā pēctecis, uz GeoJSON balstīta specifikācija, kas tagad parādās valstu datu plūsmās.
  • KML — Google Earth un pilotu karšu lietotnēm; zonas augstuma robežas, ja tādas ir, tiek pārnestas kā augstumi.
  • GeoJSON — neitrālais formāts tīmekļa kartēm un GIS apstrādes plūsmām, un puse, caur kuru katra konvertēšana lasa vai raksta.

Kā ED-269 un ED-318 atšķiras lauku pa laukam un kādi slazdi atrasti reālās valstu datu plūsmās, skatiet ceļvedī ED-269 pret ED-318.

Konvertēšana maina formātu, nevis faktus. Tā nepārbauda zonas pret nevienu oficiālu avotu, un konvertētais fails ir tikai tik aktuāls, cik aktuāls ir jūsu nosūtītais.

Biežāk uzdotie jautājumi

Vai varu konvertēt bez API atslēgas?
Nē. Katrai konvertēšanai vajadzīga atslēga ar abu formātu tvērumiem.
Kāpēc kāds objekts manā rezultātā trūkst?
Skatiet errors: tur uzskaitīts katrs objekts, kuru neizdevās konvertēt, un iemesls, kamēr pārējie tika konvertēti normāli.
Vai starp formātiem kaut kas tiek zaudēts?
Dažreiz — katrs formāts var izteikt lietas, ko citi nevar. Katrs šāds gadījums tiek paziņots warnings, norādot, kas ierakstīts tā vietā.

Saistītie ceļveži

Avoti

  • EUROCAE ED-269 — Minimum Operational Standard for UAS Geographical Zones
  • EUROCAE ED-318 — Technical Specification for UAS Geographical Zone Data
  • The KML reference (Open Geospatial Consortium, KML 2.2)
  • RFC 7946 — The GeoJSON Format
GeoPilot

Neatkarīgs dronu lidojumu plānošanas rīks, kas balstīts uz gaisa telpas ierobežojumiem, ko publicē valstu iestādes, — aptvertajām Eiropas valstīm un Amerikas Savienotajām Valstīm.

Dati

  • Gaisa telpas datus publicē katras aptvertās valsts iestādes. GeoPilot nav saistīts ne ar vienu no tām, un neviena no tām to nav apstiprinājusi.
  • Skatīt avotus un aktualitāti

Juridiskā informācija

GeoPilot ir neatkarīgs plānošanas rīks, un tas nav saistīts ne ar vienu aviācijas iestādi, nedz arī kāda aviācijas iestāde to ir apstiprinājusi. Tas rāda valstu iestāžu publicētus datus, kas var būt nepilnīgi, novecojuši vai apstrādē vienkāršoti, un tas neatļauj nevienu lidojumu. Pirms lidojuma vienmēr pārbaudiet pašas iestādes publikāciju un spēkā esošos NOTAM.