MercatorPoint class

Объект MercatorPoint представляет проецированную трехмерную позицию. MercatorPoint использует проекцию веб-меркатора (EPSG:3857) с немного разными единицами:

  • размер 1 единицы — это ширина прогнозируемого мира, а не "меркатор метр"
  • исходное пространство координат находится в северо-западном углу, а не в середине.

Например, MercatorPoint(0, 0, 0) — это северо-западный угол мира меркатора, а MercatorPoint(1, 1, 0) — юго-восточный угол. Если вы знакомы с векторными плитками , может быть полезно представить пространство координат как плитку 0/0/0 с экстентом 1.

Измерение zMercatorPoint является конформным. Куб в пространстве координат меркатора будет отображаться как куб.

Extends

Array<number>

Конструкторы

MercatorPoint(number, number, number)

Создает MercatorPoint.

Свойства

Array

Унаследованные свойства

length

Получает или задает длину массива. Представляет собой число, на единицу превышающее индекс последнего определенного элемента массива.

Методы

fromPosition(Position)

Преобразует позицию в точку меркатора.

fromPositions(Position[])

Преобразует массив позиций в массив точек меркатора.

mercatorScale(number)

Определите коэффициент масштабирования Меркатора для заданной широты. См. раздел https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor На экваторе коэффициент масштабирования будет иметь значение 1, что увеличивается на более высоких широтах.

meterInMercatorUnits(number)

Возвращает расстояние в 1 метр в MercatorPoint единицах на этой широте. Для координат в единицах реального мира, использующих метры, это, естественно, обеспечивает масштаб для преобразования в MercatorPoints.

toFloat32Array(Position[])

Преобразует массив позиций в Float32Array значений xyz меркатора.

toPosition(MercatorPoint)

Преобразует точку меркатора в позицию карты.

toPositions(MercatorPoint[])

Преобразует массив точек меркатора в массив позиций карты.

Наследуемые методы

concat((T | ConcatArray<T>)[])

Объединяет два или более массивов.

concat(ConcatArray<number>[])

Объединяет два или более массивов.

every((value: number, index: number, array: number[]) => unknown, any)

Определяет, соответствуют ли все члены массива указанному тесту.

filter((value: number, index: number, array: number[]) => unknown, any)

Возвращает элементы массива, соответствующие условию, указанному в функции обратного вызова.

filter<S>((value: number, index: number, array: number[]) => value, any)

Возвращает элементы массива, соответствующие условию, указанному в функции обратного вызова.

forEach((value: number, index: number, array: number[]) => void, any)

Выполняет указанное действие для каждого элемента массива.

indexOf(number, number)

Возвращает индекс первого вхождения значения в массиве.

join(string)

Добавляет все элементы массива, разделенные указанной строкой разделителя.

lastIndexOf(number, number)

Возвращает индекс последнего вхождения указанного значения в массиве.

map<U>((value: number, index: number, array: number[]) => U, any)

Вызывает заданную функцию обратного вызова для каждого элемента массива и возвращает массив, содержащий результаты.

pop()

Удаляет последний элемент из массива и возвращает его.

push(number[])

Присоединяет новые элементы к массиву и возвращает новую длину массива.

