Surveillance under Surveillance

Surveillance under Surveillance shows you cameras and guards — watching you — almost everywhere. You can see where they are located and, if the information is available, what type they are, the area they observe, or other interesting facts.

Different icons and colors give you a quick overview about the indexed surveillance entries. Click on those icons on the map to get the available information.

Icon	Description
	Camera — no further information
	Fixed camera — usually observing a limited area
	Panning camera — usually able to observe various areas
	Dome camera — usually observing a 360° area
	Guard — e.g. an employee of a security service
	ALPR — Automatic Licence Plate Recognition

Color	Description
	Red background — observing a public outdoor area, accessable by everyone
	Blue background — observing a private outdoor area, accessable only by authorized persons
	Green background — observing an indoor area
	Yellow icon — camera or guard marked with a fixme key because it needs further attention

A running instance of this project can be visited at https://sunders.uber.space/.

Prerequisites

• Docker

Installation

To run Surveillance using docker, decide between development/testing or production deployments:

Development/testing

1. Clone this repository

2. Run docker compose up and wait for services to start up

3. Visit http://localhost:8080/ in a browser; you should see an interactive OpenStreetMap

tbd.: Populate camera data

Production

1. Close this repository

2. Hardern security by opening docker-compose.yml and modifying MYSQL_PASSWORD and MYSQL_ROOT_PASSWORD

3. Run docker compose up and wait for services to start up

4. Visit http://localhost:8080/ in a browser to open the web interface

tbd.: Populate camera data

Surveillance nodes

Surveillance under Surveillance uses data from Openstreetmap contributors that is not visualized on the regular Openstreetmap site. If you like to add new cameras or guards or if you like to revise existing entries use your existing OSM account or create a new one.

These are the most common key/value combinations to describe a surveillance node at Openstreetmap:

Mandatory to display an icon on the map

Icon	Key	Value
man_made	surveillance
	surveillance	public
	surveillance	outdoor
	surveillance	indoor
	surveillance:type	camera
	surveillance:type camera:type	camera fixed
	surveillance:type camera:type	camera panning
	surveillance:type camera:type	camera dome
	surveillance:type	guard
	surveillance:type	ALPR

Mandatory to draw camera's field of view

Key	Value
surveillance:type	camera
camera:type	fixed
camera:direction	0 - 360 (in degrees) or N / NE / E / SE / S / SW / W / NW
camera:angle	15 - 90 (in degrees) from an almost horizontal view to a ground-pointed camera default: 15°
height	3 - 12 (in meters) default: 5m

Example 1	Example 2	Example 3
direction = 90° angle = 15° height = 5m	direction = 90° angle = 15° height = 10m	direction = 90° angle = 60° height = 10m

Optional

Key	Value
surveillance:zone	bank / building / parking / shop / town / traffic
camera:mount	ceilling / pole / wall
operator	organization or person operating the camera
name	name of the camera
ref	reference number of the camera
image	link to an externally hosted image that depicts the surveillance object

Credits

• Surveillance under Surveillance is based on the phantastic osmcamera [CC-BY-SA / MIT / GPLv3 / WTFPL] project of khris78.
• Furthermore it uses the v1.3.1 code of Leaflet/Leaflet [BSD-2-Clause].
• The map itself is the work of millions of OpenStreetMap [ODbL / CC BY-SA] contributors.
• The results of the web services OpenStreetMap Nominatim [ODbL] and GeoNames [CC BY 3.0] are used for location searching and for surveillance node statistics.
• Most of the icons are from Font Awesome [SIL OFL 1.1 / MIT / CC BY 3.0].
• The font Grabstein Grotesk [OLF] is used for the titles.