Location
Last known location of the associated device can be retrieve. This location can be provided by network probes (only available for France) or with SmartSim location service (available for some regions).
| Only available for some regions and depends on your network provider option package. |
Get cellular networks location (Beta)
Request
Endpoint:
GET /api/v1/networks/cellular/subscriptions/{subscriptionId}/location
HTTP Headers:
X-API-Key: <your API key> Content-Type: application/json Accept: application/json
Example:
GET /api/v1/networks/cellular/subscriptions/06361407/location
Response
HTTP Code:
200 OK
Body:
{
"lat": "44.8",
"lon": "3.7",
"accuracy": "120.0",
"provider": "network",
"lastUpdateTs": "2020-10-28T16:13:04Z",
"link": "https://m2mexpress.fr.orange-business.com/mac/customer/fleet/deviceinfo/localization-details.do?subId=06361407"
}| JSON Params | Description |
|---|---|
lat |
coordinate latitude |
lon |
coordinate longitude |
accuracy |
position accuracy in m |
lastUpdateTs |
date of the position |
provider |
provider of the location ("network" when supplied by network probes (only available for France) or "smart-sim" when supplied by SmartSim location service) |
link |
link to access the location tab on the service provider portal |
Error case:_
| HTTP Code | Error code | message |
|---|---|---|
400 |
GENERIC_INVALID_PARAMETER_ERROR |
The submitted parameter is invalid. |
403 |
FORBIDDEN |
Forbidden request |
404 |
CELLULAR_SUBSCRIPTION_NOT_FOUND |
Subscription not found |