location.current

TR50 Request


{
  "cmd": {
    "command": "location.current",
    "params": {
      "thingKey": "mything"
    }
  }
}

Request Parameters


Name	Type	Required	Description
	Thing Identifier Parameters		Identifies the Thing associated with the location entries. If omitted, the thingKey associated with your session will be used. See Thing Identifier Parameters table below for supported parameters.

Thing Identifier Parameters


Name	Type	Description
thingKey	String	Key of the thing
thingId	String	Id of the thing
esn	String	Esn of the thing
iccid	String	Iccid of the thing
imei	String	Imei of the thing
imsi	String	Imsi of the thing
meid	String	Meid of the thing
msisdn	String	Msisdn of the thing

TR50 Response

If the command is sent successfully a success message and the result values found are returned. Otherwise, an error and error message will be returned.


{
    "cmd": {
        "success": true,
        "params": {
            "lat": 45.351693,
            "lng": -75.917483,
            "fixType": "manual",
            "speed": 0,
            "addr": {
                "streetNumber": "350",
                "street": "Terry Fox Drive",
                "city": "Ottawa",
                "state": "ON",
                "zipCode": "K2K W2W",
                "country": "CA"
            }
        }
    }
}

Response Parameters


Name	Type	Description
corrId	String	The correlation identifier associated with the location entry (if set).
lat	Float	The latitude coordinate associated with the location entry.
lng	Float	The longitude coordinate associated with the location entry.
fixAcc	Float	The fix accuracy of the location data (if set).
fixType	String	The fix type of the location data (if set).
heading	Float	The heading associated with the location entry (if set).
altitude	Float	The altitude associated with the location entry (if set).
speed	Float	The speed associated with the location entry (if set).
addr	Object	See location.decode response for address components.