Here is the description of the various API
Note: you must sign to get an API key. Testing: You can use mcc=1 and mnc=1 to do your test, before switching to "real"/mcc/mnc number! ²measure/add
To submit a new cell measurement:
http://www.opencellid.org/measure/add?key=myapikey&mnc=1&mcc=2&lac=200&cellid=234&lat=3.42&lon=3.12
Where:key: The apikey
mcc: mobile country code(decimal)
mnc: mobile network code(decimal)
lac: locale area code (in decimal)
cellid: value of the cell id (in decimal)
measured_at (optionnal) the time of the measure...
lat:latitude when the measure has been taken
lon:longitude when the measure has been taken
Return:
ok or nok
cell/get
Get the position of a specific cell
http://www.opencellid.org/cell/get?key=myapikey&mnc=1&mcc=2&lac=200&cellid=234
Where:
key: The apikey
mcc: mobile country code (decimal)
mnc: mobile network code (decimal)
lac: locale area code (decimal)
cellid: value of the cell id
lac can be ommitted
If cellid is not present or if cellid i unkown, a defaut return will be based on lac information, but with a much lower accuracy. In that case, cellid return will be -1.
The postion will be retourned in xml format by default in the following form
|
Example:
http://www.opencellid.org/cell/get?mcc=250&mnc=99&cellid=29513&lac=0
cell/getMeasures
Get the raw measures used to compute the position of a cell
http://www.opencellid.org/cell/getMeasures?mnc=1&mcc=2&lac=200&cellid=234
The positions will be retourned in xml format by default... Example:
http://www.opencellid.org/cell/getMeasures?mcc=250&mnc=99&cellid=29513&lac=0
cell/getInArea
Obtain the list of cells in a specified area. Could be useful to preload some cells for a specific area
http://www.opencellid.org/cell/getInArea/?key=myApiKey&BBOX=latmin,lonmin,latmax,lontmax
Where:
key: The apikey
BBOX: the bounding box from where you want to get the measures
Optionnal parameters:
limit: a number defining the size of the returned list. Default is 200. Be careful, putting a too big number could generate an error
mcc:If you want to retrict the result to a specific country
mnc:If you want to restrict the result to a specific operator
fmt:you can specifiy Kml, Xml or TXT as output. Default is Kml. Txt is CSV type of output, with a first line defining the content of the list
Example: http://www.opencellid.org/cell/getInArea?BBOX=2.210836754705214,48.80850297346874,2.488529205537504,48.93716640758027&fmt=xml
measure/uploadCsv
Upload a set of measures in a single poast
http://www.opencellid.org/measure/uploadCsv?key=myapikey
Where:
key: The apikey
datafile: The file that contains the mesures to be uploaded The format of the file is the following: the first line contains the name of the attributes to be sent (from lat,lon,mcc,mnc,lac,cellid,signal,measured_at) then, each line should contains a measure with the argument in the same line than in the header line, comma separated. Example of measure.txt file:
lat,lon,mcc,mnc,lac,cellid, 37.9872945,23.5773136,202,10,11100,13245414 37.9835,24.613223,202,10,11100,13245416 ...Example: http://www.opencellid.org/measure/upload is an example of front end to upload file
Other functions:
measure/delete
To delete a muser. You can only delete your own measure, so your API key must be given.
http://www.opencellid.org/measure/delete/id?key=myApiKey
Where:
id: is the measure id you want to delete. This number is given as a reault of measure/add or measure/listMines
apiKey: your own API key
Note that a cell which has been created using this measure will only be deleted when all associated measures will be deleted.
measure/list
List your own measures:
http://www.opencellid.org/measure/list?key=myApiKey
Where:
key: The apikey
This will list all measure created using your own API key (which can be long) and also the associated measure id, which can be used to delete a measure. Note: this function still need to evolve, as it is not adapted to poeple submitting a huge number of measures.
