你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

MercatorPoint class

参考

包:: azure-maps-control

对象 MercatorPoint 表示投影的三维位置。 MercatorPoint 使用 web 墨卡托投影 (EPSG：3857) ，单位略有不同：

1 个单位的大小是投影世界的宽度，而不是“墨卡器计量”
坐标空间的原点位于西北角，而不是中间角。

例如， MercatorPoint(0, 0, 0) 是 mercator 世界的西北角，是 MercatorPoint(1, 1, 0) 东南角。如果熟悉矢量图块，将坐标空间视为 0/0/0 范围为的 1磁贴可能会有所帮助。

的zMercatorPoint维度是一致性的。墨卡器坐标空间中的立方体将呈现为多维数据集。

Extends: Array<number>

构造函数

MercatorPoint(number, number, number)

构造 MercatorPoint。

属性

Array

继承属性

length

获取或设置数组的长度。此数值比数组中所定义的最高位元素大 1。

方法

fromPosition(Position)	将位置转换为墨卡托点。
fromPositions(Position[])	将位置数组转换为墨量器点数组。
mercatorScale(number)	确定给定纬度的墨卡托比例因子，请参阅 https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor 在赤道处，比例因子将为 1，这在较高纬度处会增大。
meterInMercatorUnits(number)	返回在此纬度处以单位为单位 `MercatorPoint` 的 1 米的距离。对于使用米的实际单位的坐标，这自然提供了转换为 `MercatorPoint`的刻度。
toFloat32Array(Position[])	将位置数组转换为 Mercator xyz 值的 Float32Array。
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()	反转 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

以墨卡托单位为单位的点 x 位置。

y: number

以墨卡托单位表示的点 y 位置。

z: number

以墨卡托单位为单位的点 z 位置。

属性详细信息

Array

static Array: ArrayConstructor

属性值

ArrayConstructor

继承属性详细信息

length

获取或设置数组的长度。此数值比数组中所定义的最高位元素大 1。

length: number

属性值

number

继承自 Array.length

方法详细信息

fromPosition(Position)

将位置转换为墨卡托点。

static function fromPosition(position: Position): MercatorPoint

参数

position: Position

要转换的位置。

MercatorPoint

墨卡托点。

fromPositions(Position[])

将位置数组转换为墨量器点数组。

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

参数

positions: Position[]

要转换的位置数组。

MercatorPoint[]

墨卡托点的数组。

mercatorScale(number)

确定给定纬度的墨卡托比例因子，请参阅 https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor 在赤道处，比例因子将为 1，这在较高纬度处会增大。

static function mercatorScale(latitude: number): number

参数

latitude: number

纬度

number

墨卡托比例系数。

meterInMercatorUnits(number)

返回在此纬度处以单位为单位 MercatorPoint 的 1 米的距离。对于使用米的实际单位的坐标，这自然提供了转换为 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)

将墨卡器点转换为地图位置。

static function toPosition(mercator: MercatorPoint): Position

参数

mercator: MercatorPoint

墨卡托指向要转换。

Position

地图位置。

toPositions(MercatorPoint[])

将墨卡器点数组转换为地图位置数组。

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

参数

mercators: MercatorPoint[]

墨卡托指向要转换。

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

最多可以接受三个参数的函数。 filter 方法为数组中的每个元素调用一次 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

最多可以接受三个参数的函数。 filter 方法为数组中的每个元素调用一次 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[]

数组的新元素。

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 函数的第一次调用将此值作为参数提供，而不是数组值。

继承自 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 方法为数组中的每个元素调用回调fn 函数一次。

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 方法为数组中的每个元素调用回调fn 函数一次。

initialValue: U

如果指定了 initialValue，则将其用作开始累积的初始值。对 callbackfn 函数的第一次调用将此值作为参数提供，而不是数组值。

继承自 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

通过

MercatorPoint class

构造函数

属性

继承属性

方法

继承的方法

构造函数详细信息

MercatorPoint(number, number, number)

参数

属性详细信息

Array

属性值

继承属性详细信息

length

属性值

方法详细信息

fromPosition(Position)

参数

返回

fromPositions(Position[])

参数

返回

mercatorScale(number)

参数

返回

meterInMercatorUnits(number)

参数

返回

toFloat32Array(Position[])

参数

返回

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)