Location
Location service determines the latitude, longitude of a Sprint CDMA or a iDEN Device along with the approximate accuracy of the location. To protect the privacy of the customers, the location, SMS and MMS services require consent from the device user or the device account holder. For more information, please review device user's or account holder's consent section above.
The location service supports both precision fix (high accuracy - 5 to 5000 meters) or approximate fix (low accuracy - 5 to 25000 meters). High accuracy location returns the most current location available for every location service call whereas a low accuracy location returns the most current location for every five minutes, otherwise it will returned a cached location. If the highAccuracy=true is not set in the location call, the location service defaults to a low accuracy. When you include highAccuracy=true in the location service call, the parameter should also be considered for generating the signature. if not you would get a "Invalid_Signature" error.
*Note iDen device location accuracy is always 4999 meters.
Location service URL
https://sprintdevelopersandbox.com/developerSandbox/resources/v1/location.{format}?{arguments}
Where:
{format} - [txt]/[xml]/[json]
{arguments} - Review below
Authentication
This method requires a sig argument. Please review the authentication section above to generated sig parameter and arguments section below for the complete list of arguments.
Arguments
- key: You're API Key, click here to view.
- mdn: The MDN of the device to be located.
- timestamp: The current time of the request: [YYYY]-[MM]-[DD]T[HH]:[MM]:[SS][ZZZ]
[HH] refers to a zero-padded hour between 00 and 23 (where 00 is only used to notate midnight at the start of a calendar day). - highAccuracy: set to true to force the location accuracy below 5000 meters, default is false.
Ex: highAccuracy=true (default is false) - sig: The MD5 Digest value of the alphabetically sorted parameters of the location service and your secret. The directions for generating this signature can be found here. If you need further help understanding the service call, please look at our emulator
Http Method Get Response
- mdn: The mdn of the device that was located.
- lat: The latitude of the device.
- lon: The longitude of the device.
- accuracy: The accuracy of the location fix in meters.
- ** oldLocation: Only appears if the location has been requested more than once in the last 5 minutes for this mdn for a low accuracy fix.