MercatorPoint class

套件:

azure-maps-control

MercatorPoint物件代表投影的三維位置。 MercatorPoint 會使用 Web mercator 投影 (EPSG：3857) 稍微不同的單位：

• 1 單位的大小是投影世界寬度，而不是「mercator meter」
• 座標空間的原點位於北角，而不是中間。

例如， MercatorPoint(0, 0, 0) 是 Mercator 世界北部的角落，而 MercatorPoint(1, 1, 0) 是南東部角落。 如果您熟悉 向量磚 ，將座標空間 0/0/0 視為具有 範圍 1 的磚可能會很有説明。

的 zMercatorPoint 維度是一致性的。 Mercator 座標空間中的 Cube 會轉譯為 Cube。

Extends

Array<number>

建構函式

MercatorPoint(number, number, number)

建構 MercatorPoint。

屬性

Array

繼承的屬性

length

取得或設定陣列的長度。 這是比陣列所定義最高項目高一的數字。

方法

fromPosition(Position)	將位置轉換成 Mercator 點。
fromPositions(Position[])	將位置陣列轉換成 Mercator 點陣列。
mercatorScale(number)	判斷指定緯度的 Mercator 縮放比例，請參閱 https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor 在等號下縮放比例會是 1，這會在較高的緯度增加。
meterInMercatorUnits(number)	傳回此緯度單位為 1 公尺 MercatorPoint 的距離。 對於使用公尺的實際單位座標，這會自然地提供要轉換成 MercatorPoint 的縮放比例。
toFloat32Array(Position[])	將位置陣列轉換成 Mercator xyz 值的 Float32Array。
toPosition(MercatorPoint)	將 Mercator 點轉換成地圖位置。
toPositions(MercatorPoint[])	將 Mercator 點的陣列轉換成地圖位置的陣列。

繼承的方法

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()	反轉 Array 中的專案。
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

以 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

要轉換的位置。

傳回

MercatorPoint

Mercator 點。

fromPositions(Position[])

將位置陣列轉換成 Mercator 點陣列。

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

參數

positions

Position[]

要轉換的位置陣列。

傳回

MercatorPoint[]

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 點。

傳回

Position

地圖位置。

toPositions(MercatorPoint[])

將 Mercator 點的陣列轉換成地圖位置的陣列。

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

參數

mercators

MercatorPoint[]

要轉換的 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