Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

data/presets: add surveillance and camera related properties #3599

Merged

Conversation

bkil
Copy link
Contributor

@bkil bkil commented Nov 19, 2016

https://wiki.openstreetmap.org/wiki/Tag:man_made%3Dsurveillance
https://wiki.openstreetmap.org/wiki/Proposed_features/Extended_tags_for_Key:Surveillance

These are mandatory tags:

  • surveillance
  • surveillance:type

I do not feel that the following are important, they can be selected from
the drop down manually anyway:

  • operator
  • name

These tags are well established:

  • camera:type has 15k users
  • camera:mount has 13k users
  • surveillance:zone has 17k users (mostly traffic is noted)
  • camera:direction has 6k users

These tags are in the proposed status:

  • contact:webcam usage is only starting
  • height

People used various tags instead of contact:webcam in the past
because of it being a recent tag, and/or a lack of knowledge or being
mislead by the dropdown.

Thus it is difficult to quote an exact number, but by using complex
regexp queries, I could find thousands of usages for webcam links
when properly combining man_made/surveillance/camera and various
(sometimes invalid) keywords in the key or value part of a tag:

  • website
  • image
  • uri, url, link, http, contact
  • stream
  • webcam

Copy link
Member

@bhousel bhousel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly ok, but let's:

  • skip the fields which are not established, or don't contain meaningful values..
  • remove the placeholders from fields where the placeholder can be computed..
  • don't default fields when we actually want the user to enter the value.. (we almost never use "default", and when you see it, it's probably a tagging oddity)

"type": "url",
"icon": "website",
"placeholder": "http://example.com/",
"universal": true,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should not be a universal field

"key": "camera:type",
"type": "combo",
"label": "Camera type",
"default": "fixed",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should not default this.. better to let users enter it..

@@ -0,0 +1,6 @@
{
"key": "camera:features",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's not add camera:features.. it's not an established tag.

"key": "camera:features",
"type": "combo",
"label": "Camera features",
"placeholder": "Webcam, Microphone, Nightvision, Heatvision, Zoom, Motion, Wireless"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should not suggest Uppercase placeholders for a lowercase tag

"key": "surveillance",
"type": "combo",
"label": "Surveillance kind",
"default": "outdoor",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should not default this

"type": "combo",
"label": "Surveillance kind",
"default": "outdoor",
"placeholder": "Public, Outdoor, Indoor",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to add placeholder here, this will be computed automatically from available values.. Don't add Uppercase placeholders for a lowercase tag..

@@ -0,0 +1,8 @@
{
"key": "surveillance:type",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's skip surveillance:type.. 98% of the values are just "camera", and the other values are noisy.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Although I default to camera as well when I map and I don't view the other variants meaningful either, however it has become kind of de facto mandatory.

For example, this visualization also requires many fields to work (described on right panel):
https://kamba4.crux.uberspace.de/

Although, I'll probably add camera:direction to the form as well because I find it easy to add in practice.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, I see. Yes I have heard of Surveillance Under Surveillance. I didn't realize they were consuming this data and required surveillance:type to be filled in. In that case, what you have for this file is fine 👍

"key": "surveillance:zone",
"type": "combo",
"label": "Zone",
"placeholder": "Town, Parking, Traffic, Shop, Building"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No placeholder here.. let it be computed from available values.

@bkil
Copy link
Contributor Author

bkil commented Nov 21, 2016

Thank you for the insightful comments. I will probably have some time tomorrow to do the fix-ups.

bkil added 3 commits November 23, 2016 13:40
https://wiki.openstreetmap.org/wiki/Tag:man_made%3Dsurveillance
https://wiki.openstreetmap.org/wiki/Proposed_features/Extended_tags_for_Key:Surveillance

These are mandatory tags:
* `surveillance`
* `surveillance:type`

I do not feel that the following are important, they can be selected from
the drop down manually anyway:
* `operator`
* `name`

These tags are well established:

* `camera:type` has 15k users
* `camera:mount` has 13k users
* `surveillance:zone` has 17k users (mostly traffic is noted)
* `camera:direction` has 6k users

These tags are in the proposed status:
* `contact:webcam` usage is only starting
* `height`

People used various tags instead of `contact:webcam` in the past
because of it being a recent tag, and/or a lack of knowledge or being
mislead by the dropdown.

Thus it is difficult to quote an exact number, but by using complex
regexp queries, I could find thousands of usages for webcam links
when properly combining man_made/surveillance/camera and various
(sometimes invalid) keywords in the key or value part of a tag:

* `website`
* `image`
* `uri`, `url`, `link`, `http`, `contact`
* `stream`
* `webcam`
@bkil bkil force-pushed the preset/surveillance_extended_fields_camera branch from 1aa2230 to c4140bf Compare November 23, 2016 12:49
@bkil
Copy link
Contributor Author

bkil commented Nov 23, 2016

Requested changes done. Added camera:direction as well and ordered options by occurrence.

@bhousel bhousel merged commit c4140bf into openstreetmap:master Nov 26, 2016
@bhousel
Copy link
Member

bhousel commented Nov 26, 2016

Thanks @bkil I made a few small cleanups and merged..

BTW, you don't need to include the filename in the commit message - GitHub makes it really easy for me to see what files were changed. It's better to use those words to include a summary that I can scan quickly when I'm looking over the commits with git log.

How to Write a Git Commit Message

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants