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
gpsobjects if the device or client has multiple GPS locations. - Always include
"geolocation": 0to the request body while contributing to ensure such requests are not charged and do not affect balance. - Contact us before you begin sending
gpsdata since this feature has to be enabled manually.
| Parameter | Description | Type | Required |
|---|---|---|---|
| lat | The latitude of the observation (WGS 84) | float | yes |
| lon | The longitude of the observation (WGS 84) | float | yes |
| accuracy | The horizontal accuracy of the observed position in meters | float | no |
| altitude | The altitude at which the data was observed in meters above sea-level | float | no |
| altitude_accuracy | The accuracy of the altitude estimate in meters | float | no |
| speed | The measured speed of the device in meters per second | float | no |
| heading | The direction of travel of the device in degrees (0° - 360°) clockwise relative to true north | float | no |
| timestamp | The time this GPS position was observed, measured in milliseconds since the UNIX epoch | integer | no |

