Home VATSIM Client Apps Admin Report Bugs Feature Req SDK Feedback Support the Author

VatitaWS

VatitaBB and VatitaBBX clients connect to VatitaBB.net via VatitaWS, a standard Soap Web Service.
Actually it consists of three methods:  "GetAllData", "GetData" and "SendData". They can be invoked by any language that supports Web Service like .Net or Java.

GetAllData

GetAllData gets last two minutes data from all connected clients.
Input parameters: none
Output: XML in a specific format (see below)

 

Root element is named "VatitaBB_data" and each child element "data" with its attributes represents each client connected last two minutes data.
A XML file can be easily binded to a datasource.
An example is this asp.net page that invokes "GetAllData" method and creates a kml file for Google Earth showing connected aircraft last two minutes data as a LineString in real time. Download vbbTraffic.kml (right click and save as) to refresh data in Google Earth.

GetData

GetData gets current aircraft data from all connected clients.
Input parameters: none
Output: XML in a specific format (see below)

 

Root element is named "VatitaBB_data" and each child element "data" with its attributes represents the client connected data.
GetData decodes DEP, DEST and closest airports ICAO codes to names; it calculates distances (nm) from DEP and DEST and ETA to DEST. It also deletes from the database  data older than two minutes from system datetime in UTC (client no more connected).
A XML file can be easily binded to a datasource.
Home section of this website for example gets data and show them in a gridview refreshing every 5 seconds.
Another example is this asp.net page that invokes "GetData" method and creates a kml file for Google Earth showing aircraft connected in real time. Download vbbTraffic.kml (right click and save as) to refresh data in Google Earth.

SendData

SendData receives aircraft data from clients and stores them in a database.
Input parameters: XML in a specific format (see below)
Output: int 0 if ok

 

Root element  is "VatitaBB" and there is only one child with its attributes called "data" ("closest" attribute VatitaBBX only).
SendData calculates "status" attribute and it also deletes from the database its callsign data older than two minutes from system datetime in UTC (client no more connected).

Actually there is no digital signature on XML and there is no authentication to the Web Service. Then you can develop your own client to connect to VatitaBB.net or create pages in any language to show data.