vatpac-technology / vatsim-map

Experimenting with the new VATSIM API to provide a generic FIR map for VATCCs.

VATSIM Map

Experimenting with the new VATSIM API to provide a generic FIR map for VATCCs.

Status

Extremely under cooked ...

Usage

Pilot map

The pilot map loads the VATSIM data feed, filters for pilots in the map.firs, then finally renders pilot positions on a map.

URL: /static/map.html

Accepts the following GET parameters.

Key	Type	Default	Description
theme	String (light | dark)	light	Sets the map theme.
lon	Float	134.9	Sets the map center longitutde.
lat	Float	-28.2	Sets the map center latitude.
zoom	Float	3	Sets the map center zoom.
dataApi	String		Developement - Load data from an alternative pilots API resource.

Sector map

The sector map loads a vatSys dataset defined by data.vatsys, parses the sectors and displays an overlay for map.sectors.standard as well as sub-sectors at a lower level zoom.

URL: /static/sectormap.html

Accepts the following GET parameters.

Key	Type	Default	Description
lon	Float	134.9	Sets the map center longitutde.
lat	Float	-28.2	Sets the map center latitude.
zoom	Float	4.3	Sets the map center zoom.

Contributing

Dependencies

• Node.js and NPM

Running the map

1. Checkout the code.
2. npm -i
3. npm run serve
4. Open http://localhost:8080/

vatsim-map's Issues

Handle -180 meridian

Handle the NFFF_FSS sector (and any others crossing -180) in GeoJSON.

Add API documentation

Create flights API

Enable lookups by flight or per aerodrome.

flights/callsign

Returns a single pilot object filtered by callsign.

Example /flights/callsign/QFA-123

flights/departures

Returns many pilot objects for a given departure aerodrome.

Example /flights/departures/YSSY

flights/arrivals

Returns many pilot objects for a given arrival aerodrome.

Example /flights/arrivals/YMML

Altitude output bugs

A/F function is not working properly. Needs removing.
Sometimes floats appear very broken CRZ ALT: F220.00000000000003

Extend pilots API fields

The pilot API adds three new fields but they are not usefully implemented.

{ "aerodrome": false, "tag_alt": "A043", "tag_gs": "0" }

This test is connected at YHOT 4255 MSL. The aerodrome tag should show YHOT while tag_alt and tag_gs are not really useful by themselves.

Create a new set of tags and expand on current tags.

tag_alt

Formatted altitude string handling transition level changes. Only displayed when airborne so that we can fix the shitty inputs from some VATSIMers so that the following logic works.

    alt = string/100; // 33000 -> 330, 1000 -> 10, 340 -> 3.4
    if(alt <= 5){
        alt = alt * 100;
    }

25,000 ft = F250
10,000 ft = A100
9,500 ft = A095

Values: False, String

tag_gs

gs / 10 to match vatSys outputs.

Values: String

on_aerodrome

Values: False, or the ICAO code of the aerodrome polygon.

aerodrome_elevation

Values: False, or the on_aerodrome elevation AMSL.

phase

A map of flight phases.

• Boarding
• Departing
• Enroute
• Arriving
• Disembarking

Boarding

on_aerodrome == flight_plan.departure
gs == 0

Departing

on_aerodrome == flight_plan.departure
gs > 0
altitude == aerodrome_elevation +/- 100

Enroute

on_aerodrome == false
gs > 0

Arriving

on_aerodrome == flight_plan.arrival
gs > 0

Disembarking

on_aerodrome == flight_plan.arrival
gs == 0

Add AIRAC version to the map attribution

Before we can replace the screenshots at https://vatpac.org/controllers/airspace/ with the sector map, the sector map needs to show which AIRAC is active.

1. Parse https://github.com/vatSys/australia-dataset/blob/master/Profile.xml for AIRAC
2. Show the value in the map attribution string linking to the loaded dataset.

ATC Online API fails with extended coverage

https://map.vatpac.org/v1/atc/online doesn't respond when a sector is being extended

Add instrumentation and logging

OSM cache is extremely slow and I am sure there will be other dumb things to fix. Need logs and metrics.

No js users do not see an error

If you disable JS entirely the map experience is an empty white box. We should show a simple no script error message

Add a ICAO code zoom to function

Similar to the zoom feature provided by the current search, but for a given set of ICAO aerodromes.

Hide aircraft at aerodromes from low zoom levels

Aircraft within an aerodrome shouldn't be displayed until the zoom level permits seeing aerodrome details to avoid cluttering the airborne map.

Stretch goal: Aircraft at an aerodrome should cause the map to render a single aerodrome icon with an ARRs/DEPs counter.

Oceanic sector issues

AIRAC 20211116 (2111c)
IND is rendering a multipoly
TSN FSS is not rendered at all

Map doesn't handle ATC logging off