oneapi
Autentificare
Utile v1 / Aeroporturi

Detaliu aeroport

Un aeroport întreg: codurile, poziţia, altitudinea, ţara şi pistele, cu lungimea şi suprafaţa fiecăreia.

GET
https://oneapi.ro/api/utile/v1/aeroporturi/{cod}

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul aeroportului — IATA (trei litere) sau ICAO (patru litere).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Se acceptă oricare dintre cele trei coduri. Când același șir e IATA pentru un aeroport și ICAO pentru altul, câștigă IATA: e codul pe care îl are omul de pe bilet, deci cel mai probabil cerut.
  • Pistele vin ordonate descrescător după lungime, deci prima e cea principală. Lungimea e dată și în picioare (cum o publică sursa), și în metri.
  • capete sunt identificatorii celor două capete ale pistei (08 / 26), care codifică orientarea în zeci de grade.

La ce folosește

  • Traduci un cod IATA de pe un bilet în nume, oraș și coordonate.
  • Verifici dacă un aeroport poate primi un anumit tip de aeronavă, uitându-te la lungimea pistelor.
  • Afli coordonatele exacte, pentru o hartă sau un calcul de distanță.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere
aeroport.ident string
aeroport.iata string
aeroport.icao string
aeroport.nume string Numele, aşa cum îl publică sursa.
aeroport.tip string
aeroport.municipiu string Municipiul deservit.
aeroport.tara.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
aeroport.tara.nume string Numele, aşa cum îl publică sursa.
aeroport.regiune.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
aeroport.regiune.nume string Numele, aşa cum îl publică sursa.
aeroport.continent string Continentul pe care se află.
aeroport.latitudine number Latitudinea, în grade zecimale (WGS 84).
aeroport.longitudine number Longitudinea, în grade zecimale (WGS 84).
aeroport.altitudine_ft integer
aeroport.altitudine_m integer
aeroport.curse_regulate boolean
aeroport.wikipedia string Adresa articolului de Wikipedia.
aeroport.site string Adresa sitului oficial.
aeroport.piste[] array Lista pistelor, de la cea mai lungă.
aeroport.piste[].lungime_ft integer
aeroport.piste[].lungime_m integer Lungimea în metri, convertită din picioare.
aeroport.piste[].latime_ft integer
aeroport.piste[].suprafata string Materialul pistei, așa cum îl scrie sursa (ASP, CON, GRS).
aeroport.piste[].iluminata boolean Dacă pista are balizaj.
aeroport.piste[].inchisa boolean Dacă pista nu mai e în uz, deși aeroportul funcționează.
aeroport.piste[].capete array Identificatorii capetelor pistei.
aeroport.numar_piste integer Câte piste are aeroportul.
sursa.nume string Denumirea sursei oficiale.
sursa.url string Adresa publică a sursei.
sursa.licenta string Licenţa sub care sursa permite reutilizarea.

Exemple de răspuns

GEThttps://oneapi.ro/api/utile/v1/aeroporturi/OTP
{
    "data": {
        "aeroport": {
            "ident": "LROP",
            "iata": "OTP",
            "icao": "LROP",
            "nume": "Bucharest Henri Coandă International Airport",
            "tip": "large_airport",
            "municipiu": "Otopeni",
            "tara": {
                "cod": "RO",
                "nume": "România"
            },
            "regiune": {
                "cod": "RO-IF",
                "nume": "Ilfov County"
            },
            "continent": "EU",
            "latitudine": 44.571792,
            "longitudine": 26.103285,
            "altitudine_ft": 314,
            "altitudine_m": 96,
            "curse_regulate": true,
            "wikipedia": "https://en.wikipedia.org/wiki/Henri_Coand%C4%83_International_Airport",
            "site": "http://www.bucharestairports.ro/en/",
            "piste": [
                {
                    "lungime_ft": 11484,
                    "lungime_m": 3500,
                    "latime_ft": 148,
                    "suprafata": "ASP",
                    "iluminata": true,
                    "inchisa": false,
                    "capete": [
                        "08L",
                        "26R"
                    ]
                }
            ],
            "numar_piste": 2
        },
        "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."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există aeroport cu codul dat.
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": "negasit",
        "mesaj": "Nu există aeroport cu codul dat."
    }
}