Aircraft In Range


Return list of aircrafts that currently located within specified range from geographical point or airport.

Output fields:

  • info: this key contain value found which represents number of found aircraft's with given parameters
  • result: will contain all found aircraft's and their details

Usage

Endpoint: /acft_in_range

Request method: GET

Headers:

Header parameterDescription
X-API-Key Your unique API key
icao Airport ICAO code. If lat/lon is not set, this is required.
rad Radius from center point (airport or lan/lon) in nautical miles or kilometers. Accept positive integer values that followed by km or nm: 10nm / 10km
lat Latitude as decimal value. If icao is set, then lat is ignored.
lon Longitude as decimal value. If icao is set, then lon is ignored.

Example request:

Python

    import requests

    url = "https://api.vacc-ua.org/api/acft_in_range"

    headers = {
        'X-API-Key': "123456",
        'icao': "EHEH",
        'rad': "10nm",
        'Cache-Control': "no-cache"
    }

    response = requests.request("GET", url, headers=headers)
    print(response.text)

PHP

    <?php

    $curl = curl_init();

    curl_setopt_array($curl, array(
        CURLOPT_PORT => "443",
        CURLOPT_URL => "https://api.vacc-ua.org/api/acft_in_range",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => "",
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => "GET",
        CURLOPT_HTTPHEADER => array(
            "Cache-Control: no-cache",
            "X-API-Key: 123456",
            "icao: EHEH",
            "rad: 10nm"
        ),
    ));

    $response = curl_exec($curl);
    $err = curl_error($curl);

    curl_close($curl);

    if ($err) {
        echo "cURL Error #:" . $err;
    } else {
        echo $response;
    }

Example response:


{
    "result": {
        "AUI5325": {
            "protrevision": "100",
            "planned_remarks": "+VFPS+/V/RMK/CALLSIGN UKRAINE INTERNATIONAL REG/URPSE RTE/PS5325 OPR/WWW.VAU.AERO",
            "QNH_Mb": "1015",
            "rating": "1",
            "planned_destairport": "LTAI",
            "planned_revision": "3",
            "planned_aircraft": "B738/L",
            "planned_hrsfuel": "3",
            "planned_minfuel": "0",
            "planned_destairport_lon": "0",
            "QNH_iHg": "29.999",
            "planned_depairport_lon": "0",
            "altitude": "5777",
            "planned_route": "N0460F330 SULUM M856 GOBLI L919 BAGRI T219 RIXEN UN616 IST UT35 BABSA",
            "cid": "1317232",
            "heading": "184",
            "transponder": "7422",
            "planned_depairport_lat": "0",
            "longitude": "30.67043",
            "planned_altitude": "F330",
            "planned_hrsenroute": "2",
            "planned_minenroute": "10",
            "latitude": "36.92363",
            "planned_destairport_lat": "0",
            "planned_actdeptime": "1640",
            "server": "GERMANY2",
            "planned_flighttype": "I",
            "time_logon": "20190129161859",
            "realname": "Nikolayi  Osadchyi UKBB",
            "planned_altairport": "LTBS",
            "planned_tascruise": "460",
            "planned_deptime": "1640",
            "groundspeed": "242",
            "planned_depairport": "UKBB"
        },
        <... ommited output ...>
    },
    "info": {
        "found": 4
    }
}