This protocol was originally used by the OsmAnd mobile app. It was later adopted and extended to be used by our official Traccar Client apps. Some older versions of Traccar Client use a custom NMEA-based protocol.
The OsmAnd protocol processes HTTP requests with either query parameters or POST parameters. The following parameters can be included in the request:
id or deviceid: The unique identifier for the device. This is a mandatory parameter.valid: Indicates if the location is valid. Acceptable values are "true", "false", "1", and "0".timestamp: The timestamp of the position. It can be in seconds or milliseconds since epoch, ISO 8601 format, or "yyyy-MM-dd HH:mm:ss" format.lat: Latitude of the position. This should be a double value.lon: Longitude of the position. This should be a double value.location: A comma-separated string in the format "latitude,longitude".cell: Cell tower information in the format "mcc,mnc,lac,cellId,signalStrength" or "mcc,mnc,lac,cellId".wifi: WiFi access point information in the format "macAddress,signalStrength". For example "00-14-22-01-23-45,-80".speed: Speed of the device. Units are configurable with knots as a default.bearing or heading: The direction in which the device is moving, in degrees.altitude: Altitude of the device in meters.accuracy: Accuracy of the position in meters.hdop: Horizontal dilution of precision.batt: Battery level of the device.driverUniqueId: Unique identifier for the driver.charge: Indicates if the device is charging. Acceptable values are `true` and `false`.Any other parameters will be treated as custom attributes and stored with the position.
Example 1: Basic request with mandatory parameters
http://demo.traccar.org:5055/?id=12345&lat=48.8566&lon=2.3522×tamp=1609459200000
Example 2: Request with additional parameters
http://demo.traccar.org:5055/?deviceid=12345&lat=48.8566&lon=2.3522×tamp=2021-01-01T00:00:00Z&speed=15&bearing=270&altitude=35&accuracy=10&hdop=0.8&batt=75
Example 3: Request with cell and WiFi information
http://demo.traccar.org:5055/?id=12345&lat=48.8566&lon=2.3522×tamp=1609459200000&cell=208,10,12345,67890,50&wifi=00:11:22:33:44:55,-70