Difference between revisions of "Menu map view"

From OpenCellID wiki
Jump to: navigation, search
Line 5: Line 5:
 
===map view===
 
===map view===
 
{| cellpadding="10" cellspacing="0" border="1" width=998px style="border: 2px solid lightgrey;"
 
{| cellpadding="10" cellspacing="0" border="1" width=998px style="border: 2px solid lightgrey;"
| [[File:OpenCellID_map_view_cell_bubbles.png|400px]] || In most cases the map shows bubbles of different size and colour.  
+
| [[File:OpenCellID_map_view_cell_bubbles.png|400px]] || In most cases the map shows bubbles of different sizes and colour.  
  
 
The bigger a bubble is, the more cells have been found close to this bubble.  
 
The bigger a bubble is, the more cells have been found close to this bubble.  
  
Smaller bubbles are green, mid size bubbles are yellow and big bubbles are orange or red.
+
Smaller bubbles are green, mid-sized bubbles are yellow, and larger bubbles are orange or red.
  
The screenshot shows a part of Berlin (Germany) down town close to "Zoologischer Garten". This is an area with a high density of people living, working or travelling there. Therefore many different cells can be found there.
+
The screenshot shows a part of downtown Berlin, Germany, close to "Zoologischer Garten". This is an area with a high density of people living, working, and travelling there; therefore, many different cells can be found there.
 
|-  
 
|-  
| [[File:OpenCellID_single_cells.png ‎|400px]] || Single cells are represented with this kind of pushpins.<br>For most of the GSM networks colours have been defined which are used for these pushpins.
+
| [[File:OpenCellID_single_cells.png ‎|400px]] || Single cells are represented with these pushpin icons.<br>Most of the GSM networks have defined colours which are used for these pushpins.
  
Clicking on such a pushpin shows some additional information of the cell as well as the associated measurements (max. 500)
+
Clicking on a pushpin will display additional information of the cell as well as the associated measurements (max. 500).
 
|-  
 
|-  
| [[File:OpenCellID_single_cell_with_measurements.png|198px]]    [[File:OpenCellID_single_cell_with_measurements-2.png|198px]] || When clicking on a single cell up to 500 measurements are shown representing this cell.
+
| [[File:OpenCellID_single_cell_with_measurements.png|198px]]    [[File:OpenCellID_single_cell_with_measurements-2.png|198px]] || When clicking on a single cell, up to 500 measurements are displayed representing this cell.
  
 
Thin lines are shown between each measurement and the (averaged) position.
 
Thin lines are shown between each measurement and the (averaged) position.
 
|-  
 
|-  
| [[File:OpenCellID_many_cells_in_one_place.png|400px]] || If there are multiple cells shown at the same position and the map shows the highest zoom level and you click on the bubble with these cells, then a spiral is shown with all known cells at that position.
+
| [[File:OpenCellID_many_cells_in_one_place.png|400px]] || If there are multiple cells shown at the same position and you click on the bubble with the map's highest zoom level, a spiral will be displayed with all known cells at that position.
  
Now you can click on each of the cells inside the spiral to see more details about each cell like
+
Now you can click on each of the cells inside the spiral to view further details for each cell, such as:
 
*network provider
 
*network provider
 
*MCC
 
*MCC
Line 33: Line 33:
 
*all measurements of this cell (max. 500)
 
*all measurements of this cell (max. 500)
  
And you can download the measurements of the selected cell as csv or kml file.
+
And you can download the measurements of the selected cell as a CSV or KML file.
 
|}
 
|}
  
Line 44: Line 44:
 
  |[[File:OpenCellID GPS positions of GSM base stations.png]]  
 
  |[[File:OpenCellID GPS positions of GSM base stations.png]]  
 
  || [[File:Menu map view GPS positions of GSM base stations.png|220px]]
 
  || [[File:Menu map view GPS positions of GSM base stations.png|220px]]
  || This filter option allows to see all known cell towers of a particular mobile phone network operator.
+
  || This filter option allows you to view all known cell towers of a particular mobile phone network operator.
  
 
<b>MCC</b><br>
 
<b>MCC</b><br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
The MCC defines the country where the network is located
+
The MCC defines the country where the network is located.
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
The MNC defines the network inside the country defined by MCC<br>
+
The MNC defines the network inside the country defined by the MCC.<br>
  
