@2gis/mapgl-ruler NPM

mapgl-ruler

Ruler plugin for Mapgl

Usage

Install with NPM

npm install @2gis/mapgl-ruler

Use ruler directly

Import the Ruler class to your project and use it:

import { Ruler } from '@2gis/mapgl-ruler';

const map = new mapgl.Map('container', {
    center: [55.31878, 25.23584],
    zoom: 13,
    key: 'Your API access key',
});

const ruler = new Ruler(map, { 
    points: [
        [55.31878, 25.23584],
        [55.35878, 25.23584],
        [55.35878, 25.26584],
    ]
});

Use ruler via RulerControl

Import the RulerControl class to your project and use it:

import { RulerControl } from "@2gis/mapgl-ruler";

const map = new mapgl.Map('container', {
    center: [55.31878, 25.23584],
    zoom: 13,
    key: 'Your API access key',
});

const control = new RulerControl(map, { position: 'centerRight' })

Contributing

Mapgl-ruler uses github-flow to accept & merge fixes and improvements. Basic process is:

Fork the repo.
Create a branch.
Add or fix some code.
Run testing suite with npm run docker:test and make sure nothing is broken
Add some tests for your new code or fix broken tests.
Commit & push.
Create a new pull request to original repo.

Pull requests with failing tests will not be accepted. Also, if you modify packages or add them to package.json, make sure you use npm and update package-lock.json.

Tests

Run tests

npm run docker:test

Update screenshots

npm run docker:screenshot:update

Release

npm

Update the package version by running npm version patch|minor|major. This command returns a new package version. Let assume it's 1.2.3
Push changes to github and merge them to the «master» branch
Go to https://github.com/2gis/mapgl-ruler/releases/new
Click the «Choose tag» button and create a new tag according to the version in package.json, for example v1.2.3
Make sure the release target is the «master» branch
Paste the release tag into the «Release title» field, for example v1.2.3
Add a release description
Click the «Publish release» button
Go to https://github.com/2gis/mapgl-ruler/actions and wait for completing the release workflow