ol/proj

import * as olProj from 'ol/proj';

Функции

addCoordinateTransforms(source, destination, forward, inverse) proj.js, строка 413

import {addCoordinateTransforms} from 'ol/proj';

Регистрирует функции преобразования координат для преобразования координат между исходной проекцией и проекцией назначения. Функции forward и inverse преобразуют пары координат; эта функция преобразует их в функции, используемые внутри, которые также обрабатывают области и массивы координат.

Имя	Тип	Описание
`source`	ProjectionLike	Исходная проекция.
`destination`	ProjectionLike	Проекция назначения.
`forward`	function	Функция прямого преобразования (то есть, от исходной проекции к проекции назначения), которая принимает `Coordinate` в качестве аргумента и возвращает преобразованную `Coordinate`.
`inverse`	function	Функция обратного преобразования (то есть, от проекции назначения к исходной проекции), которая принимает `Coordinate` в качестве аргумента и возвращает преобразованную `Coordinate`. Если функция преобразования может преобразовать меньше измерений, чем входные координаты, она должна вернуть координату только с длиной, которую она может преобразовать. Другие измерения будут взяты без изменений из источника.

addEquivalentProjections(projections) proj.js, строка 297

import {addEquivalentProjections} from 'ol/proj';

Регистрирует функции преобразования, которые не изменяют координаты. Они позволяют преобразовывать между проекциями с одинаковым значением.

Имя	Тип	Описание
`projections`	Array<Projection>	Проекции.

addProjection(projection) proj.js, строка 177

import {addProjection} from 'ol/proj';

Добавляет объект Projection в список поддерживаемых проекций, которые можно искать по их коду.

Имя	Тип	Описание
`projection`	Projection	Экземпляр Projection.

clearUserProjection() proj.js, строка 677

import {clearUserProjection} from 'ol/proj';

Очищает пользовательскую проекцию, если она установлена.

equivalent(projection1, projection2){boolean} proj.js, строка 478

import {equivalent} from 'ol/proj';

Проверяет, являются ли две проекции одинаковыми, то есть каждая координата в одной проекции представляет ту же географическую точку, что и та же координата в другой проекции.

Имя	Тип	Описание
`projection1`	Projection	Проекция 1.
`projection2`	Projection	Проекция 2.

Возвращает:

Являются ли проекции эквивалентными.

fromLonLat(coordinate, projection){Coordinate} proj.js, строка 437

import {fromLonLat} from 'ol/proj';

Преобразует координаты из долготы/широты в другую проекцию.

Имя	Тип	Описание
`coordinate`	Coordinate	Координаты как долгота и широта, т.е. массив с долготой в качестве первого и широтой в качестве второго элемента.
`projection`	ProjectionLike \| undefined	Целевая проекция. По умолчанию - Web Mercator, т.е. 'EPSG:3857'.

Возвращает:

Проецированные координаты в целевой проекции.

get(projectionLike){Projection | null} proj.js, строка 198

import {get} from 'ol/proj';

Получает объект Projection для указанного кода.

Имя	Тип	Описание
`projectionLike`	ProjectionLike	Строка кода, которая представляет собой комбинацию авторитета и идентификатора, например, "EPSG:4326", или существующий объект projection, или undefined.

Возвращает:

Объект Projection или null, если он не найден.

getPointResolution(projection, resolution, point, units){number} proj.js, строка 235

import {getPointResolution} from 'ol/proj';

Получает разрешение точки в градусах или единицах расстояния. Для проекций с градусами в качестве единицы это просто возвращает предоставленное разрешение. Для других проекций разрешение точки по умолчанию оценивается путем преобразования point пикселя в EPSG:4326, измерения его ширины и высоты на обычном шаре и взятия среднего значения ширины и высоты. Для определённой проекции может быть предоставлена пользовательская функция, либо путем установки опции getPointResolution в конструкторе Projection, либо с помощью setGetPointResolution для изменения существующего объекта projection.

Имя	Тип	Описание
`projection`	ProjectionLike	Проекция.
`resolution`	number	Номинальное разрешение в единицах проекции.
`point`	Coordinate	Точка, для которой нужно найти скорректированное разрешение.
`units`	Units \| undefined	Единицы, в которых нужно получить разрешение точки. По умолчанию — единицы проекции.

