GeolocationRequest

GPS

Contribute GPS observations alongside cell and WiFi data to improve positioning accuracy.

Each gps object contains GPS location information about when and where the data in the request body was observed.

Sample request with the gps object

{
    "cells": [{"lac": 7033, "cid": 17811, "radio": "gsm", "mcc": 310, "mnc": 410}],
    "wifi": [{"bssid": "00:17:c5:cd:ca:aa"}],
    "gps": [{
        "source": "gps",
        "lat": 39.56764858,
        "lon": -105.0073312,
        "accuracy": 30.0,
        "altitude": 100.0,
        "altitude_accuracy": 50.0,
        "speed": 10.2,
        "heading": 35.5,
        "timestamp": 1480510819000
    }],
    "gps_sandbox": 1,
    "geolocation": 0
}
  • You may send multiple gps objects if the device or client has multiple GPS locations.
  • Always include "geolocation": 0 to the request body while contributing to ensure such requests are not charged and do not affect balance.
  • Contact us before you begin sending gps data since this feature has to be enabled manually.
ParameterDescriptionTypeRequired
latThe latitude of the observation (WGS 84)floatyes
lonThe longitude of the observation (WGS 84)floatyes
accuracyThe horizontal accuracy of the observed position in metersfloatno
altitudeThe altitude at which the data was observed in meters above sea-levelfloatno
altitude_accuracyThe accuracy of the altitude estimate in metersfloatno
speedThe measured speed of the device in meters per secondfloatno
headingThe direction of travel of the device in degrees (0° - 360°) clockwise relative to true northfloatno
timestampThe time this GPS position was observed, measured in milliseconds since the UNIX epochintegerno