Difference between revisions of "Map"

From Wikidocumentaries
Jump to navigation Jump to search
(Map component)
(Content selection modal)
 
(114 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
There are several ways in which maps can be used.
 
There are several ways in which maps can be used.
  
# '''Map component''' for a single topic displays everything the user collates together on the map
 
# '''Map display option''' for any component in addition to a gallery and a list.
 
# '''Map-based wikidocumentary'''
 
#* For a given topic, displayed in the header section. There may be several header images of wikidocumentaries per topic, which will then be put on a playlist.
 
#* A wikidocumentary usually touches on many topics, and there must be a topic-independent place for displaying them and a way to find them.
 
# '''Map-based discovery interface''' on the top level.
 
# '''Location display''' in each media metadata view.
 
  
== Map component ==
+
==Location module==
The map component for a single topic displays everything the user collates together on the map. It is possible to display the filtered information from each of the topic page's sections, define their display properties, and add several base map layers. It will also be possible to configure other external data elements to be displayed on the map. Ideally, the map can be exported and embedded elsewhere.
+
'''Location module''' is the main map for a topic. It displays the location of the topic. Additionally, it can be made to display much more information. The location data is currently dispersed between several components: a main map (displaying the coordinate location and shape, if available), Location (displaying subdivisions, neighbouring items, and items that the topic is situated or part of), Locations (items that have been declared being situated within the topic), and additional overlap with components Parts and Part of. Ideally, all of these would be displayed in a single display with facets for the information.
<gallery mode=slideshow>
+
 
Kartta-menu.png
+
3 modules that could be merged
Map-images.png
+
* Location (gallery of subdivisions, neighbours, and enclosing items)
File:Map-layers.png
+
* Location on map (simple pin/shape display)
</gallery>
+
* In this location (items found within this item, based on semantic definition)
* Initially display the topic on the map as a pin and/or an area depending on data
+
[[File:Inthislocation.png]]
* Zoom extent to be figured out for a single pin
+
 
* View nearby items (POIs & shapes) / images Nearby topics
+
== Location data ==
* Display images or a selection on the map
+
 
* Display external data and raster sources (historical maps) as layers > More ideas on configuring this needed
+
===Topic's location===
* Display items from any of the components on the topic's page
+
 
* Combine several views in one: Map, timeline and gallery.
+
* The coordinate point is read from Wikidata. Display a pin for the best rank coordinates in Wikidata.
* Configure map layers
+
* The shape is read from OSM based on a Wikidata tag in OSM. (Add details about this)
 +
 
 +
==== Location and shapes of historical elements ====
 +
OpenStreetMap only stores items that can be verified on the ground. There are different alternatives for shapes of historical items.
 +
* Historical shapes could be stored in OpenHistoricalMap using the same technology as for OSM.
 +
* Also shapes stored as .map files in Wikimedia Commons should be displayed
 +
* Additional technologies can be added.
 +
 
 +
=== Hierarchically related items in Wikidata ===
 +
* Enclosing area(s), such as [https://www.wikidata.org/wiki/Property:P131 located in the administrative territorial entity (P131)]
 +
* Neighbours
 +
* Subdivisions
 +
 
 +
=== Geographically associated items in Wikidata ===
 +
* Items within the area
 +
* Nearby items
 +
 
 +
=== Images ===
 +
* About the topic
 +
* Nearby images
 +
* Display a filtered selection of images on the map. Filtering could be made in the images component.
 +
 
 +
=== Related items from other components ===
 +
Filter and facet items in the original component before sending to the map. In the map component only visibility is managed. For example
 +
* Related people
 +
* Affiliations
 +
* Similar items etc.
 +
 
 +
=== Configurable external sources ===
 +
It could be possible to display a geographic dataset from an external source.
 +
* The data could be used to validate location data on Wikidata. The user could compare existing data to the authority dataset, and make changes to Wikidata accordingly.
 +
* The style of these elements should differ from items already in Wikidata, and change after validation.
 +
* The source of the data could be automatically appended to the Wikidata entry.
 +
 
 +
== Data display ==
 +
* Pin
 +
* Shape
 +
* Popup – Clicking the pin or the shape opens a popup, which links to the topic's page.
 +
* Image pin
 +
** Single images in their individual pins/popups
 +
** Topic's images are collated to the topic popup (if possible). Each image links to the image viewer.
 +
** If there are too many items or images in the area, they will be styled as aggregate.
 +
* Timeline arc for items with several points on a timeline.
 +
* Routes
 +
* Advanced: Combine several views in one: Map, timeline and gallery.
 +
 
 +
== User actions ==
 +
* Facet/filter by data item type. For items from other components filtering takes place in the original component. (TBD)
 +
* Correct the location of the topic's pin
 +
* Import new items to Wikidata / enrich existing items
 +
* View an external dataset on the map.
 
* Export map
 
* Export map
 +
* Save map configuration
 +
* Use the selection for a wikidocumentary
  
===Map layers===
+
== Basemap layers ==
* Base map, configure
 
** Default map: Styled OSM map
 
** OpenStreetMap
 
** Available local map services, use data collected in OSM
 
** Custom?
 
* Terrain, configure
 
* Orthophoto, configure
 
** International services
 
** Local providers
 
* Historical map, configure
 
** Always best suggestion based on time and scale
 
** Select/search from available maps in registered sources, including Wikimaps Warper.
 
* Configure menu and services
 
* Menu controls
 
** Transparency slider for each layer
 
** Toggle visibility
 
** Configuration button opens configuration modal (TBD). Each layer has one map initially.
 
** Layers can be rearranged
 
** Bottom layer is opaque or there is a (chosen?) background colour)
 
The goal is to allow an option, which will always display the most suitable maps based on scale and topic date.
 
  
===Pin===
+
See also Phabricator task https://phabricator.wikimedia.org/T261569.
* Topic's pin
 
** Simple pin to display the location
 
** Clicked pin to include topic's featured image, title and description. Link to the topic page.
 
* Image pin/popup
 
** images of the topic are displayed in the topic popup. To be expanded somehow, if it includes lots of images.
 
** nearby images will have a pin, a popup, and an aggregated appearance. The idea of the aggregated view is to allow images to be displayed and found easily even when there are many of them.
 
** The popup links to image viewer. The image viewer has links to available image tools. Alternatively, the image tools can be linked directly from the popup.
 
* Events and routes (timeline locations, journeys)
 
  
===Area===
+
Allow several layers that can be stacked and configured. Each layer displays one map.
* What needs to be taken into account
+
# Base map
 +
# Terrain
 +
# Orthophoto
 +
# Scanned or [[historical map]]
  
===Toponyms===
+
===Menu controls===
* Display vernacular/old toponyms?
+
* Transparency slider for each layer
 +
* Toggle visibility
 +
* Configuration button opens content selection modal (TBD).
 +
* Layers can be rearranged
 +
* Bottom layer is opaque or there is a (chosen?) background colour)
  
