Aircraft In Range

Updated Apr 09 2021

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': "UKBB",
        'rad': "50nm",
        '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: UKBB",
            "rad: 50nm"
        ),
    ));

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

    curl_close($curl);

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

Example response:


{
    "result": {
        "AUI5202": {
            "cid": 1467513,
            "name": "Ivan Salata UKBB",
            "callsign": "AUI5202",
            "server": "GERMANY-1",
            "pilot_rating": 0,
            "latitude": 50.61812,
            "longitude": 31.15044,
            "altitude": 5268,
            "groundspeed": 207,
            "transponder": "2000",
            "heading": 275,
            "qnh_i_hg": 30.09,
            "qnh_mb": 1019,
            "flight_plan": {
                "flight_rules": "I",
                "aircraft": "B738/M-MSDFGHIRWXY/LB1",
                "aircraft_faa": "B738/L",
                "aircraft_short": "B738",
                "departure": "HESH",
                "arrival": "UKBB",
                "alternate": "UKKK",
                "cruise_tas": "463",
                "altitude": "33000",
                "deptime": "1730",
                "enroute_time": "0346",
                "fuel_time": "0449",
                "remarks": "PBN/B2B3B4D1O2S1S2 DOF/210408 REG/URUIA EET/LCCC0121 LTAA0143 LTBB0209 LBSR0233 LRBB0244 UKBU0253 UKBV0329 SEL/KSBM CODE/5083C9 OPR/AUI PER/C TALT/HECA RMK/TCAS SIMBRIEF /V/",
                "route": "IMPIT1A HGD V608 NABED/N0462F340 T55 GINDI W8 CVO A16 MELDO/N0455F360 A16 RASDA M855 TOMBI UA16 AYT UQ23 OSVEL UL619 MAKOL/K0839F360 N617 BINBI/N0454F360 N617 OSDOR/K0841F360 N617 ODESE T219 KONIP",
                "revision_id": 2
            },
            "logon_time": "2021-04-08T16:57:58.2550984Z",
            "last_updated": "2021-04-08T21:18:08.0768587Z"
        },
        "UBE1007": {
            "cid": 1559027,
            "name": "Viktor Moraz UKWW",
            "callsign": "UBE1007",
            "server": "UK-1",
            "pilot_rating": 0,
            "latitude": 50.40238,
            "longitude": 30.4652,
            "altitude": 594,
            "groundspeed": 27,
            "transponder": "1200",
            "heading": 267,
            "qnh_i_hg": 29.97,
            "qnh_mb": 1015,
            "flight_plan": {
                "flight_rules": "I",
                "aircraft": "B738/M-SDE2E3FGHIRWXY/LB1",
                "aircraft_faa": "B738/L",
                "aircraft_short": "B738",
                "departure": "UKKK",
                "arrival": "UKKK",
                "alternate": "UKOO",
                "cruise_tas": "464",
                "altitude": "12000",
                "deptime": "2230",
                "enroute_time": "0034",
                "fuel_time": "0310",
                "remarks": "PBN/A1B1C1D1S1S2 DOF/210408 REG/URUBB EET/UKBU0009 UKBV0028 OPR/UBE PER/C RMK/TCAS SIMBRIEF /V/",
                "route": "KAFEL DCT LAPVA",
                "revision_id": 1
            },
            "logon_time": "2021-04-08T21:02:17.1744341Z",
            "last_updated": "2021-04-08T21:18:08.0741548Z"
        }
    },
    "info": {
        "found": 2
    }
}