DanielPitfield / Crime-Mapper

A web-based crime mapping, visualisation and analysis solution using the Google Maps JavaScript API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Crime Mapper

A web-based crime mapping, visualisation and analysis solution using the Google Maps JavaScript API

JavaScript jQuery Google Cloud PHP MySQL HTML Bootstrap

Home

Table of Contents

Usage / Instructions

Crime Icons

Icon Description Icon Description
Violence Violence against the person Weapons Possession of weapons
Public Order Public Order Theft Theft
Drugs Drug offences Burglary Burglary
Vehicle Vehicle offences Robbery Robbery
Sexual Sexual offences Misc Miscellaneous crimes
Arson Arson and criminal damage Other Other

Add Crime

1) Right click anywhere on the map and select the 'Add Crime' option (from the context menu which appears):

Add_Context_Menu

2) Enter the crime's information using the input fields:

(Note: The crime location can be adjusted using the marker and smaller map provided)

Add_Modal

3) Click the 'Confirm' button for the crime to be added to the mapper:

Add_Marker

View Crime

1) Left clicking on a marker will open a small window displaying information about the crime (current properties):

View

Edit Crime

1) From the 'View Crime' for a crime, click the 'Edit' button:

Edit

2) Edit the crime's information using the input fields:

(Note: The inputs fields will begin as to reflect the crime's current information)

Edit_Modal

3) Click the 'Confirm' button to save the edits made.

Delete Crime

1) To remove a single instance of crime, from the 'View Crime' for a crime, click the 'Delete' button:

(Note: This will permanently remove the crime marker from the mapper).

Delete

Filter Crime

1) From the main toolbar, click the 'Filter Crime' button:

Filter

2) Enter the desired filter criteria with the provided fields:

(Note: Where there are two fields for a crime attribute, the first field is a minimum value and the second field is a maximum value)

Filter_Modal

2.1) To include a geographic area in the filter criteria, first click on the smaller map provided:

Filter_Map

2.2) This will enable the 'Search Radius (miles)' field. Selecting a radius will display the area to filter by on the map:

Filter_Radius

3) Click the 'Confirm' button to filter all markers by the constructed filter criteria.

Clear Filter

1) Click the 'Clear Filter' button at the top of the window:

Filter_Clear

2) (Optional) Click the 'Confirm' button to show all markers (apply no filter).

Filter by ID

1) Enter an ID in the field at the top of the window:

Filter_ID

2) Click the search button (beside the input field).

Delete Filtered Crime

1) All the crimes that meet the currently active filter criteria can be deleted all at once by clicking the 'Delete Filtered (Visible) Markers' button:

Filter_Delete

2) A progress bar showing the deletion process will appear:

Filter_Delete_Progress

3) Once the process has finished, the mapper will reload (and the deletions made will be reflected on the mapper).

Import Crime

1) From the main toolbar, click the 'Import Crime' button:

Import

2) (Optional) Click the 'Download Template' button to begin creating an import file OR the 'Browse Files' to be navigated to supported data downloads:

Import_Download

3) Click the 'Browse' button and select the file to import using the dialog:

Import_Browse

4) Click the 'Import' button to begin importing the selected file.

5) The two progress bars will update (the top bar showing progress of the file upload and the bottom bar showing the progress of the import process):

Import_Progress

6) Once the import process has finished (both progress bars complete), the mapper will reload (and the insertions made will be reflected on the mapper):

Import_Marker

Analyse Crime

1) From the main toolbar, click the 'Analyse Crime' button:

Analyse

2) Markers will be grouped into clusters based on how close they are to other markers (representing the density of crime). The number of crimes in each cluster is shown with white text (in the middle of the cluster icon):

Analyse

Cluster Icons

The three different cluster icons and the minimum number of crimes they represent is shown in the table below:

Cluster Amount
Violence 2 - 9
Violence 10 - 99
Violence 100+

3) To turn off the clustering, click the 'Analyse Crime' button again (the button acts as a toggle).

Predict Crime

Not yet implemented.

Known Issues

  • Database configuration details tracked within version control
  • API calls (and therefore the API key) are client-side
  • IE11 is not supported
  • Not responsive for mobile devices
  • Larger resolutions (above 1920x1080) are untested

About

A web-based crime mapping, visualisation and analysis solution using the Google Maps JavaScript API


Languages

Language:JavaScript 61.5%Language:PHP 31.7%Language:CSS 6.8%