MercatorPoint class
Объект MercatorPoint
представляет проецированную трехмерную позицию.
MercatorPoint
использует проекцию веб-меркатора (EPSG:3857) с немного разными единицами:
- размер 1 единицы — это ширина прогнозируемого мира, а не "меркатор метр"
- исходное пространство координат находится в северо-западном углу, а не в середине.
Например, MercatorPoint(0, 0, 0)
— это северо-западный угол мира меркатора, а MercatorPoint(1, 1, 0)
— юго-восточный угол. Если вы знакомы с векторными плитками , может быть полезно представить пространство координат как плитку 0/0/0
с экстентом 1
.
Измерение z
MercatorPoint
является конформным. Куб в пространстве координат меркатора будет отображаться как куб.
- Extends
-
Array<number>
Конструкторы
Mercator |
Создает MercatorPoint. |
Свойства
Array |
Унаследованные свойства
length | Получает или задает длину массива. Представляет собой число, на единицу превышающее индекс последнего определенного элемента массива. |
Методы
from |
Преобразует позицию в точку меркатора. |
from |
Преобразует массив позиций в массив точек меркатора. |
mercator |
Определите коэффициент масштабирования Меркатора для заданной широты. См. раздел https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor На экваторе коэффициент масштабирования будет иметь значение 1, что увеличивается на более высоких широтах. |
meter |
Возвращает расстояние в 1 метр в |
to |
Преобразует массив позиций в Float32Array значений xyz меркатора. |
to |
Преобразует точку меркатора в позицию карты. |
to |
Преобразует массив точек меркатора в массив позиций карты. |
Наследуемые методы
concat((T | Concat |
Объединяет два или более массивов. |
concat(Concat |
Объединяет два или более массивов. |
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) | Возвращает элементы массива, соответствующие условию, указанному в функции обратного вызова. |
for |
Выполняет указанное действие для каждого элемента массива. |
index |
Возвращает индекс первого вхождения значения в массиве. |
join(string) | Добавляет все элементы массива, разделенные указанной строкой разделителя. |
last |
Возвращает индекс последнего вхождения указанного значения в массиве. |
map<U>((value: number, index: number, array: number[]) => U, any) | Вызывает заданную функцию обратного вызова для каждого элемента массива и возвращает массив, содержащий результаты. |
pop() | Удаляет последний элемент из массива и возвращает его. |
push(number[]) | Присоединяет новые элементы к массиву и возвращает новую длину массива. |
reduce((previous |
Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова. |
reduce((previous |
|
reduce<U>((previous |
Вызывает указанную функцию обратного вызова для всех элементов в массиве. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова. |
reduce |
Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова. |
reduce |
|
reduce |
Вызывает указанную функцию обратного вызова для всех элементов массива в порядке убывания. Возвращаемое значение функции обратного вызова — накопленный результат. Оно предоставляется как аргумент в следующем вызове функции обратного вызова. |
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[]) | Удаляет элементы из массива и при необходимости вставляет на их место новые элементы, возвращая удаленные элементы. |
to |
Возвращает строковое представление массива. Элементы преобразуются в строку с помощью методов toLocalString. |
to |
Возвращает строковое представление массива. |
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
единицах на этой широте.
Для координат в единицах реального мира, использующих метры, это, естественно, обеспечивает масштаб для преобразования в MercatorPoint
s.
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
Меркатор указывает на преобразование.
Возвращаемое значение
Position[]
Массив позиций карты.
Сведения о наследуемом методе
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