oneapi
Autentificare
Utile v1 / Aeroporturi

Aeroporturi în apropiere

Cele mai apropiate aeroporture de un punct, cu distanţa până la fiecare. Cu raza_km se restrânge căutarea.

GET
https://oneapi.ro/api/utile/v1/aeroporturi/aproape

Parametri de interogare

NumeTipDescriereValori acceptate
latobligatoriu number OBLIGATORIU. Latitudinea punctului. -90 – 90
lngobligatoriu number OBLIGATORIU. Longitudinea punctului. -180 – 180
raza_kmopțional number | null Raza de căutare în km (implicit 150, maxim 2000). 1 – 2000
limitaopțional integer | null Câte rezultate (implicit 10, maxim 50). 1 – 50
tipopțional string | null Restrânge la o categorie de aerodrom. large_airportmedium_airportsmall_airportheliportseaplane_baseballoonportclosed
cu_iataopțional boolean | null 1 păstrează doar cele cu cod IATA. ex. 1

Cum se comportă

  • Fără cu_iata=1, lista include heliporturi și aerodromuri private, care sunt adesea mai apropiate decât aeroportul care îți folosește. Aproape întotdeauna vrei filtrul.
  • Distanța e în linie dreaptă de la punct la aeroport, nu timp de drum. Un aeroport la 40 km peste munte poate fi mai departe, practic, decât unul la 90 km pe autostradă.
  • Aeroporturile fără coordonate în sursă nu apar niciodată aici. Sunt puține și, în general, aerodromuri închise.

La ce folosește

  • Afli care e cel mai apropiat aeroport comercial de o adresă de livrare.
  • Compari două-trei aeroporturi din jurul unei destinații, ca să alegi ruta.
  • Verifici dacă o zonă are deloc acces aerian în raza pe care o accepți.

Structura răspunsului

CâmpTipDescriere
data.punct object Punctul cerut.
data.punct.lat number Latitudinea, în grade zecimale (WGS 84).
data.punct.lng number Longitudinea, în grade zecimale (WGS 84).
data.raza_km integer Raza efectiv folosită.
data.inregistrari integer Câte înregistrări are răspunsul.
data.aeroporturi[].ident string Identificatorul OurAirports — singurul garantat unic.
data.aeroporturi[].iata string Codul IATA de trei litere, sau null.
data.aeroporturi[].icao string Codul ICAO de patru litere, sau null.
data.aeroporturi[].nume string Numele, aşa cum îl publică sursa.
data.aeroporturi[].tip string Categoria aerodromului.
data.aeroporturi[].municipiu string Municipiul deservit.
data.aeroporturi[].tara.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.aeroporturi[].tara.nume string Numele, aşa cum îl publică sursa.
data.aeroporturi[].regiune.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data.aeroporturi[].regiune.nume string Numele, aşa cum îl publică sursa.
data.aeroporturi[].continent string Continentul pe care se află.
data.aeroporturi[].latitudine number Latitudinea, în grade zecimale (WGS 84).
data.aeroporturi[].longitudine number Longitudinea, în grade zecimale (WGS 84).
data.aeroporturi[].altitudine_ft integer Altitudinea în picioare, cum o publică sursa.
data.aeroporturi[].altitudine_m integer Aceeași altitudine convertită în metri, ca să n-o convertești tu.
data.aeroporturi[].curse_regulate boolean Dacă sursa declară curse regulate.
data.aeroporturi[].wikipedia string Adresa articolului de Wikipedia.
data.aeroporturi[].site string Adresa sitului oficial.
data.aeroporturi[].distanta_km number Distanța ortodromică de la punct, rotunjită la 0,1 km.
data.observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.
data.sursa.nume string Denumirea sursei oficiale.
data.sursa.url string Adresa publică a sursei.
data.sursa.licenta string Licenţa sub care sursa permite reutilizarea.
meta.distanta.metoda string Mereu linie_dreapta: distanţa geodezică pe suprafaţa Pământului, nu pe drum.
meta.distanta.detaliu string Aceeaşi informaţie, în cuvinte.

Exemple de răspuns

GEThttps://oneapi.ro/api/utile/v1/aeroporturi/aproape?lat=46.77&lng=23.59&cu_iata=1&limita=3
{
    "data": {
        "punct": {
            "lat": 46.77,
            "lng": 23.59
        },
        "raza_km": 150,
        "inregistrari": 3,
        "aeroporturi": [
            {
                "ident": "LRCL",
                "iata": "CLJ",
                "icao": "LRCL",
                "nume": "Avram Iancu Cluj International Airport",
                "tip": "large_airport",
                "municipiu": "Cluj-Napoca",
                "tara": {
                    "cod": "RO",
                    "nume": "România"
                },
                "regiune": {
                    "cod": "RO-CJ",
                    "nume": "Cluj County"
                },
                "continent": "EU",
                "latitudine": 46.786042,
                "longitudine": 23.685733,
                "altitudine_ft": 1039,
                "altitudine_m": 317,
                "curse_regulate": true,
                "wikipedia": "https://en.wikipedia.org/wiki/Cluj_International_Airport",
                "site": "http://www.airportcluj.ro/",
                "distanta_km": 7.5
            }
        ],
        "observatie": "Distanța e în linie dreaptă de la punct la aeroport, nu timp de drum. Fără `cu_iata=1`, lista include heliporturi și aerodromuri private, care sunt adesea mai apropiate decât aeroportul util.",
        "sursa": {
            "nume": "OurAirports — export public zilnic",
            "url": "https://ourairports.com/data/",
            "licenta": "Domeniu public („All data is released to the Public Domain\"), fără obligație de atribuire."
        }
    },
    "meta": {
        "distanta": {
            "metoda": "linie_dreapta",
            "detaliu": "Distanţele sunt geodezice, în linie dreaptă pe suprafaţa Pământului (WGS84) — nu pe drum."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (lat, lng, raza_km, limita, tip, cu_iata). Câmpul vinovat e în detalii.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Un parametru nedeclarat ori o valoare care nu trece validarea (lat, lng, raza_km, limita, tip, cu_iata). Câmpul vinovat e în detalii.",
        "detalii": {
            "lat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}