com.supermap.data

类 CoordSysTranslator

java.lang.Object

com.supermap.data.CoordSysTranslator

public final class CoordSysTranslator
extends java.lang.Object

投影转换类。

主要用于投影坐标之间及投影坐标系之间的转换。

投影转换一般有三种工作方式：地理（经纬度）坐标和投影坐标之间的转换使用 forward() 方法、投影坐标和地理（经纬度）坐标之间的转换使用inverse() 方法 、两种投影坐标系之间的转换使用convert() 方法。

注意：当前版本不支持光栅数据的投影转换。即在同一数据源中，投影转换只转换矢量数据部分。地理坐标系（Geographic Coordinate System）也称为地理坐标系统，是以经纬度为地图的存储单位的。很明显，地理坐标系是球面坐标系统。如果将地球上的数字化信息存放到球面坐标系统上，就需要有这样的椭球体具有如下特点：可以量化计算的，具有长半轴（Semimajor Axis），短半轴（Semiminor Axis），偏心率（Flattening），中央子午线（prime meridian）及大地基准面（datum）。投影坐标系统（Projection coordinate system）实质上便是平面坐标系统，其地图单位通常为米。将球面坐标转化为平面坐标的过程便称为投影。所以每一个投影坐标系统都必定会有地理坐标系统（Geographic Coordinate System）参数。 因此就存在着投影坐标之间的转换以及投影坐标系之间的转换。

方法概要

限定符和类型	方法和说明
static boolean	convert(Geometry geometry, PrjCoordSys sourcePrjCoordSys, PrjCoordSys targetPrjCoordSys, CoordSysTransParameter coordSysTransParameter, CoordSysTransMethod coordSysTransMethod) 根据源投影坐标系与目标投影坐标系对几何对象进行投影转换，结果将直接改变源几何对象。
static boolean	convert(Point2Ds points, PrjCoordSys sourcePrjCoordSys, PrjCoordSys targetPrjCoordSys, CoordSysTransParameter coordSysTransParameter, CoordSysTransMethod coordSysTransMethod) 根据源投影坐标系与目标投影坐标系对坐标点串进行投影转换，结果将直接改变源坐标点串。
static boolean	convert(Point3Ds points, PrjCoordSys srcPrjCoordSys, PrjCoordSys desPrjCoordSys, CoordSysTransParameter coordSysTransParameter, CoordSysTransMethod coordSysTransMethod) 根据源投影坐标系与目标投影坐标系对三维点集合对象进行投影转换，结果将直接改变源坐标点串。
static boolean	forward(Point2Ds points, PrjCoordSys prjCoordSys) 在同一地理坐标系下，该方法用于将指定的Point2Ds 类的点对象的地理坐标转换到投影坐标。
static boolean	inverse(Point2Ds points, PrjCoordSys prjCoordSys) 在同一投影坐标系下，该方法用于将指定的Point2Ds 类的点对象的投影坐标转换到地理坐标。

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

forward

public static boolean forward(Point2Ds points,
                              PrjCoordSys prjCoordSys)

在同一地理坐标系下，该方法用于将指定的Point2Ds 类的点对象的地理坐标转换到投影坐标。

参数:

points - 指定的被转换的Point2Ds 类的对象。

prjCoordSys - 对象所在的投影坐标系。

返回:

如果转换成功返回 true，否则返回 false。

inverse

public static boolean inverse(Point2Ds points,
                              PrjCoordSys prjCoordSys)

在同一投影坐标系下，该方法用于将指定的Point2Ds 类的点对象的投影坐标转换到地理坐标。

参数:

points - 被转换的Point2Ds 对象。

prjCoordSys - 指定的对象所在的投影坐标系。

返回:

如果坐标转换成功，返回 true，否则返回 false。

convert

public static boolean convert(Point2Ds points,
                              PrjCoordSys sourcePrjCoordSys,
                              PrjCoordSys targetPrjCoordSys,
                              CoordSysTransParameter coordSysTransParameter,
                              CoordSysTransMethod coordSysTransMethod)

根据源投影坐标系与目标投影坐标系对坐标点串进行投影转换，结果将直接改变源坐标点串。

参数:

points - 被转换的 Points2Ds 类的点串。

sourcePrjCoordSys - 源投影坐标系。

targetPrjCoordSys - 目标投影坐标系。

coordSysTransParameter - 投影坐标系转换参数。包括坐标的平移量、旋转角度、投影比例尺差，详情请参见 CoordSysTransParameter 类。

coordSysTransMethod - 投影转换所使用的方法。详情请参见 CoordSysTransMethod。

返回:

如果转换成功返回 true，否则返回 false。

convert

public static boolean convert(Point3Ds points,
                              PrjCoordSys srcPrjCoordSys,
                              PrjCoordSys desPrjCoordSys,
                              CoordSysTransParameter coordSysTransParameter,
                              CoordSysTransMethod coordSysTransMethod)

根据源投影坐标系与目标投影坐标系对三维点集合对象进行投影转换，结果将直接改变源坐标点串。

参数:

points - 待转换的三维点集合对象

srcPrjCoordSys - 源投影坐标系

desPrjCoordSys - 目标投影坐标系

coordSysTransParameter - 投影坐标系转换参数。包括坐标的平移量、旋转角度、投影比例尺差，详情请参见 CoordSysTransParameter 类。

coordSysTransMethod - 投影转换所使用的方法。详情请参见 CoordSysTransMethod。

返回:

如果转换成功返回 true，否则返回 false。

convert

public static boolean convert(Geometry geometry,
                              PrjCoordSys sourcePrjCoordSys,
                              PrjCoordSys targetPrjCoordSys,
                              CoordSysTransParameter coordSysTransParameter,
                              CoordSysTransMethod coordSysTransMethod)

根据源投影坐标系与目标投影坐标系对几何对象进行投影转换，结果将直接改变源几何对象。

参数:

geometry - 被转换的几何对象。

sourcePrjCoordSys - 源投影坐标系。

targetPrjCoordSys - 目标投影坐标系。

coordSysTransParameter - 投影坐标系转换参数。包括坐标的平移量、旋转角度、投影比例尺差，详情请参见 CoordSysTransParameter 类。

coordSysTransMethod - 投影转换所使用的方法。详情请参见 CoordSysTransMethod。

返回:

如果转换成功返回 true，否则返回 false。