reduce((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number)

Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

reduce((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, number)
reduce<U>((previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, U)

Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

reduceRight((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number)

Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

reduceRight((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, number)
reduceRight<U>((previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, U)

Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

reverse()

Обращает элементы в массиве.

shift()

Удаляет первый элемент из массива и возвращает его.

slice(number, number)

Возвращает фрагмент массива.

some((value: number, index: number, array: number[]) => unknown, any)

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

sort((a: number, b: number) => number)

Сортирует массив.

splice(number, number)

Удаляет элементы из массива и при необходимости вставляет на их место новые элементы, возвращая удаленные элементы.

splice(number, number, number[])

Удаляет элементы из массива и при необходимости вставляет на их место новые элементы, возвращая удаленные элементы.

toLocaleString()

Возвращает строковое представление массива. Элементы преобразуются в строку с помощью методов toLocalString.

toString()

Возвращает строковое представление массива.

unshift(number[])

Вставляет новые элементы в начало массива.

Сведения о конструкторе

MercatorPoint(number, number, number)

Создает MercatorPoint.

new MercatorPoint(x: number, y: number, z?: number)

Параметры

x

number

Позиция точек x в единицах меркатора.

y

number

Позиция точек y в единицах меркатора.

z

number

Позиция Z точек в единицах меркатора.

Сведения о свойстве

Array

static Array: ArrayConstructor

Значение свойства

ArrayConstructor

Сведения об унаследованном свойстве

length

Получает или задает длину массива. Представляет собой число, на единицу превышающее индекс последнего определенного элемента массива.

length: number

Значение свойства

number

Наследуется от Array.length

Сведения о методе

fromPosition(Position)

Преобразует позицию в точку меркатора.

static function fromPosition(position: Position): MercatorPoint

Параметры

position
Position

Позиция для преобразования.

Возвращаемое значение

Точка меркатора.

fromPositions(Position[])

Преобразует массив позиций в массив точек меркатора.

static function fromPositions(positions: Position[]): MercatorPoint[]

Параметры

positions

Position[]

Массив позиций для преобразования.

Возвращаемое значение

Массив точек меркатора.

mercatorScale(number)

Определите коэффициент масштабирования Меркатора для заданной широты. См. раздел https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor На экваторе коэффициент масштабирования будет иметь значение 1, что увеличивается на более высоких широтах.

static function mercatorScale(latitude: number): number

Параметры

latitude

number

Широта

Возвращаемое значение

number

Коэффициент масштабирования меркатора.

meterInMercatorUnits(number)

Возвращает расстояние в 1 метр в MercatorPoint единицах на этой широте. Для координат в единицах реального мира, использующих метры, это, естественно, обеспечивает масштаб для преобразования в MercatorPoints.

static function meterInMercatorUnits(latitude: number): number

Параметры

latitude

number

Возвращаемое значение

number

Расстояние 1 метр в MercatorPoint единицах.

toFloat32Array(Position[])

Преобразует массив позиций в Float32Array значений xyz меркатора.

static function toFloat32Array(positions: Position[]): Float32Array

Параметры

positions

Position[]

Массив позиций для преобразования.

Возвращаемое значение

Float32Array

Значение Float32Array значений меркатора xyz.

toPosition(MercatorPoint)

Преобразует точку меркатора в позицию карты.

static function toPosition(mercator: MercatorPoint): Position

Параметры

mercator
MercatorPoint

Преобразуемая точка Меркатора.

Возвращаемое значение

Позиция карты.

toPositions(MercatorPoint[])

Преобразует массив точек меркатора в массив позиций карты.

static function toPositions(mercators: MercatorPoint[]): Position[]

Параметры

mercators

MercatorPoint[]

Меркатор указывает на преобразование.

Возвращаемое значение

Массив позиций карты.

Сведения о наследуемом методе

concat((T | ConcatArray<T>)[])

Объединяет два или более массивов.

function concat(items: (T | ConcatArray<T>)[]): number[]

Параметры

items

(T | ConcatArray<T>)[]

Дополнительные элементы, добавляемые в конец массива array1.

Возвращаемое значение

number[]

Наследуется от Array.concat

concat(ConcatArray<number>[])

Объединяет два или более массивов.

function concat(items: ConcatArray<number>[]): number[]

Параметры

items

ConcatArray<number>[]

Дополнительные элементы, добавляемые в конец массива array1.

Возвращаемое значение

number[]

Наследуется от Array.concat

every((value: number, index: number, array: number[]) => unknown, any)

Определяет, соответствуют ли все члены массива указанному тесту.

function every(callbackfn: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean

Параметры

callbackfn

(value: number, index: number, array: number[]) => unknown

Функция, которая принимает до 3 аргументов. Каждый метод вызывает функцию callbackfn для каждого элемента в массиве, пока callbackfn не вернет значение, которое является принудительным к логическому значению false или до конца массива.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Возвращаемое значение

boolean

Наследуется от Array.every

filter((value: number, index: number, array: number[]) => unknown, any)

Возвращает элементы массива, соответствующие условию, указанному в функции обратного вызова.

function filter(callbackfn: (value: number, index: number, array: number[]) => unknown, thisArg?: any): number[]

Параметры

callbackfn

(value: number, index: number, array: number[]) => unknown

Функция, которая принимает до 3 аргументов. Метод фильтра вызывает функцию callbackfn один раз для каждого элемента в массиве.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Возвращаемое значение

number[]

Наследуется от Array.filter

filter<S>((value: number, index: number, array: number[]) => value, any)

Возвращает элементы массива, соответствующие условию, указанному в функции обратного вызова.

function filter<S>(callbackfn: (value: number, index: number, array: number[]) => value, thisArg?: any): S[]

Параметры

callbackfn

(value: number, index: number, array: number[]) => value

Функция, которая принимает до 3 аргументов. Метод фильтра вызывает функцию callbackfn один раз для каждого элемента в массиве.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Возвращаемое значение

S[]

Наследуется от Array.filter

forEach((value: number, index: number, array: number[]) => void, any)

Выполняет указанное действие для каждого элемента массива.

function forEach(callbackfn: (value: number, index: number, array: number[]) => void, thisArg?: any)

Параметры

callbackfn

(value: number, index: number, array: number[]) => void

Функция, которая принимает до 3 аргументов. forEach вызывает функцию callbackfn один раз для каждого элемента в массиве.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Наследуется от Array.forEach

indexOf(number, number)

Возвращает индекс первого вхождения значения в массиве.

function indexOf(searchElement: number, fromIndex?: number): number

Параметры

searchElement

number

Значение, которое необходимо найти в массиве.

fromIndex

number

Индекс массива, с которого начинается поиск. Если параметр fromIndex опущен, поиск начинается с индекса 0.

Возвращаемое значение

number

Наследуется от Array.indexOf

join(string)

Добавляет все элементы массива, разделенные указанной строкой разделителя.

function join(separator?: string): string

Параметры

separator

string

Строка, используемая для отделения одного элемента массива от следующего в результирующем элементе String. Если этот параметр опущен, элементы массива разделяются запятыми.

Возвращаемое значение

string

Наследуется от Array.join

lastIndexOf(number, number)

Возвращает индекс последнего вхождения указанного значения в массиве.

function lastIndexOf(searchElement: number, fromIndex?: number): number

Параметры

searchElement

number

Значение, которое необходимо найти в массиве.

fromIndex

number

Индекс массива, с которого начинается поиск. Если параметр fromIndex опущен, поиск начинается с последнего индекса в массиве.

Возвращаемое значение

number

Наследуется от Array.lastIndexOf

map<U>((value: number, index: number, array: number[]) => U, any)

Вызывает заданную функцию обратного вызова для каждого элемента массива и возвращает массив, содержащий результаты.

function map<U>(callbackfn: (value: number, index: number, array: number[]) => U, thisArg?: any): U[]

Параметры

callbackfn

(value: number, index: number, array: number[]) => U

Функция, которая принимает до 3 аргументов. Метод map вызывает функцию callbackfn один раз для каждого элемента в массиве.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Возвращаемое значение

U[]

Наследуется от Array.map

pop()

Удаляет последний элемент из массива и возвращает его.

function pop(): number | undefined

Возвращаемое значение

number | undefined

Наследуется от Array.pop

push(number[])

Присоединяет новые элементы к массиву и возвращает новую длину массива.

function push(items: number[]): number

Параметры

items

number[]

Новые элементы массива.

Возвращаемое значение

number

Наследуется от Array.push

reduce((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number)

Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

function reduce(callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number

Параметры

callbackfn

(previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number

Функция, которая принимает до четырех аргументов. Метод reduce вызывает функцию callbackfn один раз для каждого элемента в массиве.

Возвращаемое значение

number

Наследуется от Array.reduce

reduce((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, number)

function reduce(callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number

Параметры

callbackfn

(previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number

initialValue

number

Возвращаемое значение

number

Наследуется от Array.reduce

reduce<U>((previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, U)

Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

function reduce<U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U

Параметры

callbackfn

(previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U

Функция, которая принимает до четырех аргументов. Метод reduce вызывает функцию callbackfn один раз для каждого элемента в массиве.

initialValue

U

Если задан параметр initialValue, он используется в качестве начального значения для запуска накопления. Первый вызов функции callbackfn предоставляет это значение в качестве аргумента, а не значения массива.

Возвращаемое значение

U

Наследуется от Array.reduce

reduceRight((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number)

Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

function reduceRight(callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number): number

Параметры

callbackfn

(previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number

Функция, которая принимает до четырех аргументов. Метод reduceRight вызывает функцию callbackfn один раз для каждого элемента в массиве.

Возвращаемое значение

number

Наследуется от Array.reduceRight

reduceRight((previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, number)

function reduceRight(callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number, initialValue: number): number

Параметры

callbackfn

(previousValue: number, currentValue: number, currentIndex: number, array: number[]) => number

initialValue

number

Возвращаемое значение

number

Наследуется от Array.reduceRight

reduceRight<U>((previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, U)

Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова.

function reduceRight<U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U, initialValue: U): U

Параметры

callbackfn

(previousValue: U, currentValue: number, currentIndex: number, array: number[]) => U

Функция, которая принимает до четырех аргументов. Метод reduceRight вызывает функцию callbackfn один раз для каждого элемента в массиве.

initialValue

U

Если задан параметр initialValue, он используется в качестве начального значения для запуска накопления. Первый вызов функции callbackfn предоставляет это значение в качестве аргумента, а не значения массива.

Возвращаемое значение

U

Наследуется от Array.reduceRight

reverse()

Обращает элементы в массиве.

function reverse(): number[]

Возвращаемое значение

number[]

Наследуется от Array.reverse

shift()

Удаляет первый элемент из массива и возвращает его.

function shift(): number | undefined

Возвращаемое значение

number | undefined

Наследуется от Array.shift

slice(number, number)

Возвращает фрагмент массива.

function slice(start?: number, end?: number): number[]

Параметры

start

number

Начало указанной части массива.

end

number

Конец указанной части массива. Это не является элементом в индексе "end".

Возвращаемое значение

number[]

Наследуется от Array.slice

some((value: number, index: number, array: number[]) => unknown, any)

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

function some(callbackfn: (value: number, index: number, array: number[]) => unknown, thisArg?: any): boolean

Параметры

callbackfn

(value: number, index: number, array: number[]) => unknown

Функция, которая принимает до 3 аргументов. Метод some вызывает функцию callbackfn для каждого элемента в массиве, пока callbackfn не вернет значение, которое является принудительным к логическому значению true или до конца массива.

thisArg

any

Объект, на который может ссылаться ключевое слово this в функции callbackfn. Если параметр thisArg опущен, в качестве этого значения используется undefined.

Возвращаемое значение

boolean

Наследуется от Array.some

sort((a: number, b: number) => number)

Сортирует массив.

function sort(compareFn?: (a: number, b: number) => number): this

Параметры

compareFn

(a: number, b: number) => number

Функция, используемая для определения порядка элементов. Ожидается, что он вернет отрицательное значение, если первый аргумент меньше второго аргумента, ноль, если они равны, и положительное значение в противном случае. Если этот параметр опущен, элементы сортируются по возрастанию, в порядке символов ASCII.

[11,2,22,1].sort((a, b) => a - b)

Возвращаемое значение

this

Наследуется от Array.sort

splice(number, number)

Удаляет элементы из массива и при необходимости вставляет на их место новые элементы, возвращая удаленные элементы.

function splice(start: number, deleteCount?: number): number[]

Параметры

start

number

Отсчитывающее от нуля расположение в массиве, с которого начинается удаление элементов.

deleteCount

number

Число удаляемых элементов.

Возвращаемое значение

number[]

Наследуется от Array.splice

splice(number, number, number[])

Удаляет элементы из массива и при необходимости вставляет на их место новые элементы, возвращая удаленные элементы.

function splice(start: number, deleteCount: number, items: number[]): number[]

Параметры

start

number

Отсчитывающее от нуля расположение в массиве, с которого начинается удаление элементов.

deleteCount

number

Число удаляемых элементов.

items

number[]

Элементы для вставки в массив вместо удаленных элементов.

Возвращаемое значение

number[]

Наследуется от Array.splice

toLocaleString()

Возвращает строковое представление массива. Элементы преобразуются в строку с помощью методов toLocalString.

function toLocaleString(): string

Возвращаемое значение

string

Наследуется от Array.toLocaleString

toString()

Возвращает строковое представление массива.

function toString(): string

Возвращаемое значение

string

Наследуется от Array.toString

unshift(number[])

Вставляет новые элементы в начало массива.

function unshift(items: number[]): number

Параметры

items

number[]

Элементы для вставки в начале массива.

Возвращаемое значение

number

Наследуется от Array.unshift