Vai ir bezmaksas līmenis?

Nē, taču varat pieteikties piekļuvei, lai to izmēģinātu pirms abonēšanas vai lūgtu individuālu limitu.

Vai API aptver katru kartē esošo valsti?

Tas aptver avotus, kuru licence atļauj komerciālu izmantošanu un tālākizplatīšanu. Citu avotu zonas paliek kartē, bet netiek nodrošinātas caur API.

Vai man vajadzīgs arī kartes plāns?

Nē. Par API piekļuvi norēķinās atsevišķi; lai izveidotu atslēgas, kontam vajadzīga tikai API piekļuve.

Dronu lidojumu aizlieguma zonu API: darba sākšana

Atjaunināts 2026. gada 27. septembris

GeoPilot publiskais API nodrošina kartes dronu zonu datus par katru avotu, kura licence atļauj tālākizplatīšanu, GeoJSON formātā caur HTTPS. Nosūtiet savu API atslēgu kā bearer pilnvaru uz /api/v1/public, un jūs varat iegūt zonu sarakstu pēc valsts vai teritorijas, uzzināt, kuras zonas ir spēkā punktā vai rādiusā, pārbaudīt lidojuma zonu vai maršrutu un konvertēt starp ED-269, ED-318, KML un GeoJSON. API piekļuve ir atsevišķs produkts, kas nav daļa no kartes plāniem.

Iegūstiet atslēgu

Abonējiet lapā API piekļuve — vai, lai vispirms izmēģinātu vai lūgtu augstāku limitu, piesakieties piekļuvei.
Profilā atveriet cilni API piekļuve un izveidojiet atslēgu: dodiet tai nosaukumu un izvēlieties tikai tai vajadzīgos tvērumus.
Nokopējiet atslēgu, kad tā tiek parādīta. Tā tiek parādīta tikai vienu reizi; ja to pazaudējat, atsauciet to un izveidojiet citu.

Tvērums	Atļauj
`RESTRICTIONS_READ`	Zonu sarakstu, punkta un rādiusa vaicājumus, vienu zonu pēc id
`CONFLICT_CHECK`	Zonas vai maršruta pārbaudi pret aktīvajām zonām
`CONVERT_ED269`	Konvertēšanu uz ED-269 vai no tā
`CONVERT_ED318`	Konvertēšanu uz ED-318 vai no tā
`CONVERT_KML`	Konvertēšanu uz KML vai no tā

Jūsu pirmais pieprasījums: kas šeit ir spēkā?

Glabājiet atslēgu vides mainīgajā un pieprasiet visas zonas punktā:

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

Atbilde ir GeoJSON FeatureCollection ar blakus esošu meta bloku. Katrā objektā ir zonas effect (PROHIBITED, AUTHORIZATION_REQUIRED, COORDINATION_REQUIRED, INFORMATION_ONLY vai UNKNOWN), tās type, vai tā ir activeNow, kā arī tās avota un iestādes id — tie paši fakti, ko rāda kartes klikšķa panelis.

Galapunkti

Pieprasījums	Atgriež	Tvērums
`GET /restrictions`	Zonas, filtrētas pēc valsts, ierobežojošā taisnstūra, veida, iedarbības…	`RESTRICTIONS_READ`
`GET /restrictions/at`	Visas zonas, kas pārklājas vienā punktā	`RESTRICTIONS_READ`
`GET /restrictions/near`	Zonas rādiusā, sākot ar tuvāko	`RESTRICTIONS_READ`
`GET /restrictions/:id`	Vienu zonu	`RESTRICTIONS_READ`
`POST /restrictions/intersect`	Ar ko saskaras zona vai maršruts	`CONFLICT_CHECK`
`POST /convert/:from-:to`	Dokumentu citā formātā	Skatiet konvertēšanas ceļvedi

Pārbaudiet lidojuma zonu

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

Atbildē uzskaitīta katra zona, ar ko saskaras forma, ar tās iedarbību, vai tā ir aktīva novērtētajā laikā, intersectionAreaM2 un intersectionRatio (jūsu zonas daļa, ko tā aptver; maršrutam null), kā arī summary ar skaitu pēc iedarbības. Nosūtiet activeAt, lai novērtētu nākotnes laiku. Tāpat kā karte, tas uzskaita, nevis secina — lauka “atļauts” apzināti nav.

Kļūdas, limiti un licencēšana

401 — atslēga trūkst, ir nepareizi veidota, nezināma, atsaukta vai beigusies. 403 — atslēga ir derīga, bet tās īpašnieka API piekļuve ir beigusies, vai tai nav galapunkta prasītā tvēruma (atbildē tas nosaukts).
Katra kļūda no jebkura galapunkta ir vienādas JSON formas: RFC 9457 problem details, ar lauku līmeņa errors atbildē 400 vai 422.
Limiti tiek skaitīti katrai atslēgai slīdošā minūtē — pēc noklusējuma 60 pieprasījumu gan lasīšanai, gan konfliktu pārbaudēm, gan konvertēšanai. Katrā atbildē ir X-RateLimit-Limit un X-RateLimit-Remaining; atbilde 429 pievieno Retry-After.
Ierobežojumu lasīšana atgriež datus tikai no avotiem, kuru licence atļauj komerciālu izmantošanu un tālākizplatīšanu. Izslēgts avots darbojas tā, it kā tas nepastāvētu.

Mašīnlasāms apraksts

API ir aprakstīts OpenAPI 3.1 formātā, kas ģenerēts no tām pašām shēmām, ar kurām API validē pieprasījumus, tāpēc klientu ģenerators paliek ar to saskaņā. Darbspējas pārbaude atbild bez atslēgas, un abi ir iekļauti RFC 9727 API katalogā:

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 ziņo, ko publicē valstu iestādes, ar datumiem. Tas neatļauj lidojumu, un jūsu lietotājiem tas būtu jāpasaka.

Biežāk uzdotie jautājumi

Vai ir bezmaksas līmenis?: Nē, taču varat pieteikties piekļuvei, lai to izmēģinātu pirms abonēšanas vai lūgtu individuālu limitu.
Vai API aptver katru kartē esošo valsti?: Tas aptver avotus, kuru licence atļauj komerciālu izmantošanu un tālākizplatīšanu. Citu avotu zonas paliek kartē, bet netiek nodrošinātas caur API.
Vai man vajadzīgs arī kartes plāns?: Nē. Par API piekļuvi norēķinās atsevišķi; lai izveidotu atslēgas, kontam vajadzīga tikai API piekļuve.

Lasīt API dokumentāciju