Hoppa till huvudinnehållet
GeoPilot

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

  1. Prenumerera på sidan API-åtkomst – eller, för att prova först eller be om en högre gräns, ansök om åtkomst.
  2. Ö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.
  3. Kopiera nyckeln när den visas. Den visas bara en gång; om du tappar bort den, återkalla den och skapa en ny.
BehörighetTillåter
RESTRICTIONS_READListning av zoner, punkt- och radiesökningar, en zon via id
CONFLICT_CHECKKontroll av ett område eller en rutt mot aktiva zoner
CONVERT_ED269Konvertering till eller från ED-269
CONVERT_ED318Konvertering till eller från ED-318
CONVERT_KMLKonvertering 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äranReturnerarBehörighet
GET /restrictionsZoner filtrerade efter land, omgivande rektangel, typ, verkan…RESTRICTIONS_READ
GET /restrictions/atAlla zoner som överlappar på en punktRESTRICTIONS_READ
GET /restrictions/nearZoner inom en radie, närmaste förstRESTRICTIONS_READ
GET /restrictions/:idEn zonRESTRICTIONS_READ
POST /restrictions/intersectVad ett område eller en rutt berörCONFLICT_CHECK
POST /convert/:from-:toEtt dokument i ett annat formatSe 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 errors på 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-Limit och X-RateLimit-Remaining; ett 429-svar lägger till Retry-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

Källor

GeoPilot

Ett oberoende planeringsverktyg för drönare, byggt på de luftrumsrestriktioner som nationella myndigheter publicerar, för de europeiska länder som täcks och för USA.

Data

  • Luftrumsdata publiceras av de nationella myndigheterna i varje land som omfattas. GeoPilot är inte knutet till eller godkänt av någon av dem.
  • Visa källor och aktualitet

GeoPilot är ett oberoende planeringsverktyg och är inte knutet till eller godkänt av någon luftfartsmyndighet. Det visar data som publiceras av nationella myndigheter, vilka kan vara ofullständiga, inaktuella eller förenklade i bearbetningen, och det ger inte tillstånd till någon flygning. Kontrollera alltid myndighetens egen publikation och gällande NOTAM innan du flyger.