From Wikidocumentaries
Revision as of 07:50, 18 June 2020 by Admin (talk | contribs) (Map layers)
Jump to navigation Jump to search

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.

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.

  • Initially 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
  • View nearby items (POIs & shapes) / images
  • Display all related images, a filtered subset or a selection of images on the map
  • Display items from any of the components on the topic's page, filtered in the component
  • Combine several views in one: Map, timeline and gallery.
  • Configure map layers
  • Import and display external data and raster sources (historical maps) as layers > More ideas on configuring this needed
  • Export map


  • Import data source
  • Export map

Map layers

Allow 4 layers that can be configured

  1. Base map
    • Default map: Styled OSM map
    • OpenStreetMap
    • Available local map services, use data collected in OSM
    • Custom?
  2. Terrain
  3. Orthophoto
    • International services
    • Local providers
  4. 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.

Pins and popups

  • Initial topic's pin is displayed as popup. Possibility of correcting the location?
  • Topic's images are collated to the topic popup. Each image links to the image viewer
  • Simple pins are used for other topics. If possible, use the image and/or name.
    • Clicking opens the popup, which links to topic's page.
  • Individual images are displayed with image pins, linking to the image viewer.
  • Aggregated items and images. If there are too many items of images in the area, they will be styled as aggregate.
  • Timeline arc for items with several dates. If possible to distinguish routes, they will be displayed without arcs.


  • Some sources can be added permanently
    • OSM, which other? Through which services? Sophox?

Other options

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

Map display option

Map display option for any component in addition to a gallery and a list

  • 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

Based on frames that consist of several parameters

  • 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


  • Map is the base element
  • Each frame represents a point from which the map is seen
  • Map settings are different for each map frame
  • An aerial image/video/illustration may overlay the map
  • A media element may be added to the 3D view
    • An image pair can be viewed with a revealing slider
  • Map remains controllable in frames


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


Locative elements

  • Frame display triggered by GPS info
  • Dynamic output
    • soundscape, colours, alternative content, nearby geotagged content
  • depending on data
    • proximity to a coordinate location
    • weather data
    • time of day, time of year...


  • Interface to create frames and configure settings


  • AI-assisted frame generation from Wikipedia articles
  • User-enhanced in the same interface

To think

  • Animations of time-series, how do they relate to frames? Can frames be marked as time intervals, or points in time?
  • Can the wikidocumentaries be multidimensional, including for example temporal depth across its own timeline.

Map-based discovery interface

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


About Technology Design Content modules Tool pages Projects

Wikidocumentaries blog

Wikidocumentaries demo

Phabricator project

Facebook group

GitHub repository

Translation in TranslateWiki

Wikidocumentaries Slack

Setting up dev environment




Using Wikibase

Federation with Wikidata



Media metadata

Properties to content

User registration


Page types

Landing page

Search page

Topic page

User page

Organisation page

Project page

Tool page



Main toolbar and footer



Topic page header

Content module




Active modules


Family tree


Historical map


Image viewer



Module ideas







Newspaper articles






Visual editor

Query tool


Open Refine

Creating topics

Uploading images

Geolocating tool

Metadata editor

Rectifying maps


Annotation tool

Central Park Archives

Convent Quarter