Map

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-based tools

Map component

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.

Initial display

Display the topic on the map as a pin and/or an area depending on data
- Zoom extent to be figured out for a single pin

Basemap layers

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.

Layers

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

Allow 4 layers that can be 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.

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.

Data layers

Pins and popups

A topic is displayed as a pin. Possibility of correcting the location?
A topic may also be displayed as a shape from OSM.
- Clicking the pin or the shape opens a popup, which links to the topic's page.
Topic's images are collated to the topic popup. 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.
If possible to distinguish routes, they will be displayed without arcs.

Additional data

Nearby items are displayed as pins and/or shapes depending on data. Explore the use of images and titles.
Nearby images have image display. Will it be an opened popup or another way of displaying?
- Clicking on the image pin opens a popup. The popup links to the image viewer.

Data from other components

These could be sent from the component where selecting and faceting can be done with the tools suitable for that dataset.

Images: Display all related images, a filtered subset or a selection of images on the map
Other components: Filter and facet items before sending to the map. The relevant tools are present at the original component.

Data from external sources

Data can be read from external sources and displayed on the map.

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.

Define more display modes

Combine several views in one: Map, timeline and gallery.

Actions

Import data source
Export map
Save map configuration

Other options

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

Map display option

Map display option for any component 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

Single point
Several 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
Subdivisions
- (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

Actions

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

Map-based wikidocumentary

See wikidocumentary

Map-based search interface

Display items in the given area
Combine with other search criteria
Search location by place name. Aim to include historical toponyms.
Search page design needed. Also useful for displaying scope for shape expressions.