Request LBS
Purpose
Requests an approximate geographic location for a SIM by submitting serving and neighbouring cell information.
The platform estimates location using known cell site data and returns:
- Latitude
- Longitude
- Accuracy (meters)
- Country
- Town
- District (where available)
The target SIM is specified using the <iccid> element.
Commercial Note:
This service may be chargeable on a per-request basis in accordance with your contract terms. Charging may apply depending on usage levels. Please contact support to discuss expected usage.
Endpoint
POST https://api.m2miportal.com
Content-Type: application/xml
Accept: application/xml
Request (XML)
<request-lbs version="1" api-id="123456">
<authentication>
<username>username</username>
<password>password</password>
</authentication>
<iccid>1234567890123456789</iccid>
<scell>
<mcc>234</mcc>
<mnc>10</mnc>
<lac>1F43</lac>
<cid>725F</cid>
<rxl>-67</rxl>
</scell>
<ncell>
<mcc>234</mcc>
<mnc>15</mnc>
<lac>0063</lac>
<cid>5c8</cid>
<rxl>-83</rxl>
</ncell>
</request-lbs>Response (Success)
<request-lbs-response api-id="123456">
<api-outcome>Success</api-outcome>
<latitude>53.681507</latitude>
<longitude>-2.643662</longitude>
<accuracy>1538</accuracy>
<country>United Kingdom</country>
<town>Leyland</town>
<district>Clayton</district>
</request-lbs-response>Cell Data Requirements
Serving Cell (<scell>)
The serving cell is mandatory.
If no serving cell is provided, the request will fail.
Neighbouring Cells (<ncell>)
- Up to 7 neighbouring cells may be provided
- In practice, more than 3 provides little additional benefit
- At least 2 cells are recommended for reasonable accuracy
- Neighbouring cells may belong to any network
Cell Element Definitions
Each <scell> and <ncell> contains:
Element | Mandatory | Description |
|---|---|---|
<mcc> | Yes | Mobile Country Code (0–999) |
<mnc> | Yes | Mobile Network Code (0–999) |
<lac> | Yes | Location Area Code (hexadecimal) |
<cid> | Yes | Cell ID (hexadecimal) |
<rxl> | No | Signal strength in dBm (-110 to -40) |
Elements containing data outside acceptable ranges will be ignored.
Response Elements
Element | Description |
|---|---|
<latitude> | Estimated latitude |
<longitude> | Estimated longitude |
<accuracy> | Horizontal accuracy in meters (50% confidence radius) |
<country> | Country |
<town> | Closest town or city |
<district> | District or area (only returned if different from town) |
Failure Responses
Standard failure responses apply (see general API failure handling).
Additional LBS-specific failure:
This indicates:
- Insufficient cell data
- Contradictory or erroneous data
- Positioning data unavailable for the location
Service Limitations
- Cell IDs may be reassigned by operators without notice
- New cell IDs are continuously introduced
- Location data is based on evolving, crowd-sourced information
- Accuracy is not guaranteed
- This service should not be relied upon for critical applications