Ei, mutta voit hakea käyttöoikeutta kokeillaksesi ennen tilaamista tai pyytääksesi räätälöityä rajaa.

Kattaako API kaikki kartan maat?

Se kattaa lähteet, joiden lisenssi sallii kaupallisen käytön ja edelleenjakelun. Muiden lähteiden vyöhykkeet pysyvät kartalla, mutta niitä ei tarjota API:n kautta.

Tarvitsenko myös karttatilauksen?

Et. API-käyttö laskutetaan erikseen; tili tarvitsee vain API-käyttöoikeuden avainten luomiseen.

Droonien lentokieltoalueiden API: aloitus

Päivitetty 27. syyskuuta 2026

GeoPilotin julkinen API tarjoaa kartan droonivyöhyketiedot jokaisesta lähteestä, jonka lisenssi sallii edelleenjakelun, GeoJSON-muodossa HTTPS:n yli. Lähetä API-avaimesi bearer-tunnisteena osoitteeseen /api/v1/public, niin voit listata vyöhykkeitä maan tai alueen mukaan, kysyä, mitkä vyöhykkeet koskevat pistettä tai sädettä, tarkistaa lentoalueen tai reitin ja muuntaa ED-269-, ED-318-, KML- ja GeoJSON-muotojen välillä. API-käyttö on karttatilauksista erillinen tuote.

Hanki avain

Tilaa API-käyttö-sivulla – tai jos haluat kokeilla ensin tai pyytää korkeampaa rajaa, hae käyttöoikeutta.
Avaa profiilissasi API-käyttö-välilehti ja luo avain: anna sille nimi ja valitse vain sen tarvitsemat käyttöoikeudet.
Kopioi avain, kun se näytetään. Se näytetään vain kerran; jos kadotat sen, mitätöi se ja luo uusi.

Käyttöoikeus	Sallii
`RESTRICTIONS_READ`	Vyöhykkeiden listaus, piste- ja sädehaut, yksi vyöhyke tunnisteella
`CONFLICT_CHECK`	Alueen tai reitin vertaaminen voimassa oleviin vyöhykkeisiin
`CONVERT_ED269`	Muuntaminen ED-269-muotoon tai siitä
`CONVERT_ED318`	Muuntaminen ED-318-muotoon tai siitä
`CONVERT_KML`	Muuntaminen KML-muotoon tai siitä

Ensimmäinen pyyntösi: mikä täällä pätee?

Säilytä avain ympäristömuuttujassa ja kysy kaikki pisteen vyöhykkeet:

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

Vastaus on GeoJSON FeatureCollection, jonka rinnalla on meta-lohko. Jokainen piirre sisältää vyöhykkeen vaikutuksen effect (PROHIBITED, AUTHORIZATION_REQUIRED, COORDINATION_REQUIRED, INFORMATION_ONLY tai UNKNOWN), sen tyypin type, tiedon siitä, onko se voimassa (activeNow), sekä sen lähteen ja viranomaisen tunnisteet – samat tiedot, jotka kartan napsautuspaneeli näyttää.

Päätepisteet

Pyyntö	Palauttaa	Käyttöoikeus
`GET /restrictions`	Vyöhykkeet suodatettuina maan, rajauslaatikon, tyypin, vaikutuksen… mukaan	`RESTRICTIONS_READ`
`GET /restrictions/at`	Kaikki yhteen pisteeseen pinoutuvat vyöhykkeet	`RESTRICTIONS_READ`
`GET /restrictions/near`	Vyöhykkeet säteen sisällä, lähin ensin	`RESTRICTIONS_READ`
`GET /restrictions/:id`	Yksi vyöhyke	`RESTRICTIONS_READ`
`POST /restrictions/intersect`	Mihin alue tai reitti osuu	`CONFLICT_CHECK`
`POST /convert/:from-:to`	Asiakirja toisessa muodossa	Katso muunnosopas

Tarkista lentoalue

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

Vastaus luettelee jokaisen vyöhykkeen, johon muoto osuu, vaikutuksineen, tiedon siitä, onko se voimassa arvioituna aikana, intersectionAreaM2- ja intersectionRatio-arvot (osuus alueestasi, jonka se kattaa; reitillä null) sekä yhteenvedon summary lukumääristä vaikutuksittain. Anna activeAt arvioidaksesi tulevan ajankohdan. Kuten kartta, se luettelee eikä tee johtopäätöksiä – ”sallittu”-kenttää ei ole, tarkoituksella.

Virheet, rajat ja lisensointi

401 – avain puuttuu tai on virheellisesti muodostettu, tuntematon, mitätöity tai vanhentunut. 403 – avain on kelvollinen, mutta sen omistajan API-käyttöoikeus on päättynyt, tai siltä puuttuu päätepisteen edellyttämä käyttöoikeus (vastaus nimeää sen).
Jokainen virhe jokaisesta päätepisteestä on samaa JSON-muotoa: RFC 9457 problem details, ja 400- tai 422-vastauksessa kenttäkohtaiset errors.
Rajat lasketaan avainkohtaisesti liukuvan minuutin aikana – oletuksena 60 pyyntöä kullekin: luvuille, ristiriitatarkistuksille ja muunnoksille. Jokainen vastaus sisältää otsakkeet X-RateLimit-Limit ja X-RateLimit-Remaining; 429-vastaus lisää otsakkeen Retry-After.
Rajoitusten luku palauttaa tietoja vain lähteistä, joiden lisenssi sallii kaupallisen käytön ja edelleenjakelun. Pois suljettu lähde käyttäytyy kuin sitä ei olisi olemassa.

Koneluettava kuvaus

API on kuvattu OpenAPI 3.1 -muodossa, generoituna samoista skeemoista, joilla API validoi pyynnöt, joten asiakasgeneraattori pysyy sen kanssa yhdenmukaisena. Terveystarkistus vastaa ilman avainta, ja molemmat on listattu RFC 9727 -API-luettelossa:

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 raportoi kansallisten viranomaisten julkaisemat tiedot päivämäärineen. Se ei anna lupaa lentoon, ja tästä on kerrottava käyttäjillesi.

Usein kysytyt kysymykset

Onko ilmaista tasoa?: Ei, mutta voit hakea käyttöoikeutta kokeillaksesi ennen tilaamista tai pyytääksesi räätälöityä rajaa.
Kattaako API kaikki kartan maat?: Se kattaa lähteet, joiden lisenssi sallii kaupallisen käytön ja edelleenjakelun. Muiden lähteiden vyöhykkeet pysyvät kartalla, mutta niitä ei tarjota API:n kautta.
Tarvitsenko myös karttatilauksen?: Et. API-käyttö laskutetaan erikseen; tili tarvitsee vain API-käyttöoikeuden avainten luomiseen.

Lue API-dokumentaatio