Extension Versioned Tiledmap


Extension Basics

Title
Versioned Tiledmap
Name
ckanext-versioned-tiledmap
Type
Public extension
Description
A CKAN extension with a map view for versioned-datastore backed resources, allowing map visualizations of large resources with millions of data points.
CKAN versions
Download-Url (zip)
Last commit
9 months ago (2025-06-09 13:18:39)
Url to repo
Category
Visualization & Analytics


Background Infos

Description (long)
Show details

ckanext-versioned-tiledmap

A CKAN extension with a map view for versioned-datastore backed resources.

Overview

A CKAN plugin with a map view for versioned-datastore backed resources allowing for map visualizations of large resources with millions of data points.

This repository is a fork of ckanext-map.

Installation

Pre-install setup

This extension depends on versioned-datastore-tile-server, which must be installed first.

Installing from PyPI

pip install ckanext-versioned-tiledmap

Installing from source

  1. Clone the repository into the src folder: cd $INSTALL_FOLDER/src git clone https://github.com/NaturalHistoryMuseum/ckanext-versioned-tiledmap.git
  2. Activate the virtual env: . $INSTALL_FOLDER/bin/activate
  3. Install via pip: pip install $INSTALL_FOLDER/src/ckanext-versioned-tiledmap

Post-install setup

  1. Add ‘versioned_tiledmap’ to the list of plugins in your config file: ckan.plugins = ... versioned_tiledmap
  2. Install lessc globally: npm install -g "less@~4.1"
  3. Add latitude and longitude fields for the resources you want to use this view for.

Configuration

Name Description Example
versioned_tilemap.tile_layer.url The URL for base world tiles https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
versioned_tilemap.tile_layer.attribution Attribution text for the tile layer Base tiles provided by OpenStreetMap
versioned_tilemap.tile_layer.opacity The opacity for the tile layer 0.8
versioned_tilemap.zoom_bounds.min Minimum zoom level 3
versioned_tilemap.zoom_bounds.max Maximum zoom level 18
versioned_tilemap.style.plot.point_radius Radius of rendered points 4
versioned_tilemap.style.plot.point_colour Hex colour for points #ee0000
versioned_tilemap.style.plot.border_width Border width of rendered points 1
versioned_tilemap.style.plot.border_colour Hex colour for point borders #ffffff
versioned_tilemap.style.gridded.cold_colour Colour for lowest counts #f4f11a
versioned_tilemap.style.gridded.hot_colour Colour for highest counts #f02323
versioned_tilemap.style.heatmap.point_radius Heatmap point radius 8
versioned_tilemap.style.heatmap.intensity Heatmap intensity (0-1) 0.5
versioned_tilemap.info_template Template for point click point_detail
versioned_tilemap.quick_info_template Template for point hover point_detail_hover

Usage

After enabling this extension in the list of plugins, the Map view should become available for resources with latitude and longitude values.

Version
2.3.4
Version release date
2025-06-09
Contact name
Natural History Museum
Contakt email
(not set)
Contact Url
(not set)


Installation Guide

Configuration hints

Requires versioned-datastore-tile-server, ckanext-versioned-datastore, and lessc (npm install -g less@~4.1). Resources must have latitude and longitude fields.

Plugins to configure (ckan.ini)
versioned_tiledmap
CKAN Settings (ckan.ini)
DB migration to be executed
(not set)
<< back to Extensions