== Map display option ==
+
===Data display===
Map display option for any component in addition to a gallery and a list
+
* Display map metadata
* Option in the display menu of items that have geolocation data
 
* Single point, lifeline (start–end) arcs, routes, aggregates for multiple points
 
* Areas
 
* Temporal aspect if present in the data
 
* Facet items on the map based on their properties
 
* Add all or a faceted selection to the topic's map
 
  
==Map-based wikidocumentary==
+
===Content selection modal===
===Based on frames that consist of several parameters===
+
Display the most suitable maps based on scale, topic date and availability. Allow to expand to other sources.
* Coordinate location
 
* View angle
 
* Time value
 
* Visual media
 
** Image plane and view angle for overlays (on the map background, in 3D space)
 
** Medium (video, image, image series, image pair)
 
* Headline & subheader
 
* Text
 
** Hyperlinks?
 
** Media
 
* Audio
 
** Fixed timeline throughout presentation, such as a narrative
 
** Fixed timeline over one frame
 
** Soundscape loops or generative soundscapes
 
** Effects, synchronized sound
 
* Map settings
 
** Map style
 
** Animations
 
** Layers
 
* Timeline display
 
  
===Display options===
+
{| class="wikitable"
====Map====
+
!  !! Sources !! Controls !! Actions
* Map is the base element
+
|-
* Each frame represents a point from which the map is seen
+
! Base map
* Map settings are different for each map frame
+
| Default map: Styled OSM map.<br>Available local and international map services, use data collected in OSM
* An aerial image/video/illustration may overlay the map
+
| Select / deselect
* A media element may be added to the 3D view
+
| Allow editing the style?
** An image pair can be viewed with a revealing slider
+
|-
* Map remains controllable in frames
+
! Terrain
 +
| Available local and international map services, use data collected in OSM || Select / deselect ||
 +
|-
 +
! Orthophoto
 +
| Available local and international map services, use data collected in OSM || Select / deselect ||
 +
|-
 +
! Scanned or historical map
 +
| Display a selection of maps from connected sources<br>TODO: Create a register of map source APIs
 +
| Select / deselect<br>Filter / facet / sort by scale, date
 +
| Allow reading any publicly available raster layer<br>Georeference<br>Trace
 +
|}
  
