ol/координата

Функции

add(координата, дельта){Координата}

coordinate.js, строка 41

import {add} from 'ol/coordinate';

Добавить delta к coordinate. coordinate изменяется на месте и возвращается функцией.

Пример:

import {add} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
add(coord, [-2, 4]);
// coord is now [5.85, 51.983333]

Имя	Тип	Описание
coordinate	Координата	Координата.
delta	Координата	Дельта.

Возвращает:

Входная координата, скорректированная заданной дельтой.

createStringXY(числоДесятичныхЗнаков){ФорматКоординат}

coordinate.js, строка 144

import {createStringXY} from 'ol/coordinate';

Возвращает функцию CoordinateFormat, которую можно использовать для форматирования {Coordinate} в строку.

Пример без указания числа десятичных знаков:

import {createStringXY} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const stringifyFunc = createStringXY();
const out = stringifyFunc(coord);
// out is now '8, 48'

Пример с явным указанием 2 десятичных знаков:

import {createStringXY} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const stringifyFunc = createStringXY(2);
const out = stringifyFunc(coord);
// out is now '7.85, 47.98'

Имя	Тип	Описание
fractionDigits	число | undefined	Количество цифр после запятой. По умолчанию 0.

Возвращает:

Формат координат.

format(координата, шаблон, числоДесятичныхЗнаков){строка}

coordinate.js, строка 227

import {format} from 'ol/coordinate';

Преобразует заданную Coordinate в строку с использованием заданного шаблона строки. Строки {x} и {y} в шаблоне будут заменены соответственно первыми и вторыми значениями координат.

Пример без указания числа десятичных знаков:

import {format} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const template = 'Coordinate is ({x}|{y}).';
const out = format(coord, template);
// out is now 'Coordinate is (8|48).'

Пример с явным указанием числа десятичных знаков:

import {format} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const template = 'Coordinate is ({x}|{y}).';
const out = format(coord, template, 2);
// out is now 'Coordinate is (7.85|47.98).'

Имя	Тип	Описание
coordinate	Координата	Координата.
template	строка	Строка-шаблон с заменителями {x} и {y}, которые будут заменены первыми и вторыми значениями координат.
fractionDigits	число | undefined	Количество цифр после запятой. По умолчанию 0.

Возвращает:

Отформатированная координата.

rotate(координата, угол){Координата}

coordinate.js, строка 270

import {rotate} from 'ol/coordinate';

Повернуть coordinate на angle. coordinate изменяется на месте и возвращается функцией.

Пример:

import {rotate} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const rotateRadians = Math.PI / 2; // 90 degrees
rotate(coord, rotateRadians);
// coord is now [-47.983333, 7.85]

Имя	Тип	Описание
coordinate	Координата	Координата.
angle	число	Угол в радианах.

Возвращает:

Координата.

toStringHDMS(координата, числоДесятичныхЗнаков){строка}

coordinate.js, строка 361

import {toStringHDMS} from 'ol/coordinate';

Форматирование географической координаты с указанием полушария, градусов, минут и секунд.

Пример без указания числа десятичных знаков:

import {toStringHDMS} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const out = toStringHDMS(coord);
// out is now '47° 58′ 60″ N 7° 50′ 60″ E'

Пример с явным указанием 1 десятичного знака:

import {toStringHDMS} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const out = toStringHDMS(coord, 1);
// out is now '47° 58′ 60.0″ N 7° 50′ 60.0″ E'

Имя	Тип	Описание
coordinate	Координата	Координата.
fractionDigits	число | undefined	Количество цифр после запятой. По умолчанию 0.

Возвращает:

Полушарие, градусы, минуты и секунды.

toStringXY(координата, числоДесятичныхЗнаков){строка}

coordinate.js, строка 397

import {toStringXY} from 'ol/coordinate';

Форматирование координаты как строки, разделенной запятой.

Пример без указания числа десятичных знаков:

import {toStringXY} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const out = toStringXY(coord);
// out is now '8, 48'

Пример с явным указанием 1 десятичного знака:

import {toStringXY} from 'ol/coordinate.js';

const coord = [7.85, 47.983333];
const out = toStringXY(coord, 1);
// out is now '7.8, 48.0'

Имя	Тип	Описание
coordinate	Координата	Координата.
fractionDigits	число | undefined	Количество цифр после запятой. По умолчанию 0.

Возвращает:

XY.

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

Координата{Массив.<число>}

Массив чисел, представляющий xy, xyz или xyzm координату. Пример: [16, 48].

ФорматКоординат()

coordinate.js, строка 15

Функция, которая принимает Coordinate и преобразует его в {string}.