@yandex/ymaps3-web-mercator-projection package

Web Mercator projection package for Yandex JS API.

Install

You can install this package via npm:

npm install --save @yandex/ymaps3-web-mercator-projection

How use

To use Web Mercator projection, just import it:

import {WebMercator} from '@yandex/ymaps3-web-mercator-projection';

const projection = new WebMercator();

console.log(projection.toWorldCoordinates([-180, 90])); // {x: -1, y: 1}
console.log(projection.toWorldCoordinates([-180, 85.051])); // ~ {x: -1, y: 1}
console.log(projection.toWorldCoordinates([90, 0])); // ~ {x: 0.5, y: 0}
console.log(projection.toWorldCoordinates([0, -23.6])); // ~ {x: 0, y: -0.135}

console.log(projection.fromWorldCoordinates({x: -1, y: 1})); // ~ [-180, 85.051]
console.log(projection.fromWorldCoordinates({x: 0.5, y: 0})); // [90, 0]
console.log(projection.fromWorldCoordinates({x: 0, y: -0.135})); // ~ [0, -23.6]

Usage without npm

You can use CDN with module loading handler in JS API on your page.

By default ymaps3.import can load self modules. Just use ymaps3.registerCdn and ymaps3.import:

// register in `ymaps3.import` which CDN to take the package from
ymaps3.import.registerCdn('https://cdn.jsdelivr.net/npm/{package}', '@yandex/ymaps3-web-mercator-projection@latest');

// ...

// import package from CDN
const {WebMercator} = await ymaps3.import('@yandex/ymaps3-web-mercator-projection');