====Text====
 
* Text can be scrollable including parallax elements.
 
* Media can be used as part of layout in the text stream. Media can be expanded to cover the full screen.
 
* Transition from frame to the other may also different, such as a crossfade between media elements.
 
  
====Audio====
+
See also [[Content modules]] for a table of all modules.
  
===Locative elements===
+
== Map display option for any component ==
* Frame display triggered by GPS info
+
Map display option for any module in addition to gallery, list and timeline.
* Dynamic output
+
* Option in the display menu of items that have geolocation data
** soundscape, colours, alternative content, nearby geotagged content
 
* depending on data
 
** proximity to a coordinate location
 
** weather data
 
** time of day, time of year...
 
  
===User-generated===
+
Phabricator:https://phabricator.wikimedia.org/T261566
* Interface to create frames and configure settings
 
  
===Generated===
+
===Display formats===
* AI-assisted frame generation from Wikipedia articles
+
* Usually several disconnected points
* User-enhanced in the same interface
+
** Aggregates for multiple points
 +
* Series of points connected to each other with arcs
 +
** lifeline (start–end) arcs
 +
* Series of points connected to each other by a line
 +
** For routes
 +
* Areas
 +
** (Historical) geographic subdivisions in a map
 +
** Cemetery or allotment garden map
 +
* Temporal aspect if present in the data
 +
** For life arcs, the color of the arc
 +
** Animation
  
===To think===
+
===Actions===
* Animations of time-series, how do they relate to frames? Can frames be marked as time intervals, or points in time?
+
* Facet items on the map based on their properties
* Can the wikidocumentaries be multidimensional, including for example temporal depth across its own timeline.
+
* Add all or a faceted selection to the topic's map
  
[[File:Kartta-menu.png|1000px]]
+
==Map-based search==
 +
See [[Search page]]
  
[[File:Kartta-items.png|1000px]]
+
==Map-based wikidocumentary==
 +
See [[wikidocumentary]]
  
[[File:Map.png|1000px]]
+
==Location display in each media metadata view==
 +
Each image has a small map in the metadata section. This, too, needs to have the same features as maps throughout the site.
  
==Map-based discovery interface==
+
==Map-based tools==
* Display items in the given area
+
* [[Geolocating tool]] for images
* Combine with other search criteria
+
* [[Rectifying maps]]
* Search location by place name. Aim to include historical toponyms.
+
* Workflow capturing all data from a [[historical map]]
* Search result page design needed. Also useful for displaying scope for shape expressions.
 
  
 
{{Design-nav}}
 
{{Design-nav}}

Latest revision as of 14:37, 6 January 2022

There are several ways in which maps can be used.


Location module

Location module is the main map for a topic. It displays the location of the topic. Additionally, it can be made to display much more information. The location data is currently dispersed between several components: a main map (displaying the coordinate location and shape, if available), Location (displaying subdivisions, neighbouring items, and items that the topic is situated or part of), Locations (items that have been declared being situated within the topic), and additional overlap with components Parts and Part of. Ideally, all of these would be displayed in a single display with facets for the information.

3 modules that could be merged

  • Location (gallery of subdivisions, neighbours, and enclosing items)
  • Location on map (simple pin/shape display)
  • In this location (items found within this item, based on semantic definition)

