Request LBS

9 min

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 \<api outcome>position unavailable\</api outcome> 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