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