Cesium API - WebMercatorProjection 中文文档

本文介绍下Cesium中 WebMercatorProjection API的详细使用说明。

WebMercatorProjection API 调用方法

new Cesium.WebMercatorProjection(ellipsoid)

谷歌地图、微软必应地图和大多数ESRI ArcGIS在线地图使用的地图投影，EPSG:3857。该投影使用WGS84表示的经度和纬度，并使用球面（而不是椭球）方程将它们转换为Mercator。

Name	Type	Default	Description
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 椭球。

参考：

GeographicProjection

成员变量

staticCesium.WebMercatorProjection.MaximumLatitude : Number

Core/WebMercatorProjection.js 119

由Web Mercator (EPSG:3857)投影支持的最大纬度(包括北纬和南纬)。从技术上讲，墨卡托投影的定义范围是90度以内(但不包括90度)的任何纬度，但应该更早地将其截断，因为它是随纬度的增加呈指数增长的。 Google Maps，Bing Maps和Esri使用此特定临界值背后的逻辑是，它使投影成为正方形。也就是说，矩形在X和Y方向上是相等的。常数值通过调用WebMercatorProjection.mercatorAngleToGeodeticLatitude(Math.PI)计算。

readonlyellipsoid : Ellipsoid

Core/WebMercatorProjection.js 48

获取 Ellipsoid.

内置方法

staticCesium.WebMercatorProjection.geodeticLatitudeToMercatorAngle(latitude) → Number

Core/WebMercatorProjection.js 85

将-PI/2到PI/2范围内的以弧度表示的大地纬度转换为-PI到PI范围内的墨卡托角度。

Name	Type	Description
`latitude`	Number	以弧度表示的大地纬度。

返回值：

墨卡托角度。

staticCesium.WebMercatorProjection.mercatorAngleToGeodeticLatitude(mercatorAngle) → Number

Core/WebMercatorProjection.js 68

将-PI到PI范围内的墨卡托角转换为-PI/2到PI/2范围内的大地纬度。

Name	Type	Description
`mercatorAngle`	Number	要转换的角度。

返回值：

以弧度表示的大地纬度。

project(cartographic, result) → Cartesian3

Core/WebMercatorProjection.js 139

将以弧度表示的大地椭球坐标转换为以米表示并以Cartesian3返回的等效Web Mercator X、Y、Z坐标。高度被原样复制到Z坐标。

Name	Type	Description
`cartographic`	Cartographic	以弧度表示的地图坐标。
`result`	Cartesian3	optional 要将结果复制到的实例，如果要创建新实例，则为未定义的实例。

返回值：

等效的web mercator X, Y, Z坐标，单位是米。

unproject(cartesian, result) → Cartographic

Core/WebMercatorProjection.js 172

Converts Web Mercator X, Y coordinates, expressed in meters, to a Cartographic containing geodetic ellipsoid coordinates. The Z coordinate is copied unmodified to the height.

Name	Type	Description
`cartesian`	Cartesian3	The web mercator Cartesian position to unrproject with height (z) in meters.
`result`	Cartographic	optional The instance to which to copy the result, or undefined if a new instance should be created.