Introduction

The AIR Tracker application is an application that takes locational information (latitude and longitude) and uploads it to a server API.

Note: Currently, the server side API part of the application has not been checked into the repository. We plan to check it in at a later date. In the mean time, the application source is being posted for anyone interested in viewing it. It can also be used to manually map latitude and longitude coordinates.

Application built for the Adobe on AIR Bus Tour.

Requirements

• Adobe Integrated Runtime (AIR) Beta 1
• Mac or Windows Operating System (see AIR system requirements for specific version information)
• GPS Device (if you want to dynamically send locational information into application)

Source

Source is in Flex 3, ActionScript 3, HTML and JavaScript. You can compile it using mxmlc (included in Flex 3 SDK Beta) or in Flex Builder 3 beta.

• View Source.
• Download Source.

Compiling

• Get source.
• Put common library in class path (included in source download of AIRTracker).
• Download ActionScript 3 corelib SWC and link to it.
• Compile.

Screenshots

Application Screenshot

Application Settings

Usage

Currently, there is not an AIR file for distribution, so to use, you must first compile and either launch via ADL or Flex Builder, or build and install an AIR file.

If you want to upload the data to a server, then you must first fill in the settings.

Settings

The following settings are required if you want to upload data to the server:

• Service URL

In addition, API username and password may be required depending on the configuration of the server side API.

Mapping Coordinates

If you want to map latitude and longitude coordinates:

1. Fill in latitude and longitude in the appropriate fields in the application
2. Press the Send Point button.

This will map the point in the map.

Automating Geo Tracking

If the application is called from the command line, and passed latitude and longitude, then the coordinates will automatically be mapped and uploaded to the server.

Latitude and longitude are expected in the following format:

latitude=-122.437858 longitude=37.736639

Thus, to pass this information into the application in Windows:

AIR Tracker.exe latitude=-122.437858 longitude=37.736639

and on Mac:

AIRTracker.app/Contents/MacOS/AIRTracker latitude=-122.437858 longitude=37.736639

This will map the coordinates (if you are online) and put them into a queue to be uploaded to the server.

This allows you to use a program like gpsbabel to interface with your GPS device, and then pass the information into the application.

Offline

If the application is running offline, then coordinates will be save, and then uploaded once the application can connect to server.

Code Highlights

The application contains examples of:

• How to save information when offline, and then sync up to the server when the application goes back online.
• ActionScript to JavaScript Script Bridging

Bugs / Feature Requests

Please log any bugs and / or feature requests on the Issues page.

//todo:

• Create AIR file for distribution