webMercatorUtils

方法概述

方法详细说明

canProject(source, target){Boolean}

如果 source 空间参考可以通过 project() 函数投影到 target 空间参考，或者如果 source 和 target 的 SpatialReference 相同，则返回 true。

参数

source SpatialReference|Object 输入 SpatialReference 或具有 spatialReference 属性的对象，例如 Geometry 或 Map。

target SpatialReference|Object 目标 SpatialReference 或具有 spatialReference 属性的对象，例如 Geometry 或 Map。

返回

类型	描述
Boolean	如果 source 可以投影到 target，则返回 true。

另请参阅

• project()

geographicToWebMercator(geometry){Geometry}

将几何从地理单位 (wkid: 4326) 转换为 Web Mercator 单位 (wkid: 3857)。

参数

geometry Geometry 要转换的输入几何。

返回

类型	描述
Geometry	以 Web Mercator 单位返回转换后的几何。

lngLatToXY(long, lat){Number[]}

将给定的纬度和经度 (十进制度) 值转换为 Web Mercator XY 值。

参数

long Number 要转换的经度值。

lat Number 要转换的纬度值。

返回

类型	描述
Number[]	返回数组中转换后的值。

project(geometry, spatialReference){Geometry}

投影几何客户端 (如果可能)。在使用此函数之前，您应在 canProject() 中测试输入几何。如果 canProject() 的结果是 true，则继续进行投影。如果 canProject() 返回 false，则 project() 不会返回有用的结果。请改为使用 geometryService.project()。

参数

geometry Geometry 输入的几何。

spatialReference SpatialReference|Object 目标 SpatialReference 或具有 spatialReference 属性的对象，例如 Geometry 或 Map。

返回

类型	描述
Geometry	如果投影成功，则返回投影几何。

另请参阅

• geometryService.project()
• ProjectParameters

webMercatorToGeographic(geometry, isLinear){Geometry}

将几何从 Web Mercator 单位 (wkid: 3857) 转换为地理单位 (wkid: 4326)。

参数

geometry Geometry 要转换的输入几何。

isLinear Boolean optional 默认值： false 指示是否使用线性值，即不归一化。默认情况下，此转换方法归一化 xmin 和 xmax 值。如果不需要，请将该值指定为 true。默认值为 false。

返回

类型	描述
Geometry	以地理单位返回转换后的几何。

xyToLngLat(x, y){Number[]}

将给定的 Web Mercator 坐标转换为经度和纬度值 (十进制度)。默认情况下，返回的经度将进行规范化，使其在 -180 和 +180 之间。

参数

x Number 要转换的 X 坐标值。

y Number 要转换的 Y 坐标值。

返回

类型	描述
Number[]	返回数组中转换后的值。