Возвращает:

Разрешение точки.

getTransform(source, destination){TransformFunction} proj.js, line 586

import {getTransform} from 'ol/proj';

Исходя из объектов, подобных проекциям, ищет функцию преобразования для преобразования массива координат из исходной проекции в целевую проекцию.

Имя	Тип	Описание
`source`	ProjectionLike	Исходная проекция.
`destination`	ProjectionLike	Целевая проекция.

Возвращает:

Функция преобразования.

getUserProjection(){Projection | null} proj.js, line 686

import {getUserProjection} from 'ol/proj';

Получить проекцию для координат, предоставляемых и возвращаемых методами API.

Возвращает:

Проекция пользователя (или null, если не задана).

setUserProjection(projection) proj.js, line 669

import {setUserProjection} from 'ol/proj';

Установить проекцию для координат, предоставляемых и возвращаемых методами API. Это включает все методы API, за исключением методов, взаимодействующих с сетками тайлов, а также FrameState и State.

Имя	Тип	Описание
`projection`	ProjectionLike	Проекция пользователя.

toLonLat(coordinate, projection){Coordinate} proj.js, line 455

import {toLonLat} from 'ol/proj';

Преобразует координаты в долготу/широту.

Имя	Тип	Описание
`coordinate`	Coordinate	Проектированные координаты.
`projection`	ProjectionLike \| undefined	Проекция координат. По умолчанию — Web Mercator, т. е. 'EPSG:3857'.

Возвращает:

Координаты в виде долготы и широты, т. е. массив с долготой в качестве первого и широтой в качестве второго элемента.

transform(coordinate, source, destination){Coordinate} proj.js, line 608

import {transform} from 'ol/proj';

Преобразует координаты из исходной проекции в целевую проекцию. Возвращает новые координаты (не изменяет исходные). Если преобразования между двумя проекциями недоступно, функция вызовет ошибку.

См. transformExtent для преобразования охватывающего прямоугольника. См. метод transform объекта Geometry и его подклассов для преобразования геометрии.

Имя	Тип	Описание
`coordinate`	Coordinate	Координата.
`source`	ProjectionLike	Исходная проекция.
`destination`	ProjectionLike	Целевая проекция.

Возвращает:

Координата.

transformExtent(extent, source, destination, stops){Extent} proj.js, line 632

import {transformExtent} from 'ol/proj';

Преобразует охватывающий прямоугольник из исходной проекции в целевую проекцию. Возвращает новый охватывающий прямоугольник (не изменяет исходный).

Имя	Тип	Описание
`extent`	Extent	Охватывающий прямоугольник для преобразования.
`source`	ProjectionLike	Исходная проекция.
`destination`	ProjectionLike	Целевая проекция.
`stops`	number \| undefined	Количество точек на стороне, используемых для преобразования. По умолчанию используются только углы.

Возвращает:

Преобразованный охватывающий прямоугольник.

useGeographic() proj.js, line 696

import {useGeographic} from 'ol/proj';

Использовать географические координаты (система координат WGS-84) в методах API. Это включает все методы API, за исключением методов, взаимодействующих с сетками тайлов, а также FrameState и State.

Определения типов

ProjectionLike{Проекция} {строка} {undefined}

Проекция как Projection, строка идентификатора СК или undefined.

TransformFunction(input, output, dimension, stride){Массив.<число>} proj.js, строка 107

Функция преобразования принимает массив входных координат, необязательный выходной массив и необязательную размерность (по умолчанию 2). Функция преобразует входные координаты, заполняет выходной массив и возвращает выходной массив.

Имя	Тип	Описание
`input`	Массив.<число>
`output`	Массив.<число> \| undefined
`dimension`	число \| undefined
`stride`	число \| undefined

Transforms{Объект}

Свойства:

Имя	Тип	Описание
`forward`	TransformFunction	Прямое преобразование (из географических координат).
`inverse`	TransformFunction	Обратное преобразование (в географические координаты).