Difference between revisions of "Map"

From Wikidocumentaries
Jump to navigation Jump to search
(Location module)
(Location module)
Line 4: Line 4:
  
 
==Location module==
 
==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.
+
'''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)
 
[[File:Inthislocation.png]]
 
[[File:Inthislocation.png]]
  
* The coordinate point is read from Wikidata
+
== 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)
 
* The shape is read from OSM based on a Wikidata tag in OSM. (Add details about this)
 +
 +
== Location and shapes of historical elements ==
 
* Historical shapes could be stored in OpenHistoricalMap using the same technology. Additional technologies can be added.
 
* Historical shapes could be stored in OpenHistoricalMap using the same technology. Additional technologies can be added.
 +
* Also shapes stored as .map files in Wikimedia Commons should be displayed
  
=== How to develop the Location module ===
+
=== 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
  
The topic's Location module initially displays the location of the topic. It will also be able to display everything the user collates together on the map. The user will be able 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.
+
=== Geographically related items in Wikidata ===
<gallery mode=slideshow>
+
* Items within the area
Map.png
+
* Nearby items
Map-layers.png
+
 
Map-images.png
+
=== Images ===
Map-actions.png
+
* About the topic
</gallery>
+
* 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. Filtering could take place at the original component. In the map component only visibility is managed.
  
=== Data ===
+
=== Configurable external sources ===
* Topic's location
+
It could be possible to display a geographic dataset from an external source.
** Display a pin for the best rank coordinates in Wikidata
+
* 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.
** Display an area for .map file in Wikimedia Commons
+
* The style of these elements should differ from items already in Wikidata, and change after validation.
** Display an area for an area in OSM that has been linked to Wikidata
+
* The source of the data could be automatically appended to the Wikidata entry.
* 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 related 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 is made in the images component.
 
* Related items from other components
 
** Filter and facet items in the original component before sending to the map. Filtering takes place at the original component. In the map component only visibility is managed.
 
* Configurable external sources
 
** The user can validate these items, and the data can be written to Wikimedia projects or OpenStreetMap.
 
** The style of these elements should differ from items already in Wikidata, and change after validation.
 
** The source of the data can be automatically appended to the Wikidata entry.
 
  
=== Data display ===
+
== Data display ==
 
* Pin
 
* Pin
 
* Shape
 
* Shape
Line 56: Line 58:
 
* Advanced: Combine several views in one: Map, timeline and gallery.
 
* Advanced: Combine several views in one: Map, timeline and gallery.
  
=== User actions ===
+
== User actions ==
 
* Facet/filter by data item type. For items from other components filtering takes place in the original component. (TBD)
 
* 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
 
* Correct the location of the topic's pin
Line 65: Line 67:
 
* Use the selection for a wikidocumentary
 
* Use the selection for a wikidocumentary
  
===Basemap layers===
+
== Basemap layers ==
  
 
See also Phabricator task https://phabricator.wikimedia.org/T261569.
 
See also Phabricator task https://phabricator.wikimedia.org/T261569.
Line 83: Line 85:
 
#* Select/search from available maps in registered sources, including Wikimaps Warper.
 
#* Select/search from available maps in registered sources, including Wikimaps Warper.
  
====Menu controls====
+
===Menu controls===
 
* Transparency slider for each layer
 
* Transparency slider for each layer
 
* Toggle visibility
 
* Toggle visibility
Line 91: Line 93:
 
The goal is to display the most suitable maps based on scale and topic date by default.
 
The goal is to display the most suitable maps based on scale and topic date by default.
  
====Selecting sources====
+
===Selecting sources===
 
* A modal to configure the sources.  
 
* A modal to configure the sources.  
 
* Can display previews of available imagery or data for each layer individually.
 
* Can display previews of available imagery or data for each layer individually.
 
* Allows reading any publicly available raster or data layer to Wikidocumentaries.
 
* Allows reading any publicly available raster or data layer to Wikidocumentaries.
  
====Advanced map options====
+
===Advanced map options===
 
* Select map language: Display vernacular/old toponyms?
 
* Select map language: Display vernacular/old toponyms?
 
* Select map style
 
* Select map style
  
=== Merge currently separate modules ===
+
== How to develop the Location module ==
3 modules that could be merged
+
 
* Location (gallery of subdivisions, neighbours, and enclosing items)
+
The topic's Location module initially displays the location of the topic. It will also be able to display everything the user collates together on the map. The user will be able 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 on map (simple pin/shape display)
+
<gallery mode=slideshow>
* In this location (items found within this item, based on semantic definition)
+
Map.png
 +
Map-layers.png
 +
Map-images.png
 +
Map-actions.png
 +
</gallery>
 +
 
  
 
See also [[Content modules]] for a table of all modules.
 
See also [[Content modules]] for a table of all modules.

Revision as of 12:24, 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

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

Hierarchically related items in Wikidata

Geographically related 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. Filtering could take place at the original component. In the map component only visibility is managed.

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

  1. Base map
    • Default map: Styled OSM map. Allow changing the style?
    • OpenStreetMap
    • Available local map services, use data collected in OSM
    • Custom?
  2. Terrain
  3. Orthophoto
    • International services
    • Local providers
  4. Scanned or historical map
    • Always best suggestion based on time and scale
    • Select/search from available maps in registered sources, including Wikimaps Warper.

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 display the most suitable maps based on scale and topic date by default.

Selecting sources

  • A modal to configure the sources.
  • Can display previews of available imagery or data for each layer individually.
  • Allows reading any publicly available raster or data layer to Wikidocumentaries.

Advanced map options

  • Select map language: Display vernacular/old toponyms?
  • Select map style

How to develop the Location module

The topic's Location module initially displays the location of the topic. It will also be able to display everything the user collates together on the map. The user will be able 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.


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