The Map Report helps visualize data. If each case has latitude and longitude data associated with it, then it can be displayed on the map as a marker. This allows coverage of a geographical area to be reviewed in a glance. Each marker displays additional information if clicked on and allows the opening of the case for viewing.
- Upload dictionary and data
- Import labels (optional)
- Add a database
- Add a configuration
- Check Enable Map Report
- Run CSWeb command line process
Upload the dictionary and then the data to the Data page. If the dictionary and data were already uploaded then this step can be skipped. However, the dictionary and data must include latitude and longitude data for each case. Otherwise, the case will not be displayed on the map.
By default only codes will be shown for id items. Id items appear as values for filters and optionally in the popup dialog. However, a CSV file can be imported that defines code and label pairs, so a label can be displayed in its place. The rules for defining these pairs are as follows:
- The first pair in the CSV file must define the first dictionary id
- Each following pair must correspond to a dictionary id in consecutive order
- Dictionary ids do not require a corresponding pair. However, once a dictionary id has been ignored no more can be defined. The code will be displayed.
Labels are imported by clicking the Import Report Labels button on the Data page.
Add a new database to using the MySQL command line, MySQL workbench, or phpMyAdmin. Create a user with access to the new database. For security reasons the database user should have a corresponding password. This database is different than the database created during the setup of CSWeb. The database will hold relational data after
processing cases.
See instructions for
Add Configuration. At the bottom of the
Add Configuration dialog check the
Enable Map Report checkbox. Then the following configuration details can be entered.
- Tile provider: Allows the selection of the source of base maps (Esri, Mapbox, or local files).
- Access token: Only necessary if Mapbox was selected as the tile provider. Access tokens can be managed from the access tokens page once a Mapbox account has been created.
- Latitude: Specify the latitude field in the dictionary.
- Longitude: Specify the longitude field in the dictionary.
- Map popup items (max 5): Customize the popup dialog for each marker with additional data from the dictionary. A maximum of five options can be selected.
See instructions for
Processing Cases. Note that this is not a one-time operation. During data collection the command line process will need to be run repeatedly to update the data displayed on the map.
Click Map Report on the sidebar to display the map.
- Zoom: Located in the top left-hand corner of the map. Press the + icon to zoom out and the - icon to zoom in. Alternatively, the mouse wheel will zoom in and out.
- Filter: Located below the zoom icon. Two levels of filtering are available. They will correspond to the first two id items in the dictionary. A selected filter will filter which map markers are shown on the map.
- Base map: Located in the top right-hand corner of the map. Select one of four different types (normal, hybrid, satellite, terain) of maps to display.
- Map popup dialog: Click on a marker and a popup dialog will display. By default this dialog will include the case key, latitude, longitude, and a View Case link to open the case for viewing. Additional information from Map popup items (max 5) will be included if selected.