Gëtt et eng gratis Versioun?

Neen, mee Dir kënnt Zougang ufroen, fir se virum Abonnéieren ze testen oder fir eng individuell Limitt ze froen.

Deckt d’API all Land op der Kaart of?

Si deckt d’Quellen of, deenen hir Lizenz kommerziell Notzung a Weiderverbreedung erlaabt. Zonen aus anere Quelle bleiwen op der Kaart, ginn awer net iwwer d’API geliwwert.

Brauch ech och en Abonnement fir d’Kaart?

Neen. Den API-Zougang gëtt eegestänneg ofgerechent; e Kont brauch just API-Zougang, fir Schlësselen z’erstellen.

API fir Flichverbuetszone fir Dronen: déi éischt Schrëtt

Aktualiséiert 27. September 2026

Déi ëffentlech GeoPilot-API liwwert d’Dronezonen-Donnéeë vun der Kaart fir all Quell, där hir Lizenz d’Weiderverbreedung erlaabt, als GeoJSON iwwer HTTPS. Schéckt Ären API-Schlëssel als Bearer-Token un /api/v1/public, an Dir kënnt Zonen no Land oder Gebitt oplëschten, froen, wéi eng Zonen op engem Punkt oder an engem Radius gëllen, e Fluchgebitt oder eng Streck kontrolléieren an tëscht ED-269, ED-318, KML a GeoJSON konvertéieren. Den API-Zougang ass e separat Produit vun den Abonnementer fir d’Kaart.

E Schlëssel kréien

Abonnéiert op der Säit API-Zougang — oder, fir se fir d’éischt ze testen oder eng méi héich Limitt unzefroen, frot Zougang un.
Maacht an Ärem Profil den Tab API-Zougang op an erstellt e Schlëssel: gitt him en Numm a wielt nëmmen d’Berechtegungen, déi e brauch.
Kopéiert de Schlëssel, wann en ugewise gëtt. E gëtt genee eng Kéier ugewisen; wann Dir e verléiert, zitt en zréck an erstellt en neien.

Berechtegung	Erlaabt
`RESTRICTIONS_READ`	Zonen oplëschten, Ofroen no Punkt a Radius, eng Zon no ID
`CONFLICT_CHECK`	E Gebitt oder eng Streck mat aktive Zonen vergläichen
`CONVERT_ED269`	Vun oder an ED-269 konvertéieren
`CONVERT_ED318`	Vun oder an ED-318 konvertéieren
`CONVERT_KML`	Vun oder a KML konvertéieren

Är éischt Requête: wat gëllt hei?

Späichert de Schlëssel an enger Ëmfeldvariabel a frot no all Zon op engem Punkt:

curl "https://geopilot.space/api/v1/public/restrictions/at?lat=44.43&lon=26.10" \
  -H "Authorization: Bearer $GEOPILOT_API_KEY"

D’Äntwert ass eng GeoJSON-FeatureCollection mat engem meta-Block dernieft. All Feature dréit d’effect vun der Zon (PROHIBITED, AUTHORIZATION_REQUIRED, COORDINATION_REQUIRED, INFORMATION_ONLY oder UNKNOWN), hiren type, ob se activeNow ass, an d’IDe vun hirer Quell an hirer Behörd — déi selwecht Fakten, déi d’Klick-Panel vun der Kaart weist.

D’Endpunkten

Requête	Gëtt zréck	Berechtegung
`GET /restrictions`	Zonen, gefiltert no Land, Bounding Box, Typ, Wierkung…	`RESTRICTIONS_READ`
`GET /restrictions/at`	All Zonen, déi op engem Punkt openeen leien	`RESTRICTIONS_READ`
`GET /restrictions/near`	Zonen an engem Radius, déi noosten als éischt	`RESTRICTIONS_READ`
`GET /restrictions/:id`	Eng Zon	`RESTRICTIONS_READ`
`POST /restrictions/intersect`	Wat e Gebitt oder eng Streck beréiert	`CONFLICT_CHECK`
`POST /convert/:from-:to`	E Dokument an engem anere Format	Kuckt de Guide zur Konversioun

E Fluchgebitt kontrolléieren

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]]]}}'

D’Äntwert lëscht all Zon op, déi d’Form beréiert, mat hirer Wierkung, ob se zum bewäerten Zäitpunkt aktiv ass, intersectionAreaM2 an intersectionRatio (den Undeel vun Ärem Gebitt, deen se ofdeckt; null bei enger Streck), plus e summary mat den Zuele pro Wierkung. Gitt activeAt mat, fir en Zäitpunkt an der Zukunft ze bewäerten. Wéi d’Kaart lëscht se op a concluéiert näischt — et gëtt bewosst kee Feld „erlaabt“.

Feeler, Limitten a Lizenzen

401 — de Schlëssel feelt, ass falsch geformt, onbekannt, zréckgezunn oder ofgelaf. 403 — de Schlëssel ass gëlteg, mee säi Besëtzer huet keen API-Zougang méi, oder him feelt d’Berechtegung, déi den Endpunkt brauch (d’Äntwert nennt se).
All Feeler, vun all Endpunkt, huet eng eenzeg JSON-Form: RFC 9457 problem details, mat errors op Feldniveau bei engem 400 oder 422.
D’Limitte gi pro Schlëssel iwwer eng gläitend Minutt gezielt — standardméisseg 60 Requêten all fir Liesen, Konfliktkontrollen a Konversiounen. All Äntwert dréit X-RateLimit-Limit an X-RateLimit-Remaining; eng 429 setzt Retry-After dobäi.
Restriktiounsofroe ginn nëmmen Donnéeën aus Quellen zréck, deenen hir Lizenz kommerziell Notzung a Weiderverbreedung erlaabt. Eng ausgeschlosse Quell verhält sech, wéi wann et se net géif ginn.

Maschinnliesbar Beschreiwung

D’API ass als OpenAPI 3.1 beschriwwen, generéiert aus deene selwechte Schemaen, mat deenen d’API d’Requêten validéiert, esou datt e Client-Generator mat hir am Takt bleift. E Health-Check äntwert ouni Schlëssel, a béid sinn an engem API-Katalog no RFC 9727 opgelëscht:

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

D’API mellt, wat national Behörde publizéieren, mat Datumen. Si erlaabt keen Fluch, an Är Benotzer sollten dat gesot kréien.

Heefeg gestallte Froen

Gëtt et eng gratis Versioun?: Neen, mee Dir kënnt Zougang ufroen, fir se virum Abonnéieren ze testen oder fir eng individuell Limitt ze froen.
Deckt d’API all Land op der Kaart of?: Si deckt d’Quellen of, deenen hir Lizenz kommerziell Notzung a Weiderverbreedung erlaabt. Zonen aus anere Quelle bleiwen op der Kaart, ginn awer net iwwer d’API geliwwert.
Brauch ech och en Abonnement fir d’Kaart?: Neen. Den API-Zougang gëtt eegestänneg ofgerechent; e Kont brauch just API-Zougang, fir Schlësselen z’erstellen.

D’API-Referenz liesen