If you leave the MCC parameter empty and just define the MNC parameter, then you will get all networks world wide with the selected network number.
+
If you leave the MCC parameter empty and only define the MNC parameter, you will get all networks with the selected network number world wide.
  
If you leave the MNC parameter empty and just define the MCC parameter, then you will get all cells of all networks in the selected country.<br>
+
If you leave the MNC parameter empty and only define the MCC parameter, you will get all cells of all networks in the selected country.<br>
Please note, that such cells might be seen up to 34 km in the neighbouring country.
+
Please note that such cells may be seen up to 34 km in the neighbouring country.
 
  |- style="background-color:#dddddd;"
 
  |- style="background-color:#dddddd;"
 
  |[[File:OpenCellID newly found base stations.png]]  
 
  |[[File:OpenCellID newly found base stations.png]]  
Line 64: Line 64:
  
 
<b>date from</b><br>
 
<b>date from</b><br>
all newly found base stations will be shown found since this day 0:00:00 UTC time; if this field is left empty, then today 0:00:00 will be chosen as default.
+
All newly found base stations starting at 0:00:00 UTC time from the specified date will be displayed; if this field is left empty, today's date from 0:00:00 will be chosen by default.
  
 
<b>date to</b><br>
 
<b>date to</b><br>
all newly found base stations will be shown found until this day 23:59:59 UTC time; if this field is left empty, then today 23:59:59 will be chosen as default.
+
All newly found base stations up until 23:59:59 UTC time on the specified date will be displayed; if this field is left empty, today's date up until 23:59:59 will be chosen by default.
  
 
<b>MCC</b><br>
 
