Skip to content
/ oltb Public

Portable mobile friendly GIS toolbar/editor developed for OpenLayers 10.0.0

License

Notifications You must be signed in to change notification settings

qulle/oltb

Repository files navigation

Toolbar for OpenLayers

License: BSD-2-Clause Demo npm downloads npm version jsDelivr

OLTB v3.2.0

OLTB is a Vanilla JS, portable mobile friendly GIS Toolbar, developed using OpenLayers 10.0.0. The Toolbar can be filled with any number of tools and can be used in both horizontal and vertical mode and is available in both light and dark theme.

Demo

A picture says a thousand words but a Demo 🚀 says a million.

Screenshots

Screenshot Light Theme

Light theme

Screenshot Dark Theme

Dark theme

NPM

$ npm install oltb

CDN

https://cdn.jsdelivr.net/npm/oltb@v3.2.0/dist/oltb.min.js
https://cdn.jsdelivr.net/npm/oltb@v3.2.0/dist/oltb.min.css

Get Started

  1. Clone
$ git clone https://github.com/qulle/oltb.git
  1. Install Dependencies
$ npm install
  1. Run Tests
$ npm run test
$ npm run test:coverage
  1. Run Devserver
$ npm start

Examples

Examples for both the NPM and CDN version can be viewed in the Examples Directory 👀. Use Git history and the tagged releases to look at older examples.

Documentation

Have a look at the Internal Development Documentation 👓. Here you find detailed descriptions and code examples of how individual parts can be used.

Key Features

  • Draggable layers
  • Create Map- and Feature layers on the fly
  • Stores state in local-storage
  • Draw objects including intersections
  • Measure both length and areas
  • Move vector-objects between feature-layers using cut, copy, paste
  • Snap interactions
    • Snap to segments and vertices
    • Snap to helplines between mouse and vertices
  • Merge drawings and measurements with different shape operations
  • Generate Markers
  • Generate Wind Barbs
  • Save locations as Bookmarks
  • Export PNG of canvas and additional HTML objects
  • Compare maps side by side
  • Light and Dark theme
  • Vertical and Horizontal layout
  • Built in debugging help
  • Parameters for customizability
  • Callback functions for integrations
  • Internationalization, included are:
    • English
    • Swedish
    • Easily extend with your own JSON language file

Language Files

There is a Language Project 🌎 where all available JSON files are kept. If you have a language file, feel free to post a PR to include it for others to use in that repo.

Tools

The following tools are implemented in the project. The tools are devided in two different categories, Hidden and Non-Hidden tools. The differenc is that Hidden tools are not displayed in the Toolbar, but only add functionality in the contextmenu.

Hidden Tools

  • HiddenAboutTool
  • HiddenMapNavigationTool
  • HiddenMarkerTool

Tools

  • BookmarkTool
  • CoordinatesTool
  • DebugInfoToo
  • DirectionTool
  • DrawTool
  • EditTool
  • ScissorsTool
  • ExportPngTool
  • FullscreenTool
  • GraticuleTool
  • HelpTool
  • HomeTool
  • ImportVectorLayerTool
  • InfoTool
  • LayerTool
  • MagnifyTool
  • MeasureTool
  • MyLocationTool
  • OverviewTool
  • RefreshTool
  • ResetNorthTool
  • ScaleLineTool
  • SettingsTool
  • SplitViewTool
  • ThemeTool
  • ToolboxTool
  • ZoomboxTool
  • ZoomInTool
  • ZoomOutTool

Versions

OpenLayers Toolbar (OLTB) OpenLayers (OL) Released (OLTB) Changelog (OLTB)
3.2.010.0.02024-08-16v3.2.0.md
3.1.010.0.02024-08-04v3.1.0.md
3.0.010.0.02024-08-01v3.0.0.md
2.3.09.1.02024-05-12v2.3.0.md
2.2.08.2.02024-02-12v2.2.0.md
2.1.08.2.02024-01-31v2.1.0.md
2.0.08.2.02024-01-14v2.0.0.md
1.1.07.4.02023-06-21v1.1.0.md
1.0.17.3.02023-03-20v1.0.1.md
1.0.07.3.02023-03-20v1.0.0.md

License

BSD-2-Clause License

Author

Qulle