MercatorPoint class
MercatorPoint
物件代表投影的三維位置。
MercatorPoint
會使用 Web mercator 投影 (EPSG:3857) 稍微不同的單位:
- 1 單位的大小是投影世界寬度,而不是「mercator meter」
- 座標空間的原點位於北角,而不是中間。
例如, MercatorPoint(0, 0, 0)
是 Mercator 世界北部的角落,而 MercatorPoint(1, 1, 0)
是南東部角落。 如果您熟悉 向量磚 ,將座標空間 0/0/0
視為具有 範圍 1
的磚可能會很有説明。
的 z
MercatorPoint
維度是一致性的。 Mercator 座標空間中的 Cube 會轉譯為 Cube。
- Extends
-
Array<number>
建構函式
Mercator |
建構 MercatorPoint。 |
屬性
Array |
繼承的屬性
length | 取得或設定陣列的長度。 這是比陣列所定義最高項目高一的數字。 |
方法
from |
將位置轉換成 Mercator 點。 |
from |
將位置陣列轉換成 Mercator 點陣列。 |
mercator |
判斷指定緯度的 Mercator 縮放比例,請參閱 https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor 在等號下縮放比例會是 1,這會在較高的緯度增加。 |
meter |
傳回此緯度單位為 1 公尺 |
to |
將位置陣列轉換成 Mercator xyz 值的 Float32Array。 |
to |
將 Mercator 點轉換成地圖位置。 |
to |
將 Mercator 點的陣列轉換成地圖位置的陣列。 |
繼承的方法
建構函式詳細資料
MercatorPoint(number, number, number)
建構 MercatorPoint。
new MercatorPoint(x: number, y: number, z?: number)
參數
- x
-
number
以 mercator 單位為單位的點 x 位置。
- y
-
number
以 Mercator 單位為單位的點 y 位置。
- z
-
number
以 mercator 單位為單位的點 z 位置。
屬性詳細資料
Array
static Array: ArrayConstructor
屬性值
ArrayConstructor
繼承的屬性詳細資料
length
取得或設定陣列的長度。 這是比陣列所定義最高項目高一的數字。
length: number
屬性值
number
繼承自 Array.length
方法詳細資料
fromPosition(Position)
將位置轉換成 Mercator 點。
static function fromPosition(position: Position): MercatorPoint
參數
- position
- Position
要轉換的位置。
傳回
Mercator 點。
fromPositions(Position[])
將位置陣列轉換成 Mercator 點陣列。
static function fromPositions(positions: Position[]): MercatorPoint[]
參數
- positions
-
Position[]
要轉換的位置陣列。
傳回
Mercator 點的陣列。
mercatorScale(number)
判斷指定緯度的 Mercator 縮放比例,請參閱 https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor 在等號下縮放比例會是 1,這會在較高的緯度增加。
static function mercatorScale(latitude: number): number
參數
- latitude
-
number
緯度
傳回
number
Mercator 縮放比例。
meterInMercatorUnits(number)
傳回此緯度單位為 1 公尺 MercatorPoint
的距離。
對於使用公尺的實際單位座標,這會自然地提供要轉換成 MercatorPoint
的縮放比例。
static function meterInMercatorUnits(latitude: number): number
參數
- latitude
-
number
傳回
number
單位為 1 公尺 MercatorPoint
的距離。
toFloat32Array(Position[])
將位置陣列轉換成 Mercator xyz 值的 Float32Array。
static function toFloat32Array(positions: Position[]): Float32Array
參數
- positions
-
Position[]
要轉換的位置陣列。
傳回
Float32Array
Mercator xyz 值的 Float32Array。
toPosition(MercatorPoint)
將 Mercator 點轉換成地圖位置。
static function toPosition(mercator: MercatorPoint): Position
參數
- mercator
- MercatorPoint
要轉換的 Mercator 點。
傳回
地圖位置。
toPositions(MercatorPoint[])
將 Mercator 點的陣列轉換成地圖位置的陣列。
static function toPositions(mercators: MercatorPoint[]): Position[]
參數
- mercators
要轉換的 Mercator 點。
傳回
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
最多可以接受三個引數的函式。 每個方法都會針對陣列中的每個元素呼叫 callbackfn 函式,直到 callbackfn 傳回可強制布林值 false 的值,或直到陣列結尾為止。
- thisArg
-
any
這個關鍵字可以在 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
最多可以接受三個引數的函式。 篩選方法會針對陣列中的每個元素呼叫 callbackfn 函式一次。
- thisArg
-
any
這個關鍵字可以在 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
最多可以接受三個引數的函式。 篩選方法會針對陣列中的每個元素呼叫 callbackfn 函式一次。
- thisArg
-
any
這個關鍵字可以在 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
最多可以接受三個引數的函式。 forEach 會針對陣列中的每個元素呼叫 callbackfn 函式一次。
- thisArg
-
any
這個關鍵字可以在 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
最多可以接受三個引數的函式。 map 方法會針對陣列中的每個元素呼叫 callbackfn 函式一次。
- thisArg
-
any
這個關鍵字可以在 callbackfn 函式中參考的物件。 如果省略 thisArg,則會使用 undefined 作為此值。
傳回
U[]
繼承自 Array.map
pop()
移除陣列的最後一個元素,然後將它傳回。
function pop(): number | undefined
傳回
number | undefined
繼承自 Array.pop
push(number[])
附加新元素到陣列中,並傳回陣列的新長度。
function push(items: number[]): number
參數
- items
-
number[]
Array 的新元素。
傳回
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()
反轉 Array 中的專案。
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
最多可以接受三個引數的函式。 某些方法會呼叫陣列中每個專案的 callbackfn 函式,直到 callbackfn 傳回可強制布林值 true 的值,或直到陣列結尾為止。
- thisArg
-
any
這個關鍵字可以在 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