GPS

Kismet now supports multiple simultaneous GPS devices, and can select the ‘best’ quality device based on priority and GPS signal.

List all available GPS drivers

Kismet supports multiple types of GPS device, and can be extended by plugins.

  • URL

    /gps/drivers.json

    /gps/drivers.ekjson

    /gps/drivers.itjson

  • Methods

    GET

  • Role

    readonly

  • Return

    Array of all supported GPS drivers

List all GPS devices

  • URL

    /gps/all_gps.json

    /gps/all_gps.ekjson

    /gps/all_gps.itjson

  • Methods

    GET

  • Role

    readonly

  • Return

    All configured GPS devices

Add a GPS device

  • URL

    /gps/add_gps.cmd

  • Methods

    POST

  • API Added

    2021-02

  • Role

    admin

  • POST parameters

    A command dictionary containing:

    Key Description
    definition GPS definition line
  • Results

    Newly defined GPS, or HTTP error on failure

Remove a GPS device

  • URL

    /gps/by-uuid/[UUID]/remove_gps.cmd

  • Methods

    GET

  • API Added

    2021-02

  • Role

    admin

  • URI parameters

    Key Description
    UUID GPS to be removed, by UUID
  • Results

    HTTP success if GPS removed

    HTTP failure if GPS could not be removed or command is malformed

GPS location

The current “best” GPS location can be retrieved, with timestamp, for presentation in the UI or use in logging.

  • URL

    /gps/location.json

  • Methods

    GET, POST

  • Role

    readonly

  • POST parameters

    If submitted via POST,

    A command dictionary containing:

    Key Description
    fields Optional Kismet field simplification.
  • Return

    Current “best” GPS location and information

All GPS locations

Returns the current location of all GPS interfaces.

  • URL

    /gps/all_locations.json

  • Methods

    GET, POST

  • Role

    readonly

  • POST parameters

    If submitted via POST,

    A command dictionary containing:

    Key Description
    fields Optional Kismet field simplification.
  • Return

    A dictionary, indexed by UUID, of all GPS devices and locations

Per-receiver GPS location

The current location of the GPS specified by the UUID parameter.

  • URL

    /gps/by-uuid/[UUID]/location.json

  • Methods

    GET, POST

  • Role

    readonly

  • URI parameters

    Key Description
    UUID GPS UUID to fetch location from
  • POST parameters

    If submitted via POST,

    A command dictionary containing:

    Key Description
    fields Optional Kismet field simplification.
  • Return

    The current location of the specified GPS, or HTTP error if the GPS interface is not found.

Web GPS

Kismet supports a Web-based GPS, where the data is provided by the browser (or submitted over the HTTP channel from another GPS source).

  • URL

    /gps/web/update.cmd

  • Methods

    POST

  • Role

    admin

  • POST parameters

    A command dictionary containing:

    Key Description
    lat GPS latitude
    lon GPS longitude
    alt Optional, GPS altitude in meters
    spd Optional, GPS speed in kilometers per hour
  • Returns

    HTTP 200 on successful update of the webgps location

    HTTP error on failure

Updated: