Map

There are several ways in which maps can be used.

Map display option for any component in addition to a gallery and a list.
Map-based discovery interface on the top level. TBC
Location display in each media metadata view.
Map-based tools
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.

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 coordinate point is read from Wikidata
The shape is read from OSM based on a Wikidata tag in OSM. (Add details about this)

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.

Data

Topic's location
- Display a pin for the best rank coordinates in Wikidata
- Display an area for .map file in Wikimedia Commons
- Display an area for an area in OSM that has been linked to Wikidata
Hierarchically related items in Wikidata
- Enclosing area(s), such as located in the administrative territorial entity (P131)
- Neighbours
- Subdivisions
Nearby items in Wikidata
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

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

Base map
- Default map: Styled OSM map. Allow changing the style?
- OpenStreetMap
- Available local map services, use data collected in OSM
- Custom?
Terrain
Orthophoto
- International services
- Local providers
Scanned / 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

Merge currently separate modules

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)

See also Content modules for a table of all modules.

Map display option for any module

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