README.md

FlightAirMap

FlightAirMap is a fork of Barrie Spotter https://github.com/barriespotter/Web_App with map, airspaces, METAR, PDO and ADS-B support.

Browse through the data based on a particular aircraft, airline or airport to search through the database. See extensive statistics such as most common aircraft type, airline, departure & arrival airport and busiest time of the day, or just explore flights.

Flights are displayed on a 2D map that can be from : OpenStreetMap, Mapbox, MapQuest, Yandex, Bing, Google,... Or a 3D map using OpenStreetMap or Bing.

It can be used with Dump1090 or any SBS source.

Can also be used with virtual airlines sources like FlightGear, whazzup.txt from IVAO, VATSIM, phpvms, Virtual Airlines Manager,...

It also support glidernet APRS source.

Satellites can be displayed on 3D map.

On december, you can track Santa's flight.

For vessels, AIS is a supported source, so ships can be displayed on both 2D and 3D map, statistics are generated,...

For trackers, APRS is a supported source, so cars, trucks, mobile phones,... can be displayed on both 2D and 3D map, statistics are generated,...

Official Website

https://www.flightairmap.com/

Demo

• From ADS-B, real flights: https://real.flightairmap.com/
• From Open Glider Network: https://ogn.flightairmap.com/
• From IVAO, virtual flights: https://ivao.flightairmap.com/
• From VATSIM, virtual flights: https://vatsim.flightairmap.com/
• From APRS Trackers: https://tracker.flightairmap.com/
• From AIS, real vessels: https://marine.flightairmap.com/

Documentation

A wiki is available here: https://github.com/Ysurac/FlightAirMap/wiki

System Requirements

To install the web app, you need to have meet the following requirements:

• PHP version 5.4 or greater (>= 5.5.1 recommanded)
• MySQL version 5.6.1 or greater, MariaDB or PostgreSQL with PostGIS
• An HTTP Server such as:
  • Apache 2.0+
  • Nginx (include install/flightairmap-nginx-conf.include in server part of the config)
  • Lighttpd

Required Extensions

The follwing is a list of PHP extensions that must be installed on your server in order for this web app to run properly:

• cURL http://php.net/curl which is used to access remote sites.
• PDO http://php.net/pdo with MySQL or PostgreSQL driver is required for database access (Maybe other databases work too, not tested).
• JSON http://php.net/json
• ZIP http://php.net/zip needed for SBS.
• DOM http://php.net/dom
• SimpleXML http://php.net/simplexml

Install

Check https://github.com/Ysurac/FlightAirMap/wiki/Installation for detailed installation instruction.

Web install/Update

git clone --recursive https://github.com/Ysurac/FlightAirMap or get latest release https://github.com/Ysurac/FlightAirMap/releases

Use install/index.php

(You can always keep scripts/settings.php when you update)

Data Sources

ADS-B in SBS1 (BaseStation) format (real flights)

• You can use dump1090 https://github.com/mutability/dump1090 with a RTL dongle, Radarcape deltadb.txt or aircraftlist.json, or wazzup file, or /action.php/acars/data of phpvms...
• run scripts/daemon-spotter.php

ACARS (only messages from real flights)

• You have to use acarsdec https://github.com/TLeconte/acarsdec : acarsdec -N 127.0.0.1:9999 -r 0 131.525 131.550 131.725
• run scripts/daemon-acars.php

APRS (real flights)

• You can use APRS server from glidernet like aprs.glidernet.org:14580 (or port 10152 without APRS filter)

IVAO (virtual flights)

• You can use as source a whazzup.txt file like : http://api.ivao.aero/getdata/whazzup/whazzup.txt

VATSIM (virtual flights)

• You can use as source a vatsim-data.txt file like : http://info.vroute.net/vatsim-data.txt

Virtual Airlines Manager (virtual flights)

• You need to copy the file install/VAM/VAM-json.php in your VAM directory, and use it as source

AIS NMEA (real ships)

• You can use AISHub http://www.aishub.net feed, or rtl_ais https://github.com/dgiardini/rtl-ais as TCP listener.

License

FlightAirMap is licensed under GNU Affero General Public License (AGPL) version 3. "The GNU Affero General Public License is a modified version of the ordinary GNU GPL version 3. It has one added requirement: if you run a modified program on a server and let other users communicate with it there, your server must also allow them to download the source code corresponding to the modified version running there."

Some work can be used under other licenses, check file CREDITS

Contribution

When submitting a pull request for the first time, you will need to agree to the contributor license agreement (for individuals or entities). To do this, in the pull request please create a file with a name like /contributors/{github_username}.md, and in the content of that file indicate your agreement. An example of what that file should contain can be seen in example agreement file.

(This method of CLA "signing" is borrowed from Medium's open source project.)