Inthislocation.png

Location data

Topic's location

  • The coordinate point is read from Wikidata. Display a pin for the best rank coordinates in Wikidata.
  • The shape is read from OSM based on a Wikidata tag in OSM. (Add details about this)

Location and shapes of historical elements

OpenStreetMap only stores items that can be verified on the ground. There are different alternatives for shapes of historical items.

  • Historical shapes could be stored in OpenHistoricalMap using the same technology as for OSM.
  • Also shapes stored as .map files in Wikimedia Commons should be displayed
  • Additional technologies can be added.

Hierarchically related items in Wikidata

Geographically associated items in Wikidata

  • Items within the area
  • Nearby items

Images

  • About the topic
  • Nearby images
  • Display a filtered selection of images on the map. Filtering could be made in the images component.

Related items from other components

Filter and facet items in the original component before sending to the map. In the map component only visibility is managed. For example

  • Related people
  • Affiliations
  • Similar items etc.

Configurable external sources

It could be possible to display a geographic dataset from an external source.

  • The data could be used to validate location data on Wikidata. The user could compare existing data to the authority dataset, and make changes to Wikidata accordingly.
  • The style of these elements should differ from items already in Wikidata, and change after validation.
  • The source of the data could be automatically appended to the Wikidata entry.

Data display

  • Pin
  • Shape
  • Popup – Clicking the pin or the shape opens a popup, which links to the topic's page.
  • Image pin
    • Single images in their individual pins/popups
    • Topic's images are collated to the topic popup (if possible). Each image links to the image viewer.
    • If there are too many items or images in the area, they will be styled as aggregate.
  • Timeline arc for items with several points on a timeline.
  • Routes
  • Advanced: Combine several views in one: Map, timeline and gallery.

User actions

  • Facet/filter by data item type. For items from other components filtering takes place in the original component. (TBD)
  • Correct the location of the topic's pin
  • Import new items to Wikidata / enrich existing items
  • View an external dataset on the map.
  • Export map
  • Save map configuration
  • Use the selection for a wikidocumentary

Basemap layers

See also Phabricator task https://phabricator.wikimedia.org/T261569.

Allow several layers that can be stacked and configured. Each layer displays one map.

  1. Base map
  2. Terrain
  3. Orthophoto
  4. Scanned or historical map

Menu controls

  • Transparency slider for each layer
  • Toggle visibility
  • Configuration button opens content selection modal (TBD).
  • Layers can be rearranged
  • Bottom layer is opaque or there is a (chosen?) background colour)

Data display

  • Display map metadata

Content selection modal

Display the most suitable maps based on scale, topic date and availability. Allow to expand to other sources.

Sources Controls Actions
Base map Default map: Styled OSM map.
Available local and international map services, use data collected in OSM
Select / deselect Allow editing the style?
Terrain Available local and international map services, use data collected in OSM Select / deselect
Orthophoto Available local and international map services, use data collected in OSM Select / deselect
Scanned or historical map Display a selection of maps from connected sources
TODO: Create a register of map source APIs
Select / deselect
Filter / facet / sort by scale, date
Allow reading any publicly available raster layer
Georeference
Trace


See also Content modules for a table of all modules.

Map display option for any component

Map display option for any module in addition to gallery, list and timeline.

  • Option in the display menu of items that have geolocation data

Phabricator:https://phabricator.wikimedia.org/T261566

Display formats

  • Usually several disconnected points
    • Aggregates for multiple points
  • Series of points connected to each other with arcs
    • lifeline (start–end) arcs
  • Series of points connected to each other by a line
    • For routes
  • Areas
    • (Historical) geographic subdivisions in a map
    • Cemetery or allotment garden map
  • Temporal aspect if present in the data
    • For life arcs, the color of the arc
    • Animation

Actions

  • Facet items on the map based on their properties
  • Add all or a faceted selection to the topic's map

Map-based search

See Search page

Map-based wikidocumentary

See wikidocumentary

Location display in each media metadata view

Each image has a small map in the metadata section. This, too, needs to have the same features as maps throughout the site.

Map-based tools


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