<b>MCC</b><br>
If selected only cells will be shown of the selected country.  
+
If selected, only cells of the selected country will be displayed.  
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
If selected only cells will be shown of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].  
+
If selected, only cells of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]] will be displayed.  
 
  |-
 
  |-
 
  |[[File:OpenCellID recently uploaded measurements.png|link=|link=http://opencellid.org/#&action=filters.recentlyUploadedBaseStationMeasurements&time=24]]  
 
  |[[File:OpenCellID recently uploaded measurements.png|link=|link=http://opencellid.org/#&action=filters.recentlyUploadedBaseStationMeasurements&time=24]]  
Line 80: Line 80:
  
 
<b>time in hours (max 24h)</b><br>
 
<b>time in hours (max 24h)</b><br>
Please enter here the number of hours from this moment in the past to be used for selecting the measurements to be shown on the map.
+
Please enter the number of hours to go back from the current moment for viewing the latest measurements on the map.
  
 
The maximum time frame is 24 hours.
 
The maximum time frame is 24 hours.
  
The time frame is selected from the current time the given number of hours to the past.<br>
+
The time frame is selected from the current time to the given number of hours going back in time.<br>
 
Example:<br>
 
Example:<br>
if at 12:13:59 a time frame of 22 hours is selected, then 10:13:59 (not 10:00:00) until 12:13:59 would be the selected time frame.
+
If at 12:13:59 a time frame of 22 hours is selected, then 10:13:59 (not 10:00:00) until 12:13:59 would be the selected time frame.
 
  |- style="background-color:#dddddd;"
 
  |- style="background-color:#dddddd;"
 
  |[[File:OpenCellID measurements of a selected GSM base station.png]]  
 
  |[[File:OpenCellID measurements of a selected GSM base station.png]]  
Line 94: Line 94:
 
<b>MCC</b><br>
 
<b>MCC</b><br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
The MCC defines the country where the network is located
+
The MCC defines the country where the network is located.
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
The MNC defines the network inside the country defined by MCC<br>
+
The MNC defines the network inside the country defined by the MCC.<br>
  
 
<b>LAC</b><br>
 
<b>LAC</b><br>
 
Please enter here the [[Glossary#LAC_-_Location_Area_Code|Location Area Code]].<br>
 
Please enter here the [[Glossary#LAC_-_Location_Area_Code|Location Area Code]].<br>
The LAC defines a group of base stations belonging regionally together.<br>
+
The LAC defines a group of base stations that belong together regionally.<br>
  
 
<b>cell-id</b><br>
 
<b>cell-id</b><br>
Please enter here the [[Glossary#Cell-ID|cell-id]].<br>
+
Please enter here the [[Glossary#Cell-ID|Cell ID]].<br>
The cell-id defines the number of the cell of which you want to see the data.<br>
+
The Cell ID defines the number of the cell of which you want to see the data.<br>
  
All four entry fields are obligatory. If at least one field is left empty, no data is shown.
+
All four entry fields are obligatory. If even one field is left empty, no data will be displayed.
  
Maximum 500 measurements are displayed on the map for the selected cell due to restrictions of the currently available web browsers.
+
Maximum 500 measurements are displayed on the map for the selected cell due to restrictions of the web browsers that are currently available.
 
   |}
 
   |}
 
|}
 
|}
Line 123: Line 123:
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"  
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"  
 
  |[[File:OpenCellID daily heat map.png|link=http://opencellid.org/#&action=heatMaps.dailyHeatmap]]  
 
  |[[File:OpenCellID daily heat map.png|link=http://opencellid.org/#&action=heatMaps.dailyHeatmap]]  
  || This menu option allows to to display the latest heat map.<br>
+
  || This menu option allows you to display the latest heat map.<br>
 
The heat map indicates the density of unique base stations world wide.
 
The heat map indicates the density of unique base stations world wide.
*Red areas have a high density of known cell towers.
+
*red areas have a high density of known cell towers.
*Yellow areas have a reasonable density of known cell towers.
+
*yellow areas have a reasonable density of known cell towers.
*Blue and green areas have a low density of known cell towers.
+
*blue and green areas have a low density of known cell towers.
*For areas which are not coloured so far no cell towers have been recorded.
+
*areas which are not coloured indicate that no cell towers have been recorded as of yet.
  
 
The heat map data (the tiles) is generated in real time when requesting the map.<br>
 
The heat map data (the tiles) is generated in real time when requesting the map.<br>
You can zoom in to the map by double clicking on any desired position on the map, by turning the mouse wheel or by pushing the "+" or "-" button on your keyboard.
+
You can zoom in to the map by double clicking on any desired position on the map, by turning the mouse wheel, or by pushing the "+" or "-" button on your keyboard.
  
 
  |- style="background-color:#dddddd;"
 
  |- style="background-color:#dddddd;"
 
  |[[File:OpenCelID heat map movie.png|link=http://opencellid.org/#&action=heatMaps.heatmapMovie]]  
 
  |[[File:OpenCelID heat map movie.png|link=http://opencellid.org/#&action=heatMaps.heatmapMovie]]  
  || The heat map move provides a good impression how the database has been growing over time in which region.
+
  || The heat map movie provides a good overview on how the database has been growing over time in which region.
  
Every day one heat map frame is created and stored right after completing the nightly creation of the download files. In order to keep the movie length at 45 seconds the movie shows selected frames only from the very beginning of the OpenCellID project until today.<br>The displayed frames are selected as follows: if we have frames from 4 years (365 days * 4 years = 1460 days), then the app shows frames generated every 32 days (1460 days / 45 frames total movie length).
+
Every day, one heat map frame is created and stored right after completing the nightly creation of the download files. In order to keep the movie length at 45 seconds, the movie only shows selected frames from the very beginning of the OpenCellID project until today.<br>The displayed frames are selected as follows: if we have frames from 4 years (365 days * 4 years = 1460 days), then the app shows frames generated every 32 days (1460 days / 45 frames total movie length).
  
 
It is not possible to zoom into the heat map movie.
 
It is not possible to zoom into the heat map movie.
Line 152: Line 152:
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"
 
  |[[File:OpenCellID statistics cells.png]]  
 
  |[[File:OpenCellID statistics cells.png]]  
  || This option allows to generate a real time bar chart assorted by the number of cells.<br>
+
  || This option allows you to generate a real-time bar chart assorted by the number of cells.<br>
 
<br>
 
<br>
 
<u>The following sorting criteria can be used for the bar chart:</u>
 
<u>The following sorting criteria can be used for the bar chart:</u>
  
 
<b>sorted by the total</b><br>
 
<b>sorted by the total</b><br>
shows the total number of cells per country stored in the database;<br>
+
This shows the total number of cells per country stored in the database;<br>
the countries are sorted descending by the total of cells per country
+
the countries are sorted descending by the total of cells per country.
  
 
<b>sorted by country name</b><br>
 
<b>sorted by country name</b><br>
shows the total number of cells per country stored in the database;<br>
+
This shows the total number of cells per country stored in the database;<br>
the countries are sorted alphabetically ascending by country name
+
the countries are sorted alphabetically ascending by country name.
  
 
<b>sorted by MCC</b><br>
 
<b>sorted by MCC</b><br>
shows the total number of cells per country stored in the database;<br>
+
This shows the total number of cells per country stored in the database;<br>
 
the countries are sorted ascending by [[Glossary#MCC_-_Mobile_Country_Code|MCC]]
 
the countries are sorted ascending by [[Glossary#MCC_-_Mobile_Country_Code|MCC]]
  
 
<b>new cells per day</b><br>
 
<b>new cells per day</b><br>
shows the number of first time found cells per calender day;<br>
+
This shows the number of newly discovered cells per calender day;<br>
the calender days are sorted descending (latest date on the left side of the bar chart)
+
the calender days are sorted descending (latest date on the left side of the bar chart).
 
<br>
 
<br>
 
<br>
 
<br>
Line 176: Line 176:
  
 
<b>date from</b><br>
 
<b>date from</b><br>
all newly found base stations will be used for the bar chart found after this day 0:00:00 UTC time;<br>
+
All newly found base stations found after the specified day at 0:00:00 UTC time will be used for the bar chart;<br>
if this field is left empty, then today 0:00:00 will be chosen as default
+
if this field is left empty, today's date at 0:00:00 will be chosen by default.
  
 
<b>date to</b><br>
 
<b>date to</b><br>
all newly found base stations will be used for the bar chart that were found until the specified day 23:59:59 UTC time;<br>
+
All newly found base stations found up until the specified day 23:59:59 UTC time will be used for the bar chart;<br>
if this field is left empty, then today 23:59:59 will be chosen as default
+
if this field is left empty, today's date until 23:59:59 will be chosen by default.
  
 
<b>MCC</b><br>
 
<b>MCC</b><br>
if selected only cells will be shown of the selected country.  
+
If selected, only cells of the selected country will be displayed.  
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
if selected only cells will be shown of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]]  
+
If selected, only cells of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]] will be displayed.
 
  |}
 
  |}
 
|}
 
|}
Line 200: Line 200:
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"
 
  {|style="font-size:100% border-collapse:collapse"; text-align="left" border="0" cellspacing="0" cellpadding="10"
 
  |[[File:OpenCellID statistics measurements.png]]  
 
  |[[File:OpenCellID statistics measurements.png]]  
  || This option allows to generate a real time bar chart assorted by the number of measurements.<br>
+
  || This option allows you to generate a real-time bar chart assorted by the number of measurements.<br>
 
<br>
 
<br>
 
<u>The following sorting criteria can be used for the bar chart:</u>
 
<u>The following sorting criteria can be used for the bar chart:</u>
  
 
<b>sorted by the total</b><br>
 
<b>sorted by the total</b><br>
shows the total number of measurements per country stored in the database;<br>
+
This shows the total number of measurements per country stored in the database;<br>
the countries are sorted descending by the total of measurements per country
+
the countries are sorted descending by the total of measurements per country.
  
 
<b>sorted by country name</b><br>
 
<b>sorted by country name</b><br>
shows the total number of measurements per country stored in the database;<br>
+
This shows the total number of measurements per country stored in the database;<br>
the countries are sorted alphabetically ascending by country name
+
the countries are sorted alphabetically ascending by country name.
  
 
<b>sorted by MCC</b><br>
 
<b>sorted by MCC</b><br>
shows the total number of measurements per country stored in the database;<br>
+
This shows the total number of measurements per country stored in the database;<br>
the countries are sorted ascending by [[Glossary#MCC_-_Mobile_Country_Code|MCC]]
+
the countries are sorted ascending by [[Glossary#MCC_-_Mobile_Country_Code|MCC]].
  
 
<b>new measurements per day</b><br>
 
<b>new measurements per day</b><br>
shows the number of newly added measurements per calender day;<br>
+
This shows the number of newly added measurements per calender day;<br>
the calender days are sorted descending (latest date on the left side of the bar chart)
+
the calender days are sorted descending (latest date on the left side of the bar chart).
 
<br>
 
<br>
 
<br>
 
<br>
Line 224: Line 224:
  
 
<b>date from</b><br>
 
<b>date from</b><br>
all measurements added to the database after this day 0:00:00 UTC time will be used for the bar chart;<br>
+
All measurements added to the database after the specified day at 0:00:00 UTC time will be used for the bar chart;<br>
if this field is left empty, then today 0:00:00 will be chosen as default
+
if this field is left empty, today's date at 0:00:00 will be chosen by default.
  
 
<b>date to</b><br>
 
<b>date to</b><br>
all measurements added to the database before this day 23:59:29 UTC time will be used for the bar chart;<br>
+
All measurements added to the database before the specified day until 23:59:29 UTC time will be used for the bar chart;<br>
if this field is left empty, then today 23:59:59 will be chosen as default
+
if this field is left empty, today's date until 23:59:59 will be chosen by default.
  
 
<b>MCC</b><br>
 
<b>MCC</b><br>
if selected only measurements will be shown of the selected country.  
+
If selected, only measurements of the selected country will be displayed.  
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
if selected only measurements will be shown of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]]  
+
If selected, only measurements of networks with the selected [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]] will be displayed.
 
  |}
 
  |}
 
|}
 
|}
Line 248: Line 248:
 
  |[[File:OpenCellID_GPS_location.png]]
 
  |[[File:OpenCellID_GPS_location.png]]
 
  || [[File:Menu map view GPS positions of GSM base stations.png|220px]]  
 
  || [[File:Menu map view GPS positions of GSM base stations.png|220px]]  
  || This menu option allows entering a [http://en.wikipedia.org/wiki/GPS GPS] coordinate, consisting of a [http://en.wikipedia.org/wiki/Latitude latitude] and a [http://en.wikipedia.org/wiki/Longitude longitude] value.
+
  || This menu option allows you to enter a [http://en.wikipedia.org/wiki/GPS GPS] coordinate, consisting of a [http://en.wikipedia.org/wiki/Latitude latitude] and a [http://en.wikipedia.org/wiki/Longitude longitude] value.
  
 
This position will then be shown on the map, indicated by a special pushpin icon.
 
This position will then be shown on the map, indicated by a special pushpin icon.
Line 260: Line 260:
 
<b>MCC</b><br>
 
<b>MCC</b><br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
 
Please enter here the [[Glossary#MCC_-_Mobile_Country_Code|Mobile Country Code]].<br>
The MCC defines the country where the network is located
+
The MCC defines the country where the network is located.
  
 
<b>MNC</b><br>
 
<b>MNC</b><br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
 
Please enter here the [[Glossary#MNC_-_Mobile_Network_Code|Mobile Network Code]].<br>
The MNC defines the network inside the country defined by MCC<br>
+
The MNC defines the network inside the country defined by the MCC.<br>
  
 
<b>LAC</b><br>
 
<b>LAC</b><br>
 
Please enter here the [[Glossary#LAC_-_Location_Area_Code|Location Area Code]].<br>
 
Please enter here the [[Glossary#LAC_-_Location_Area_Code|Location Area Code]].<br>
The LAC defines a group of base stations belonging regionally together.<br>
+
The LAC defines a group of base stations that belong together regionally.<br>
  
 
<b>cell-id</b><br>
 
<b>cell-id</b><br>
Please enter here the [[Glossary#Cell-ID|cell-id]].<br>
+
Please enter here the [[Glossary#Cell-ID|Cell ID]].<br>
The cell-id defines the number of the cell of which you want to see the data.<br>
+
The Cell ID defines the number of the cell of which you want to see the data.<br>
  
 
All input fields are obligatory.
 
All input fields are obligatory.
Line 287: Line 287:
 
  | [[File:OpenCellID download database.png]]
 
  | [[File:OpenCellID download database.png]]
 
  || [[File:OpenCellID_download_database_file_list.png|220px]]  
 
  || [[File:OpenCellID_download_database_file_list.png|220px]]  
  || This menu option allows to download the database.<br>File formats:<br>
+
  || This menu option allows you to download the database.<br>File formats:<br>
  
=== measurements_?.csv file format===
+
=== measurements_? CSV file format===
 
{| class="wikitable sortable" style="font-size: 85%; text-align: left;"
 
{| class="wikitable sortable" style="font-size: 85%; text-align: left;"
 
|-
 
|-
Line 401: Line 401:
 
  | [[File:OpenCellID upload.png]]  
 
  | [[File:OpenCellID upload.png]]  
 
  || [[File:Menu database upload.png|220px]]  
 
  || [[File:Menu database upload.png|220px]]  
  || This menu option allows to upload [[Glossary#Measurement|measurements]] to the OpenCellID database.
+
  || This menu option allows you to upload [[Glossary#Measurement|measurements]] to the OpenCellID database.
  
 
The [[API#apiKey|apiKey]] is obligatory for uploading data.
 
The [[API#apiKey|apiKey]] is obligatory for uploading data.
  
The data must be provided in a csv file. The required format of the csv file is specified [[API#Uploading_measurements_from_CSV_file|here]].
+
The data must be provided in a CSV file. The required format of the CSV file is specified [[API#Uploading_measurements_from_CSV_file|here]].
 
  |-
 
  |-
 
  | [[File:OpenCellID api key.png]]
 
  | [[File:OpenCellID api key.png]]
 
  || [[File:Menu database request apiKey.png|220px]]  
 
  || [[File:Menu database request apiKey.png|220px]]  
 
  || <b>name</b><br>
 
  || <b>name</b><br>
pls provide a unique name or nickname;<br>
+
Please provide a unique name or nickname;<br>
this will later be used for the leader list and other personalized statistics
+
this will be used later for the leader list and other personalised statistics.
  
 
<b>e-mail</b><br>
 
<b>e-mail</b><br>
a valid e-mail address is required to register for an apiKey;<br>
+
A valid e-mail address is required to register for an apiKey;<br>
this e-mail address will not be used for anything that is not related to OpenCellID;<br>
+
this e-mail address will not be used for anything that is unrelated to OpenCellID;<br>
it will neither be sold nor otherwise distributed to any third party
+
it will neither be sold nor otherwise distributed to a third party.
 
   
 
   
 
<b>password</b><br>
 
<b>password</b><br>
this password will later be required to access your personal OpenCellID data
+
This password will be required later to access your personal OpenCellID data.
 
   
 
   
 
<b>confirm password</b><br>
 
<b>confirm password</b><br>
please re-enter your password here for securing that there is no misspelling
+
Please re-enter your password here to ensure that there are no spelling mistakes.
 
  |}
 
  |}
 
|}
 
|}

Revision as of 02:02, 30 January 2014

map view

OpenCellID map view cell bubbles.png In most cases the map shows bubbles of different sizes and colour.

The bigger a bubble is, the more cells have been found close to this bubble.

Smaller bubbles are green, mid-sized bubbles are yellow, and larger bubbles are orange or red.

The screenshot shows a part of downtown Berlin, Germany, close to "Zoologischer Garten". This is an area with a high density of people living, working, and travelling there; therefore, many different cells can be found there.

OpenCellID single cells.png Single cells are represented with these pushpin icons.
Most of the GSM networks have defined colours which are used for these pushpins.

Clicking on a pushpin will display additional information of the cell as well as the associated measurements (max. 500).

OpenCellID single cell with measurements.png OpenCellID single cell with measurements-2.png When clicking on a single cell, up to 500 measurements are displayed representing this cell.

Thin lines are shown between each measurement and the (averaged) position.

OpenCellID many cells in one place.png If there are multiple cells shown at the same position and you click on the bubble with the map's highest zoom level, a spiral will be displayed with all known cells at that position.

Now you can click on each of the cells inside the spiral to view further details for each cell, such as:

  • network provider
  • MCC
  • MNC
  • LAC
  • CID
  • latitude
  • longitude
  • all measurements of this cell (max. 500)

And you can download the measurements of the selected cell as a CSV or KML file.

map filter options

OpenCellID menu complete.png
OpenCellID GPS positions of GSM base stations.png Menu map view GPS positions of GSM base stations.png This filter option allows you to view all known cell towers of a particular mobile phone network operator.

MCC
Please enter here the Mobile Country Code.
The MCC defines the country where the network is located.

MNC
Please enter here the Mobile Network Code.
The MNC defines the network inside the country defined by the MCC.

If you leave the MCC parameter empty and only define the MNC parameter, you will get all networks with the selected network number world wide.

If you leave the MNC parameter empty and only define the MCC parameter, you will get all cells of all networks in the selected country.
Please note that such cells may be seen up to 34 km in the neighbouring country.

OpenCellID newly found base stations.png Menu map view newly found base stations.png Show newly found base stations with the following filtering options:

date from
All newly found base stations starting at 0:00:00 UTC time from the specified date will be displayed; if this field is left empty, today's date from 0:00:00 will be chosen by default.

date to
All newly found base stations up until 23:59:59 UTC time on the specified date will be displayed; if this field is left empty, today's date up until 23:59:59 will be chosen by default.

MCC
If selected, only cells of the selected country will be displayed.

MNC
If selected, only cells of networks with the selected Mobile Country Code will be displayed.

OpenCellID recently uploaded measurements.png Menu map view recently uploaded measurements.png Show recently uploaded measurements:

time in hours (max 24h)
Please enter the number of hours to go back from the current moment for viewing the latest measurements on the map.

The maximum time frame is 24 hours.

The time frame is selected from the current time to the given number of hours going back in time.
Example:
If at 12:13:59 a time frame of 22 hours is selected, then 10:13:59 (not 10:00:00) until 12:13:59 would be the selected time frame.

OpenCellID measurements of a selected GSM base station.png Menu map view measurements of a selected GSM base station.png Show measurements of a selected GSM base station

MCC
Please enter here the Mobile Country Code.
The MCC defines the country where the network is located.

MNC
Please enter here the Mobile Network Code.
The MNC defines the network inside the country defined by the MCC.

LAC
Please enter here the Location Area Code.
The LAC defines a group of base stations that belong together regionally.

cell-id
Please enter here the Cell ID.
The Cell ID defines the number of the cell of which you want to see the data.

All four entry fields are obligatory. If even one field is left empty, no data will be displayed.

Maximum 500 measurements are displayed on the map for the selected cell due to restrictions of the web browsers that are currently available.



heat map

Menu heat map.png
OpenCellID daily heat map.png This menu option allows you to display the latest heat map.

The heat map indicates the density of unique base stations world wide.

  • red areas have a high density of known cell towers.
  • yellow areas have a reasonable density of known cell towers.
  • blue and green areas have a low density of known cell towers.
  • areas which are not coloured indicate that no cell towers have been recorded as of yet.

The heat map data (the tiles) is generated in real time when requesting the map.
You can zoom in to the map by double clicking on any desired position on the map, by turning the mouse wheel, or by pushing the "+" or "-" button on your keyboard.

OpenCelID heat map movie.png The heat map movie provides a good overview on how the database has been growing over time in which region.

Every day, one heat map frame is created and stored right after completing the nightly creation of the download files. In order to keep the movie length at 45 seconds, the movie only shows selected frames from the very beginning of the OpenCellID project until today.
The displayed frames are selected as follows: if we have frames from 4 years (365 days * 4 years = 1460 days), then the app shows frames generated every 32 days (1460 days / 45 frames total movie length).

It is not possible to zoom into the heat map movie.



statistics cells

Menu statistics cells.png
OpenCellID statistics cells.png This option allows you to generate a real-time bar chart assorted by the number of cells.


The following sorting criteria can be used for the bar chart:

sorted by the total
This shows the total number of cells per country stored in the database;
the countries are sorted descending by the total of cells per country.

sorted by country name
This shows the total number of cells per country stored in the database;
the countries are sorted alphabetically ascending by country name.

sorted by MCC
This shows the total number of cells per country stored in the database;
the countries are sorted ascending by MCC

new cells per day
This shows the number of newly discovered cells per calender day;
the calender days are sorted descending (latest date on the left side of the bar chart).

The following filter criteria can be used for the bar chart:

date from
All newly found base stations found after the specified day at 0:00:00 UTC time will be used for the bar chart;
if this field is left empty, today's date at 0:00:00 will be chosen by default.

date to
All newly found base stations found up until the specified day 23:59:59 UTC time will be used for the bar chart;
if this field is left empty, today's date until 23:59:59 will be chosen by default.

MCC
If selected, only cells of the selected country will be displayed.

MNC
If selected, only cells of networks with the selected Mobile Country Code will be displayed.



statistics measurements

Menu statistics measurements.png
OpenCellID statistics measurements.png This option allows you to generate a real-time bar chart assorted by the number of measurements.


The following sorting criteria can be used for the bar chart:

sorted by the total
This shows the total number of measurements per country stored in the database;
the countries are sorted descending by the total of measurements per country.

sorted by country name
This shows the total number of measurements per country stored in the database;
the countries are sorted alphabetically ascending by country name.

sorted by MCC
This shows the total number of measurements per country stored in the database;
the countries are sorted ascending by MCC.

new measurements per day
This shows the number of newly added measurements per calender day;
the calender days are sorted descending (latest date on the left side of the bar chart).

The following filter criteria can be used for the bar chart:

date from
All measurements added to the database after the specified day at 0:00:00 UTC time will be used for the bar chart;
if this field is left empty, today's date at 0:00:00 will be chosen by default.

date to
All measurements added to the database before the specified day until 23:59:29 UTC time will be used for the bar chart;
if this field is left empty, today's date until 23:59:59 will be chosen by default.

MCC
If selected, only measurements of the selected country will be displayed.

MNC
If selected, only measurements of networks with the selected Mobile Country Code will be displayed.



search location

Menu search location GPS location.png
OpenCellID GPS location.png Menu map view GPS positions of GSM base stations.png This menu option allows you to enter a GPS coordinate, consisting of a latitude and a longitude value.

This position will then be shown on the map, indicated by a special pushpin icon.

Both input fields are obligatory.

OpenCellID collect data.png Menu search location cellid entry field.png Show position of selected cell

MCC
Please enter here the Mobile Country Code.
The MCC defines the country where the network is located.

MNC
Please enter here the Mobile Network Code.
The MNC defines the network inside the country defined by the MCC.

LAC
Please enter here the Location Area Code.
The LAC defines a group of base stations that belong together regionally.

cell-id
Please enter here the Cell ID.
The Cell ID defines the number of the cell of which you want to see the data.

All input fields are obligatory.



database

Menu database.png
OpenCellID download database.png OpenCellID download database file list.png This menu option allows you to download the database.
File formats:

measurements_? CSV file format

Parameter Data type Description
<mcc> integer Mobile country code
<mnc> integer Mobile network code
<lac> integer Local area code
<cellid> integer Cell tower id
<lon> double Longitude
<lat> double Latitude
<signal> integer Signal level
??? measurement unit ???
<measured_at> date When the measurement was measured.
Returns a date in timestamp format:
milliseconds since 1/1/1970 00:00:00 GMT;
time zone: UTC
<created_at> date When the measurement was added to OpenCellID database.
Returns a date in timestamp format:
milliseconds since 1/1/1970 00:00:00 GMT;
time zone: UTC
<rating> integer GPS quality/accuracy information
<speed> integer Speed when measuring the measurement
<direction> integer Heading direction when creating the measurement (0=north, 90=east)

cell_towers.csv file format

Parameter Data type Description
<mcc> integer Mobile country code
<mnc> integer Mobile network code
<lac> integer Local area code
<cellid> integer Cell tower id
<lon> double Longitude
changeable=1: average of longitude values of all related measurements
changeable=0: exact GPS position of the tower
<lat> double Latitude
changeable=1: average of latitude values of all related measurements
changeable=0: exact GPS position of the tower
<samples> integer Number of measurements assigned to the cell tower
<changeable> integer Defines if coordinates of the cell tower are exact or approximate;
1: the GPS position of the cell tower has been calculated from all available measurements
0: the GPS position of the cell tower is precise; no measurements have been used to calculate it.
<created_at> date When the cell tower was added to the OpenCellID database.
Returns a date in timestamp format:
milliseconds since 1/1/1970 00:00:00 GMT
time zone: UTC
<updated_at> date When was the last update of the cell tower.
Returns a date in timestamp format:
(milliseconds since 1/1/1970 00:00:00 GMT
time zone: UTC
<averageSignal> integer Average signal level of assigned measurements
??? measurement unit ???
OpenCellID upload.png Menu database upload.png This menu option allows you to upload measurements to the OpenCellID database.

The apiKey is obligatory for uploading data.

The data must be provided in a CSV file. The required format of the CSV file is specified here.

OpenCellID api key.png Menu database request apiKey.png name

Please provide a unique name or nickname;
this will be used later for the leader list and other personalised statistics.

e-mail
A valid e-mail address is required to register for an apiKey;
this e-mail address will not be used for anything that is unrelated to OpenCellID;
it will neither be sold nor otherwise distributed to a third party.

password
This password will be required later to access your personal OpenCellID data.

confirm password
Please re-enter your password here to ensure that there are no spelling mistakes.