Geolocating tool

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.

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.

• 
• 

• 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.

Properties added to the image item

• imageURL
• imageHash

The workflow

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

• 

  Step 1: Find the main subject

• 

  Step 2.1: Found item, topic has coordinates

• 

  Step 2.1.1: Modify pin location

• 

  Step 2.2: Found item, topic without coordinates

• 

  Step 3: Create new topic

• 

  Step 4: Set camera angle

Step 0: open image

• 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.

Step 1: Find the main subject

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

• Pin: RED pin in the middle of the map window
• Prompt: "What is the main location depicted in the picture? Search for the topic in the top bar search field."
• Buttons: No buttons before search
• Pulldown: Matches, Create new topic
  • Found item > Step 2
    • Found item, topic has coordinates > Step 2.1
    • Found item, topic without coordinates > Step 2.2
  • Create new topic > Step 3.1
  • Modify pin > Step 3.2

Step 2: Found item

Step 2.1: Found item, topic has coordinates

• Pin: BLACK pin on the item
• Prompt: "Is the location correct? You can drag the pin or continue to set the camera angle. (Show me how)"
• 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 > Step 4
  • Button (cross) > Step 1

Step 2.1.1: Modify pin location

• Pin: RED pin
• Prompt: "Remember to save when you are done!"
• Buttons: Save location, Cancel
  • Save location > Step 2.1 (Save coordinate location to the item in Wikidata, save depicts to image item in wikidocumentaries)
  • 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."
• Item title on top of the image + Button (cross) Remove item
• Buttons: Save location
  • Save location
    • Save coordinate location (P625) to the item in Wikidata
    • > Step 2.1
  • Button (cross) > Step 1

Step 3: No item

Step 3.1: Create new topic

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

Step 3.2: Only coordinates

• Pin: RED pin
• Prompt: "Remember to save when you are done!"
• Buttons: Save location, Cancel
  • Save location > Step 2.1 (Save coordinate location to the image item in wikidocumentaries)
  • Cancel > Step 2.1

Step 4: Set camera angle

• Pin: 50% BLACK pin
• Handles: Camera/eye, left edge, right edge, target
• Prompt: "Move the camera and the lines marking the left and right edges of the image to find the most accurate camera angle. The dotted line will help you find what's in the middle of the image. (Show me how)"
• 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:
    • > Step 5
  • Button (cross) > Step 1

Step 4.1: Show me how modal

Illustration/animation to explain the camera angle thingy

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

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

Enhancement ideas

More detailed definition

• Adjust left and right edges of the image on the image
• The user could select items displayed on 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.

• 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.
  • 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

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

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

• RESEARCH methods for verifying crowdsourced contributions (eg. Ajapaik & Surveyor)

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 memory institution will be able to read the enhanced data from Wikimedia Commons. INVESTIGATE best practises.

Inspiration

• 

  Ajapaik web app

• 

  NYPL Space/Time Surveyor

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