SpatialReference

// 使用 wkid 将视图的空间参考设置为 WebMercator
const view = new SceneView({
  container: "viewDiv",
  map: map,
  spatialReference: {
    wkid: 3857
  }
});

// 使用 WGS84 属性将几何的空间参考设置为 WGS84
const point = new Point({
  x: 10.1,
  y: 47.4,
  spatialReference: SpatialReference.WGS84
});

属性列表

属性详细说明

declaredClass Stringreadonly inherited

起始版本: GeoScene API for JavaScript 4.22

类名。类的名称声明格式为 geoscene.folder.className。

imageCoordinateSystem Object

起始版本： GeoScene API for JavaScript 4.22

影像坐标系定义了用于以原始坐标显示影像的空间参考，而不会发生失真、地图变换或正射校正。通常，ImageryLayer 显示在视图的 spatialReference 中。在某些情况下，将图像转换为地图坐标可能会导致图像看起来倾斜或扭曲，因为使用了各种变换和地形校正。由于影像坐标系中影像不会失真，因此非常适合与倾斜影像和测量一起使用。

图像只能在 2D MapView 中显示在其原始坐标中，并带有 top-up 旋转，该旋转始终面向数据集的方向。 这类似于车载导航系统的工作原理，其中选项通常位于屏幕顶部的北方（因此，不使用填充选项）或屏幕旋转，因此行驶方向始终显示在顶部。

另参阅：

• 示例 - ImageryLayer 图像坐标系

• ImageryLayer.getCatalogItemICSInfo()

示例代码：

// 获取指定目录项的图像坐标系，例如 Raster.OBJECTID = 1600
layer.getCatalogItemICSInfo(imageId).then(function(info) {
// 创建一个 spatialReference 对象并设置其 imageCoordinateSystem 属性。
 let sr = { // autocasts to esri/geometry/SpatialReference
   imageCoordinateSystem: { id: imageId }
 };

 // 根据图像在其原始坐标系中的范围计算地图视图的范围
 const width = document.getElementById("viewDiv").getBoundingClientRect().width;
 const height = document.getElementById("viewDiv").getBoundingClientRect().height;
 const newExt = info.icsExtent.clone();
 const scaleFactor = 5;
 newExt.xmin = (newExt.xmin + newExt.xmax - width * scaleFactor) / 2;
 newExt.xmax = newExt.xmin + width * scaleFactor;
 newExt.ymin = (newExt.ymin + newExt.ymax - height * scaleFactor) / 2;
 newExt.ymax = newExt.ymin + height * scaleFactor;
 newExt.spatialReference = sr;

 // 将 MapView 的 spatialReference 设置为图像的坐标系
 // 并将范围设置为上面计算的范围
 view = new MapView({
   container: "viewDiv",
   map: map,
   spatialReference: sr,
   extent: newExt
 });
});

isGeographic Booleanreadonly

指示空间参考是否引用地理坐标系。

isWebMercator Booleanreadonly

空间参考对象的 wkid 是否为下列值之一：102113、 102100、3857 。

isWGS84 Booleanreadonly

指示空间参考对象的 wkid 是否为  4326。

isWrappable Booleanreadonly

指示地图的空间参考是否支持环绕国际日期变更线。如果空间参考为 Web 墨卡托或 WGS84，则值为true。

WebMercator SpatialReferencestatic

Web 墨卡托的便捷空间参考实例。

示例代码：

// 如果 webMercatorUtils 可以将几何从 WGS84 投影到 Web Mercator，则返回 true
let canProjectWGS84toWebMercator = webMercatorUtils.canProject(SpatialReference.WGS84, SpatialReference.WebMercator);

WGS84 SpatialReferencestatic

WGS84 的便捷空间参考实例。

示例代码：

// 如果 webMercatorUtils 可以将几何从 WGS84 投影到 Web Mercator，则返回 true
let canProjectWGS84toWebMercator = webMercatorUtils.canProject(SpatialReference.WGS84, SpatialReference.WebMercator);

wkid Number

空间参考的已知 ID。有关支持的空间参考列表，请参阅使用空间参考。

wkt String

定义空间参考的已知文本。

方法列表

方法详细说明

clone(){SpatialReference}

返回空间参考对象的深度克隆。

返回值：

类型	描述
SpatialReference	返回空间参考对象的深度克隆。

equals(spatialReference){Boolean}

检查指定的空间参考对象是否与此空间参考对象具有相同的 wkid 或 wkt。

参数：

spatialReference SpatialReference 与之比较的空间参考。

返回值：

类型	描述
Boolean	如果输入空间参考对象与此空间参考对象具有相同的 wkid 或 wkt，则返回 true 。

示例代码：

require(["geoscene/geometry/SpatialReference"], function(SpatialReference) {
  const sr1 = new SpatialReference({ wkid: 4326 });
  const sr2 = new SpatialReference({ wkid: 4326 });
  console.log(sr1.equals(sr2)); // true
});

fromJSON(json){*}static

创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象的值对其进行初始化。传递给输入 json 参数的对象通常来自对 REST API 中的查询操作的响应，或者来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用此函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。

参数：

json Object GeoScene 格式的实例的 JSON 表示形式。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。

返回值：

类型	描述
*	返回一个该类的新实例。

toJSON(){Object}

将此类的实例转换为其 GeoScene portal JSON 表示形式。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回值：

类型	描述
Object	实例的 GeoScene portal JSON 表示形式。