API för flygförbudszoner för drönare: kom igång
Uppdaterad
GeoPilots publika API levererar kartans data om drönarzoner för varje källa vars licens tillåter vidarespridning, som GeoJSON över HTTPS. Skicka din API-nyckel som en bearer-token till /api/v1/public så kan du lista zoner per land eller område, fråga vilka zoner som gäller på en punkt eller inom en radie, kontrollera ett flygområde eller en rutt och konvertera mellan ED-269, ED-318, KML och GeoJSON. API-åtkomst är en separat produkt från kartabonnemangen.
Skaffa en nyckel
- Prenumerera på sidan API-åtkomst – eller, för att prova först eller be om en högre gräns, ansök om åtkomst.
- Öppna fliken API-åtkomst i din profil och skapa en nyckel: ge den ett namn och välj bara de behörigheter den behöver.
- Kopiera nyckeln när den visas. Den visas bara en gång; om du tappar bort den, återkalla den och skapa en ny.
| Behörighet | Tillåter |
|---|---|
RESTRICTIONS_READ | Listning av zoner, punkt- och radiesökningar, en zon via id |
CONFLICT_CHECK | Kontroll av ett område eller en rutt mot aktiva zoner |
CONVERT_ED269 | Konvertering till eller från ED-269 |
CONVERT_ED318 | Konvertering till eller från ED-318 |
CONVERT_KML | Konvertering till eller från KML |
Din första begäran: vad gäller här?
Spara nyckeln i en miljövariabel och fråga efter alla zoner på en punkt:
curl "https://geopilot.space/api/v1/public/restrictions/at?lat=44.43&lon=26.10" \ -H "Authorization: Bearer $GEOPILOT_API_KEY"
Svaret är en GeoJSON FeatureCollection med ett meta-block bredvid. Varje objekt innehåller zonens effect (PROHIBITED, AUTHORIZATION_REQUIRED, COORDINATION_REQUIRED, INFORMATION_ONLY eller UNKNOWN), dess type, om den är activeNow, och id:n för dess källa och myndighet – samma fakta som kartans klickpanel visar.
Endpoints
| Begäran | Returnerar | Behörighet |
|---|---|---|
GET /restrictions | Zoner filtrerade efter land, omgivande rektangel, typ, verkan… | RESTRICTIONS_READ |
GET /restrictions/at | Alla zoner som överlappar på en punkt | RESTRICTIONS_READ |
GET /restrictions/near | Zoner inom en radie, närmaste först | RESTRICTIONS_READ |
GET /restrictions/:id | En zon | RESTRICTIONS_READ |
POST /restrictions/intersect | Vad ett område eller en rutt berör | CONFLICT_CHECK |
POST /convert/:from-:to | Ett dokument i ett annat format | Se konverteringsguiden |
Kontrollera ett flygområde
curl -X POST "https://geopilot.space/api/v1/public/restrictions/intersect" \
-H "Authorization: Bearer $GEOPILOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"geometry":{"type":"Polygon","coordinates":[[[26.05,44.40],[26.15,44.40],[26.15,44.47],[26.05,44.47],[26.05,44.40]]]}}'Svaret listar varje zon som formen berör med dess verkan, om den är aktiv vid den bedömda tidpunkten, intersectionAreaM2 och intersectionRatio (den andel av ditt område som den täcker; null för en rutt), plus en summary med antal per verkan. Ange activeAt för att bedöma en framtida tidpunkt. Precis som kartan listar det utan att dra slutsatser – det finns avsiktligt inget fält för ”tillåtet”.
Fel, gränser och licenser
- 401 – nyckeln saknas, är felformaterad, okänd, återkallad eller har gått ut. 403 – nyckeln är giltig men ägarens API-åtkomst har upphört, eller så saknar den behörigheten som endpointen kräver (svaret anger vilken).
- Varje fel, från varje endpoint, har samma JSON-form: RFC 9457 problem details, med
errorspå fältnivå vid 400 eller 422. - Gränserna räknas per nyckel över en rullande minut – som standard 60 anrop var för läsningar, konfliktkontroller och konverteringar. Varje svar innehåller
X-RateLimit-LimitochX-RateLimit-Remaining; ett 429-svar lägger tillRetry-After. - Läsning av restriktioner returnerar bara data från källor vars licens tillåter kommersiell användning och vidarespridning. En undantagen källa beter sig som om den inte fanns.
Maskinläsbar beskrivning
API:et beskrivs som OpenAPI 3.1, genererad från samma scheman som API:et validerar begäranden med, så att en klientgenerator håller jämna steg med det. En hälsokontroll svarar utan nyckel, och båda listas i en API-katalog enligt RFC 9727:
GET https://geopilot.space/api/v1/public/openapi.json GET https://geopilot.space/api/v1/public/health GET https://geopilot.space/.well-known/api-catalog
API:et rapporterar vad nationella myndigheter publicerar, med datum. Det ger inte tillstånd till någon flygning, och dina användare bör få veta det.
Vanliga frågor
- Finns det en gratisnivå?
- Nej, men du kan ansöka om åtkomst för att prova innan du prenumererar, eller för att be om en anpassad gräns.
- Täcker API:et alla länder på kartan?
- Det täcker de källor vars licens tillåter kommersiell användning och vidarespridning. Zoner från andra källor finns kvar på kartan men levereras inte via API:et.
- Behöver jag ett kartabonnemang också?
- Nej. API-åtkomst faktureras för sig; ett konto behöver bara API-åtkomst för att skapa nycklar.
Relaterade guider
- Så konverterar du geozoner i ED-269 och ED-318 till GeoJSON eller KMLKonvertera geozondata för UAS mellan ED-269, ED-318, KML och GeoJSON med ett API-anrop: behörigheterna, begäran och hur du läser fel och varningar.
- ED-269 och ED-318: de två geozonformaten för UAS, jämförda fält för fältHur formaten ED-269 och ED-318 för geografiska UAS-zoner skiljer sig åt, fält för fält, med fällorna i riktiga nationella flöden och hur du konverterar.
- Flygförbudszoner för drönare: så fungerar geografiska UAS-zonerVad geografiska UAS-zoner är, vem som publicerar dem och hur du läser dem: förbjudna zoner, tillståndszoner, villkorade zoner, höjdgränser och tider.