location.get — Get location information.


location.get timeout | -callback callbackProc [ -timeout timeout ] [ -onerror onErrorProc ]


The location.get command operates in two ways:

  1. The simplest way is to simply call the command with a timeout argument. The program will block until the command returns an answer, in the form of a hash table (see below), which could take up to several minutes.

  2. The alternative way of calling location.get is to pass it a -callback callbackProc, which is the name of a proc that will be called when the information is available, with a hash table specifying the results. Program execution continues and does not block on the location.get call. The callbackProc takes one argument, which is a hash of information about the location. When using -callback it is also possible to specify a -timeout option (in seconds), and an -onerror option. This is used in case of errors: the specified onErrorProc

Either method will supply the user with a hash table with the following elements. See also the JavaDocs here: javax/microedition/location/Location

  • lat: latitude.

  • lon: longitude.

  • alt: altitude.

  • haccuracy: horizontal accuracy, in meters.

  • vaccuracy: vertical accuracy, in meters.

  • location_method: contains a hash table of its own with information about the method used to ascertain the location. Possible values include:

    • ASSISTED: Location method is assisted.

    • UNASSISTED: Location method is unassisted.

    • NETWORKBASED: Location is derived from the network.

    • TERMINALBASED: Location is obtained from a GPS terminal.

    • ANGLEOFARRIVAL: Location method Angle of Arrival for cellular / terrestrial RF system.

    • CELLID: Location method Cell-ID for cellular (in GSM, this is the same as CGI, Cell Global Identity).

    • SATELLITE: Location method using satellites (for example, Global Positioning System (GPS)).

    • SHORTRANGE: Location method Short-range positioning system (for example, Bluetooth LP).

    • TIMEDIFFERENCE: Location method Time Difference for cellular / terrestrial RF system (for example, Enhanced Observed Time Difference (E-OTD) for GSM).

    • TIMEOFARRIVAL: Location method Time of Arrival (TOA) for cellular / terrestrial RF system.

  • speed: ground speed, in meters per second.

  • course: course, in degrees relative to true north.