Kothic JS is a full-featured JavaScript map rendering engine using HTML5 Canvas. It was initially developed as a JavaScript port of Kothic rendering engine written in Python.

Features

• Rendering OpenStreetMap data visually on par with Mapnik
• MapCSS support (see How to Prepare a Map Style)
• rendering from lightweight GeoJSON-like tiles (see Tiles Format)
• easy integration with Leaflet (interactive maps library)

Basic usage

Include kothic.js from the dist directory on your page. Now you can call:

var kothic = new Kothic({
            buffered: false,  // (optional) if true, result will appear only after all layers are rendered
            styles: ['osmosnimki-maps', 'surface'], // (optional) only specified styles will be rendered, if any
            locales: ['be', 'ru', 'en'] // (optional) map languages, see below
        });

locales Kothic-JS supports map localization based on name:lang tags. Renderer will check all mentioned languages in order of persence. If object doesn't have localized name, name tag will be used.

Tile rendering:

kothic.render(
	canvas, // canvas element (or its id) to render on
	data, // JSON data to render
	zoom, // zoom level
	onRenderComplete, // (optional) callback to call when rendering is done
	);

Note: you should new renderer instance for any tile you want to render since Kothic has unsolved concurrency issues.

Contributing to Kothic JS

Kothic JS is licensed under a BSD license, and we'll be glad to accept your contributions! Please send your pull requests to one of the guys below.

Core contributors:

Darafei Praliaskouski (@Komzpa), Vladimir Agafonkin (@mourner), Maksim Gurtovenko (@Miroff)