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āts | URL | Sūta kā | Tvērums |
|---|---|---|---|
| ED-269 | ed269 | JSON objekts | CONVERT_ED269 |
| ED-318 | ed318 | JSON objekts | CONVERT_ED318 |
| KML | kml | XML teksts kā JSON virkne | CONVERT_KML |
| GeoJSON | geojson | JSON objekts | nav |
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
- Izveidojiet API atslēgu ar jūsu formātiem vajadzīgajiem tvērumiem — skatiet darba sākšana ar API.
- 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. - Nolasiet
documentno atbildes un pirms rezultāta publicēšanas pārbaudieterrorsunwarnings.
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
- ED-269 pret ED-318: abu UAS ģeozonu formātu salīdzinājums lauku pa laukamKā UAS ģeogrāfisko zonu formāti ED-269 un ED-318 atšķiras lauku pa laukam, kādi slazdi atrasti reālās valstu datu plūsmās un kā tos konvertēt.
- Dronu lidojumu aizlieguma zonu API: darba sākšanaVaicājiet publicētās dronu zonas no savas programmatūras: API atslēga, zonas punktā vai tuvumā, lidojuma zonas pārbaude, limiti un kļūdas.
- Dronu lidojumu aizlieguma zonas: kā darbojas UAS ģeogrāfiskās zonasKas ir UAS ģeogrāfiskās zonas, kas tās publicē un kā tās lasīt: aizlieguma, atļaujas un nosacītās zonas, augstuma robežas un darbības laiki.
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