Difference between revisions of "Geolocating tool"

From Wikidocumentaries
Jump to navigation Jump to search
(Step 2)
 
(147 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
In Wikidocumentaries all openly licensed images can be geotagged. This is not available for images, whose reuse is restricted.
 
In Wikidocumentaries all openly licensed images can be geotagged. This is not available for images, whose reuse is restricted.
  
There will be an internal desktop geolocating tool, and the images can also be rephotographed and geotagged with the [[Ajapaik mobile app]].
+
Images can be geolocated with the desktop geolocating tool (this), and the images can also be rephotographed and geotagged with the [[Ajapaik mobile app]] (to be configured later).
  
==Access to geotagging is available with each image in the [[images]] module on the [[topic page]] and the image [[image viewer]].==
+
==Accessing the geolocating tool==
 +
Access to geotagging is available with each image in the [[images]] module on the [[topic page]] and the image [[image viewer]].
 
<gallery mode=packed heights=250>
 
<gallery mode=packed heights=250>
 
Arkistokuvia-Sihvonen-actions.png
 
Arkistokuvia-Sihvonen-actions.png
 
Image viewer.png
 
Image viewer.png
 
</gallery>
 
</gallery>
* The most essential metadata of an image is saved into Wikidocumentaries on the moment it is selected for enriching. Any action in the actions menu will make this happen.
 
{| class="wikitable"
 
|+ Added to the image item
 
!Wikidocs Vue variables
 
!Wikidocs Wikibase property
 
|-
 
| imageURL ||
 
|-
 
| imageHash ||
 
|}
 
See [https://docs.google.com/spreadsheets/d/10PDj0DM85CaNXi35RlVkn2l3uXUm3VNnek9qEXRSfsE/edit?usp=drive_web&ouid=109806565109847332886 Metadata mapping] for more info.
 
  
==The geotagging interface is based on the Wikidocumentaries tools layout. It includes a split view of the zoomable image and the zoomable map.==
+
===Action===
 +
<code>
 +
@/components/menu/ActionMenuImages.vue
 +
 
 +
MENU_ACTIONS.DO_GEOLOCATING
 +
</code>
 +
 
 +
===Properties added to the image item===
 +
The most essential metadata of an image is saved into Wikidocumentaries on the moment it is selected for enriching. Any action in the actions menu will make this happen.
 +
* [[Property:P3761|Commons compatible image available at URL (P3761)]]
 +
* [[Property:P5106|described at URL (P5106)]]
 +
* [[Property:P5125|image hash (P5125)]]
 +
 
 +
==The workflow==
 +
The geotagging interface is based on the Wikidocumentaries [[tool page]] layout. It includes a split view of the image and the zoomable map.
 
<gallery mode=slideshow heights=200>
 
<gallery mode=slideshow heights=200>
Wikidocumentaries-geolocate nomenu en.png
+
Geolocate Select item small en.png|Step 1: Find the main subject
Wikidocumentaries-geolocate step1b en.png
+
Geolocate Location recorded small en.png|Step 2.1: Found item, topic has coordinates
Wikidocumentaries-geolocate angle en.png
+
Geolocate Set location small en.png|Step 2.1.1: Modify pin location
 +
Geolocate No recorded location small en.png|Step 2.2: Found item, topic without coordinates
 +
Geolocate New topic small en.png|Step 3: Create new topic
 +
Geolocate Set camera angle small en.png|Step 4: Set camera angle
 
</gallery>
 
</gallery>
  
''Enhancement ideas:''
+
===Step 1: Find the main subject===
* The map could seek to a suggested location by parsing the data in the name and description, or existing location information in the image metadata.
+
Choose an existing location with the search pulldown (data from Wikidata and Wikidocumentaries).
 +
* '''Pin''': NO pin
 +
* '''Prompt''': "What is the main location depicted in the picture? Search for the topic in the top bar search field."
 +
* '''Step indicator''': POI
 +
* '''Buttons''': ''Skip''
 +
* '''Pulldown''': ''Found item'', ''Create new topic''
 +
* '''Links in the caption''' = ''Found item''
 +
** ''Found item''
 +
*** ''Found item, topic has coordinates'' > Step 2.1
 +
*** ''Found item, topic without coordinates'' > Step 2.2
 +
** ''Create new topic'' > Step 3
 +
** ''Skip'' > Step 4
 +
 
 +
===Step 2: Found item===
 +
====Step 2.1: Found item, topic has coordinates====
 +
* '''Pin''': BLACK pin on the item
 +
* '''Prompt''': "Is the location right? You can tune the coordinates by dragging the pin or search again for another location."
 +
* '''Step indicator''': POI
 +
* '''Item title''' on top of the image + Button (cross) Remove item (only if you have selected an item.)
 +
* '''Buttons''': ''Set location''
 +
** ''Move the pin'' > Step 2.1.1
 +
** ''Set location''
 +
*** Save value ''Wikidata location item ID'' to property [[Property:P5129|depicts Wikidata item (P5129)]] in the ''image item'' in Wikidocumentaries
 +
*** > Step 4
 +
** ''Button (cross)'' > Step 1
 +
 
 +
=====Step 2.1.1: Modify pin location=====
 +
* '''Pin''': RED pin
 +
* '''Prompt''': "Remember to save when you are done!"
 +
* '''Step indicator''': POI
 +
* '''Buttons''': ''Save location'', ''Cancel''
 +
** ''Save location''
 +
*** Save value ''target coordinates'' to property [https://www.wikidata.org/wiki/Property:P625 coordinate location (P625)] to the ''Wikidata location item'' in Wikidata
 +
*** Save value ''Wikidata location item ID'' to property [[Property:P5129|depicts Wikidata item (P5129)]] in the ''image item'' in Wikidocumentaries
 +
*** > Step 4
 +
** ''Cancel'' > Step 2.1
 +
 
 +
====Step 2.2: Found item, topic without coordinates====
 +
* '''Pin''': RED pin in the middle of the map window
 +
* '''Prompt''': "The topic does not have coordinates yet. Drag the pin to the right location and save the coordinates."
 +
* '''Step indicator''': POI
 +
* '''Item title''' on top of the image + Button (cross) Remove item
 +
* '''Buttons''': ''Save location'', ''Skip''
 +
** ''Save location''
 +
*** Save value ''target coordinates'' to property [https://www.wikidata.org/wiki/Property:P625 coordinate location (P625)] to the ''Wikidata location item'' in Wikidata
 +
***  > Step 4
 +
** ''Skip'' > Step 4
 +
** ''Button (cross)'' > Step 1
  
===Step 1===
+
=== Step 3: Create new topic===
Choose an existing location with the search pulldown (data from Wikidata and Wikidocumentaries).
+
* '''Modal''': [[Modal#Create_a_new_topic|Create new topic modal]] (label, description, aliases, instance of -pulldown)
* '''Prompt''': "Find the location by searching for the depicted place in the search field above."
+
* '''Modal buttons''': ''Create'', ''Cancel''
* '''Buttons''': "Set location" and "Reset".
+
** ''Create''
* Action "'''Set location'''"
+
*** Create new item in Wikidata
** A BLACK pin is placed on the map showing the location of the target item. > Step 2
+
*** Add label, description, aliases, instance of P31
** The target item is saved with the image metadata (in property "depicts"). Because the image can depict several items, it may be useful to either have a special property for the target or a qualifier for the target item in the "depicts" property.
+
*** > Step 2.2
* What does "'''Reset'''" do? Return to initial state.
+
** ''Cancel'' > Step 1
  
If the item does not have coordinates, the user is asked to add the location of the target (moving the POI to the right location).
+
===Step 4: Set camera angle===
* A RED pin is placed on the map showing the location. > Step 2
+
* '''Pin''': 50% BLACK pin (if attached to a topic)
 +
* '''Handles''': Camera/eye, left edge, right edge, target
 +
* '''Prompt''': "Set the camera angle by moving the camera and the target, and the left and right edges of the image. ''Show me how''!"
 +
* '''Step indicator''': Map
 +
* '''Item title''' on top of the image + Button (cross) Remove item
 +
* '''Buttons''': ''Set camera angle''
 +
** ''Show me how'' > Step 4.1
 +
** ''Set camera angle''
 +
*** Save data to the Wikidocumentaries ''image item''
 +
**** [[Property:P247|coordinates of the point of view (P247)]], [[Property:P5127|camera heading (P5127)]], [[Property:P2984|field of view (P2984)]]
 +
**** User ID of the submitter. How?
 +
**** Date stamp
 +
***  > Step 5
 +
** ''Button (cross)''
 +
*** Remove the ''location item id'' from the [[Property:P5129|depicts Wikidata item (P5129)]] property in the ''image item'' in Wikidocumentaries
 +
*** > Step 4
  
If the item does not exist, the user (can add the item and/or) is asked to just add the location of the target, like above.
+
====Step 4.1: Show me how modal====
* A RED pin is placed on the map showing the location. > Step 2 (with possible intermediate step see below.)
+
Illustration/animation to explain the camera angle thingy
 +
* '''Modal''': Title
 +
* '''Modal buttons''': ''OK!''
 +
** ''OK'' > Step 4.
  
''Enhancement ideas:''
+
===Step 5: Yay!===
* Add topic if it does not exist?
+
* Display a 3D view for example?
** [[Creating_topics#A_modal_opens_to_create_the_topic_.2F_Create_new_topic_modal|Add topic modal]]
+
* Want to locate another picture?
 +
* Want to do something else to this image? Annotate: Identify more places or people? Set the date?
  
===Step 2===
+
==Controls==
The user can modify the location of the pin.
+
* Select background imagery
* The pin turns to RED if modified.
+
** The base map (different styles?)
 +
** General map: In Finland the National Land Survey map
 +
** Aerial image: In Finland the National Land Survey aerial imagery
 +
** Map layers
 +
*** MapWarper
  
The location is confirmed
+
==Storing geotagging data==
* '''Prompt''': "Modify and save the location. You will be recorded as the source of the new location."
+
The geotagging data is added to the local image metadata. See '''[[Media metadata]]''' for details.
* '''Buttons''': "Save location" and "Cancel".
 
* Action "'''Save location'''"
 
** The pin turns GREY. > Step 3
 
** The coordinates are saved with the target item.
 
* What does "'''Cancel'''" do? Remove the pin > bad idea. Return to previous screen > Bad idea. Return to the first question of selecting the target > Better idea.
 
  
''Enhancement ideas:''
+
==Seek to the right location==
* Add topic if it does not exist? > [[Creating_topics#A_modal_opens_to_create_the_topic_.2F_Create_new_topic_modal|Add topic modal]]
+
* The map could seek to a suggested location by parsing the data in the name and description, or existing location information in the image metadata.
* Display existing topics around the selected location? > Allow changing the main location from a pin pulldown.
+
* The location links in the image metadata could set the location similarly to actions in the workflow.
{| class="wikitable"
 
|+
 
!Thing
 
!Wikidocs Wikibase property
 
|-
 
| Selected target QID || depicts (P180)
 
|-
 
| Selected target coordinates ||
 
|}
 
  
===Step 3===
+
==Enhancement ideas==
* The user will place the camera, the target and the camera angle on the map.
+
''Mirror the image''
* The user can skip this and save only the point.
+
* It may be useful to be able to mirror the image. Would geolocating be a good place for that. Perhaps yes. At what stage?
  
====Controls====
+
''Adjust left and right edges of the image on the image''
* It should be possible to use different background imagery: Aerial images, OSM, local official open map sources, historical maps. Maybe even display nearby images? This interface should be similar to the map interface in the topic page.
 
* Address or geographic search may be used to help find the location.
 
  
====Enhancement ideas====
+
''Display surrounding items''
''More detailed definition''
+
* The user could see items surrounding the found item and change the target by selecting the pin.
* Adjust left and right edges of the image
 
* The user could point items in the map and equivalent items in the image. The field of view could be adjusted automatically based on that. (There will be an illustration of this). ** Verify if POIs that are in the field of view can also be seen on the image. Drag the POIS on the image to right locations
 
  
''3D-view. Elaborating the idea by Matthias Müller-Prove. See screenshot in the end of the page.''
+
''Items in the field of view''
 +
* The POIs in the field of view on the map would also be displayed as vertical lines on the image. The user could drag the lines to right locations, and the camera position on the map would be corrected accordingly.
 +
 
 +
''Annotate while geolocating''
 +
* A tool in the top bar perhaps to make quick annotations of "depicts". Could be POIs but rather rectangles or even trapezoids. Could be considered together with IIIF.
 +
** The user could frame the side of a building in the image (or other object: street, pond, statue...) and locate the equivalent on the map. This could give an estimation of the photographer's position.
 +
 
 +
''3D-editing''
 
* After setting the camera position and the target on the map, the user could fine tune the values in perspective mode:  
 
* After setting the camera position and the target on the map, the user could fine tune the values in perspective mode:  
 
** Image and map overlaid
 
** Image and map overlaid
 
** Change the elevation of the image target and the photographer position. Calculate pitch.
 
** Change the elevation of the image target and the photographer position. Calculate pitch.
** The user could frame the side of a building (or other object: street, pond, statue...) in the image and locate the equivalent on the map. This could give an estimation of the photographer's position.
 
  
==Storing geotagging data==
+
''3D viewing''
The geotagging data is added to the local image metadata. Possible properties include:
+
* Elaborating the idea by Matthias Müller-Prove. (Will add a screenshot)
{| class="wikitable"
+
* In step 5 the user could see the image placed on the map in 3D
|+
 
!Thing
 
!Wikidocs Wikibase property
 
!Wikidata SCD property
 
|-
 
| Image URL |||| Missing
 
|-
 
| Image info page |||| Missing
 
|-
 
| Image hash |||| Missing
 
|-
 
| Camera location |||| coordinates of the point of view (P1259)
 
|-
 
| Main target ID |||| depicts (180) but more to know that this is the main target.
 
|-
 
| Main target coordinates as a fallback. Target coordinates saved onto the target itself |||| coordinate location (P625) on the target item
 
|-
 
| Camera azimuth, compass direction, camera heading, yaw. Compass degrees. |||| Missing?
 
|-
 
| Field of view (degrees) |||| field of view (P4036)
 
|-
 
| Lens focal length || Should it be combined with field of view, think how || focal length (P2151) meters and millimeters
 
|-
 
| Other target IDs in the image || How to store location in image? As annotations? Is the resulting azimuth enough? || depicts (P180) + relative position within image (P2677)?
 
|-
 
| Tilt, pitch, comparison of camera and photographer elevation to distance. Degrees. |||| Missing?
 
|-
 
| Camera used |||| image captured with (P4082)
 
|}
 
  
We can also contribute to a standardised exchange format for geotagged photos.
+
''Crowdsourcing workflows.''
* '''RESEARCH''' methods for verifying crowdsourced contributions (eg. Ajapaik & Surveyor)
+
* We can also contribute to a standardised exchange format for geotagged photos.
  
== Importing to Wikimedia Commons==
+
''Importing to Wikimedia Commons''
* The original image, the image metadata and the added geolocation will be imported to Wikimedia Commons either manually immediately or as a scheduled bot task later. '''ENSURE''' equivalent properties in SDC.
+
* The original image, the image metadata and the added geolocation will be imported to Wikimedia Commons either manually immediately or as a scheduled bot task later.
* The original memory institution will be able to read the enhanced data from Wikimedia Commons. '''INVESTIGATE''' best practises.
+
** Task: Ensure equivalent properties in SDC.
 +
* The original memory institution will be able to read the enhanced data from Wikimedia Commons.
 +
** Task: Investigate best practises.
  
 
==Inspiration==
 
==Inspiration==

Latest revision as of 11:54, 29 January 2019

In Wikidocumentaries all openly licensed images can be geotagged. This is not available for images, whose reuse is restricted.

Images can be geolocated with the desktop geolocating tool (this), and the images can also be rephotographed and geotagged with the Ajapaik mobile app (to be configured later).

Accessing the geolocating tool

Access to geotagging is available with each image in the images module on the topic page and the image image viewer.

Action

@/components/menu/ActionMenuImages.vue

MENU_ACTIONS.DO_GEOLOCATING

Properties added to the image item

The most essential metadata of an image is saved into Wikidocumentaries on the moment it is selected for enriching. Any action in the actions menu will make this happen.

The workflow

The geotagging interface is based on the Wikidocumentaries tool page layout. It includes a split view of the image and the zoomable map.

Step 1: Find the main subject

Choose an existing location with the search pulldown (data from Wikidata and Wikidocumentaries).

  • Pin: NO pin
  • Prompt: "What is the main location depicted in the picture? Search for the topic in the top bar search field."
  • Step indicator: POI
  • Buttons: Skip
  • Pulldown: Found item, Create new topic
  • Links in the caption = Found item
    • Found item
      • Found item, topic has coordinates > Step 2.1
      • Found item, topic without coordinates > Step 2.2
    • Create new topic > Step 3
    • Skip > Step 4

Step 2: Found item

Step 2.1: Found item, topic has coordinates

  • Pin: BLACK pin on the item
  • Prompt: "Is the location right? You can tune the coordinates by dragging the pin or search again for another location."
  • Step indicator: POI
  • Item title on top of the image + Button (cross) Remove item (only if you have selected an item.)
  • Buttons: Set location
    • Move the pin > Step 2.1.1
    • Set location
    • Button (cross) > Step 1
Step 2.1.1: Modify pin location
  • Pin: RED pin
  • Prompt: "Remember to save when you are done!"
  • Step indicator: POI
  • Buttons: Save location, Cancel

Step 2.2: Found item, topic without coordinates

  • Pin: RED pin in the middle of the map window
  • Prompt: "The topic does not have coordinates yet. Drag the pin to the right location and save the coordinates."
  • Step indicator: POI
  • Item title on top of the image + Button (cross) Remove item
  • Buttons: Save location, Skip
    • Save location
    • Skip > Step 4
    • Button (cross) > Step 1

Step 3: Create new topic

  • Modal: Create new topic modal (label, description, aliases, instance of -pulldown)
  • Modal buttons: Create, Cancel
    • Create
      • Create new item in Wikidata
      • Add label, description, aliases, instance of P31
      • > Step 2.2
    • Cancel > Step 1

Step 4: Set camera angle

  • Pin: 50% BLACK pin (if attached to a topic)
  • Handles: Camera/eye, left edge, right edge, target
  • Prompt: "Set the camera angle by moving the camera and the target, and the left and right edges of the image. Show me how!"
  • Step indicator: Map
  • Item title on top of the image + Button (cross) Remove item
  • Buttons: Set camera angle

Step 4.1: Show me how modal

Illustration/animation to explain the camera angle thingy

  • Modal: Title
  • Modal buttons: OK!
    • OK > Step 4.

Step 5: Yay!

  • Display a 3D view for example?
  • Want to locate another picture?
  • Want to do something else to this image? Annotate: Identify more places or people? Set the date?

Controls

  • Select background imagery
    • The base map (different styles?)
    • General map: In Finland the National Land Survey map
    • Aerial image: In Finland the National Land Survey aerial imagery
    • Map layers
      • MapWarper

Storing geotagging data

The geotagging data is added to the local image metadata. See Media metadata for details.

Seek to the right location

  • The map could seek to a suggested location by parsing the data in the name and description, or existing location information in the image metadata.
  • The location links in the image metadata could set the location similarly to actions in the workflow.

Enhancement ideas

Mirror the image

  • It may be useful to be able to mirror the image. Would geolocating be a good place for that. Perhaps yes. At what stage?

Adjust left and right edges of the image on the image

Display surrounding items

  • The user could see items surrounding the found item and change the target by selecting the pin.

Items in the field of view

  • The POIs in the field of view on the map would also be displayed as vertical lines on the image. The user could drag the lines to right locations, and the camera position on the map would be corrected accordingly.

Annotate while geolocating

  • A tool in the top bar perhaps to make quick annotations of "depicts". Could be POIs but rather rectangles or even trapezoids. Could be considered together with IIIF.
    • The user could frame the side of a building in the image (or other object: street, pond, statue...) and locate the equivalent on the map. This could give an estimation of the photographer's position.

3D-editing

  • After setting the camera position and the target on the map, the user could fine tune the values in perspective mode:
    • Image and map overlaid
    • Change the elevation of the image target and the photographer position. Calculate pitch.

3D viewing

  • Elaborating the idea by Matthias Müller-Prove. (Will add a screenshot)
  • In step 5 the user could see the image placed on the map in 3D

Crowdsourcing workflows.

  • We can also contribute to a standardised exchange format for geotagged photos.

Importing to Wikimedia Commons

  • The original image, the image metadata and the added geolocation will be imported to Wikimedia Commons either manually immediately or as a scheduled bot task later.
    • Task: Ensure equivalent properties in SDC.
  • The original memory institution will be able to read the enhanced data from Wikimedia Commons.
    • Task: Investigate best practises.

Inspiration


Navigation

About Technology Design Content modules Tool pages Projects
Status

Wikidocumentaries blog

Wikidocumentaries demo

Phabricator project

Facebook group

GitHub repository

Translation in TranslateWiki

Wikidocumentaries Slack

Setting up dev environment

Resources

Translations

Languages

Using Wikibase

Federation with Wikidata

APIs

Linking

Media metadata

Properties to content

User registration

Licensing

Page types

Landing page

Search page

Topic page

User page

Organisation page

Project page

Tool page

Tasks

Components

Main toolbar and footer

Search

Faceting

Topic page header

Content module

Dropdown

Modal

Icons

Active modules

Article

Family tree

Gallery

Historical map

Images

Image viewer

Infobox

Map

Module ideas

Audio/Video

Bibliography

Correspondence

Discussion

Graph

Name

Newspaper articles

Testimonials

Timeline

Visualizations

Wikidocumentary

3D

Visual editor

Query tool

QuickStatements

Open Refine

Creating topics

Uploading images

Geolocating tool

Metadata editor

Rectifying maps

Transcription

Annotation tool

Central Park Archives

Convent Quarter

Wikisource