Map

There are several ways in which maps can be used.

1. Map component for a single topic displays everything the user collates together on the map
2. Map display option for any component in addition to a gallery and a list.
3. 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.
4. Map-based discovery interface on the top level.
5. Location display in each media metadata view.
6. Map-based tools

Location component – plan

The map component for a single topic will display everything the user collates together on the map. It will be 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.

• 
• 
• 
• 

Data

• Topic as pin and/or shape depending on data
• Nearby items
• Images
  • Nearby
  • Display all related images, a filtered subset or a selection of images on the map. Filtering is made in the images component.
• Context (areas)
  • Subdivisions
  • Neighbouring items
  • Enclosing items
• 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.

Data display

• Pin – clickable --> Popup
• 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. 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 will follow roads, if possible.
• Advanced: Combine several views in one: Map, timeline and gallery.

Data sources

1. Wikidata for the item point and/or shape
2. OSM for shape (and missing point if possible)
3. 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.

Actions

• Correct the location of the topic's pin
• Facet/filter by data item type. For items from other components filtering takes place in the original component. (TBD)
• 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 4 layers that can be 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 / 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

Current functionality

3 components 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)

Components's 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

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

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

• Geolocating tool for images
• Rectifying maps

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