SuperMap.LonLat

这个类用来表示经度和纬度对。

Summary
SuperMap.LonLat 这个类用来表示经度和纬度对。
Properties
lat {Float} 地图的单位的Y轴(纵轴)坐标,默认为0.0。
lon {Float} 地图的单位的X轴(横轴)坐标,默认为0.0。
Constructor
SuperMap.LonLat 创建一个新的地图位置对象。如:
Functions
add 在已有坐标对象的经纬度基础上加上新的坐标经纬度,并返回新的坐标对象。
clone 复制坐标对象,并返回复制后的新对象。
destroy 销毁此对象。 销毁后此对象的所有属性为null,而不是初始值。
equals 判断两个坐标对象是否相等。
fromArray 通过数组生成一个<SuperMap.LonLat>对象
fromString 通过字符串生成一个<SuperMap.LonLat>对象
toShortString 将经度纬度转换成简单字符串。
toString 返回此对象的字符串形式
transform 经纬度对象的投影转换。 (在自身上做投影转换)
wrapDateLine 通过传入的范围对象对坐标对象转换到该范围内。 如果经度小于给定范围最小精度,则在原经度基础上加上范围宽度, 直到精度在范围内为止,如果经度大于给定范围则在原经度基础上减去范围宽度。 换句话说就是将不在经度范围内的坐标转换到范围以内。 (只会转换lon,不会转换lat,主要用于转移到日界线以内)

Properties

lon

{Float} 地图的单位的X轴(横轴)坐标,默认为0.0。

lat

{Float} 地图的单位的Y轴(纵轴)坐标,默认为0.0。

Constructor

SuperMap.LonLat

创建一个新的地图位置对象。如:

var lonLat = new SuperMap.LonLat(30,45);

Parameters (two arguments)

lon {Number} 地图单位上的X轴坐标,如果地图是地理投影,则此值是经度,否则,此值是地图地理位置的x坐标。
lat {Number} 地图单位上的Y轴坐标,如果地图是地理投影,则此值是纬度,否则,此值是地图地理位置的y坐标。

Parameters (single argument)

location {Array(Float)} [lon, lat] 横纵坐标组成的数组。

Functions

toString

toString:function()

返回此对象的字符串形式

例如

var lonLat = new SuperMap.LonLat(100,50);
var str = lonLat.toString();

Returns

{String} 例如: “lon=100,lat=50”

toShortString

toShortString:function()

将经度纬度转换成简单字符串。

例如

var lonLat = new SuperMap.LonLat(100,50);
var str = lonLat.toShortString();

Returns

{String} 返回处理后的经纬度字符串。例如:”100,50”

clone

clone:function()

复制坐标对象,并返回复制后的新对象。

例如

var lonLat1 = new SuperMap.LonLat(100,50);
var lonLat2 = lonLat1.clone();

Returns

{SuperMap.LonLat} 返回相同坐标值的新的坐标对象。

add

add:function( lon,
lat )

在已有坐标对象的经纬度基础上加上新的坐标经纬度,并返回新的坐标对象。

例如

var lonLat1 = new SuperMap.LonLat(100,50);
//lonLat2 是新的对象
var lonLat2 = lonLat1.add(100,50);

Parameters

lon {Float} 传入的精度参数。
lat {Float} 传入的纬度参数。

Returns

{SuperMap.LonLat} 返回一个新的LonLat对象,此对象的经纬度是由传 入的经纬度与当前的经纬度相加所得。

equals

equals:function( ll )

判断两个坐标对象是否相等。

例如

var lonLat1 = new SuperMap.LonLat(100,50);
var lonLat2 = new SuperMap.LonLat(100,50);
var isEquals = lonLat1.equals(lonLat2);

Parameters

ll {SuperMap.LonLat} 需要进行比较的坐标对象。

Returns

{Boolean} 如果LonLat对象的经纬度和传入的经纬度一致则返回true,不一 致或传入的ll参数为NULL则返回false。

transform

transform: function( source,
dest )

经纬度对象的投影转换。 (在自身上做投影转换)

例如

var lonLat1 = new SuperMap.LonLat(100,50);
//这里 lonLat1 = lonLat2
var lonLat2 = lonLat1.transform(
     new SuperMap.Projection("EPSG:4326"),
     new SuperMap.Projection("EPSG:3857")
 );

Parameters

source {SuperMap.Projection} 源投影
dest {SuperMap.Projection} 目标投影

Returns

{SuperMap.LonLat} 返回转换后的LonLat(坐标对象)。

wrapDateLine

wrapDateLine: function( maxExtent )

通过传入的范围对象对坐标对象转换到该范围内。 如果经度小于给定范围最小精度,则在原经度基础上加上范围宽度, 直到精度在范围内为止,如果经度大于给定范围则在原经度基础上减去范围宽度。 换句话说就是将不在经度范围内的坐标转换到范围以内。 (只会转换lon,不会转换lat,主要用于转移到日界线以内)

例如

var lonLat1 = new SuperMap.LonLat(420,50);
var lonLat2 = lonLat1.wrapDateLine(
     new SuperMap.Bounds(-180,-90,180,90)
 );

Parameters

maxExtent {SuperMap.Bounds} 最大边界的范围。

Returns

{SuperMap.LonLat} 将坐标转换到范围对象以内,并返回新的坐标。

destroy

destroy: function()

销毁此对象。 销毁后此对象的所有属性为null,而不是初始值。

例如

var lonLat = new SuperMap.LonLat(100,50);
lonLat.destroy();

fromString

SuperMap.LonLat.fromString = function( str )

通过字符串生成一个<SuperMap.LonLat>对象

例如

var str = "100,50";
var lonLat = SuperMap.LonLat.fromString(str);

Parameters

str {String} 字符串的格式:Lon+”,”+Lat。如:”100,50”

Returns

{SuperMap.LonLat} 返回一个 SuperMap.LonLat 对象

fromArray

SuperMap.LonLat.fromArray = function( arr )

通过数组生成一个<SuperMap.LonLat>对象

Parameters

arr {Array(Float)} 数组的格式,长度只能为2,:[Lon,Lat]。如: [5,-42]

Returns

{SuperMap.LonLat} 返回一个 SuperMap.LonLat 对象

toString:function()
返回此对象的字符串形式
toShortString:function()
将经度纬度转换成简单字符串。
clone:function()
复制坐标对象,并返回复制后的新对象。
add:function( lon,
lat )
在已有坐标对象的经纬度基础上加上新的坐标经纬度,并返回新的坐标对象。
equals:function( ll )
判断两个坐标对象是否相等。
transform: function( source,
dest )
经纬度对象的投影转换。 (在自身上做投影转换)
wrapDateLine: function( maxExtent )
通过传入的范围对象对坐标对象转换到该范围内。 如果经度小于给定范围最小精度,则在原经度基础上加上范围宽度, 直到精度在范围内为止,如果经度大于给定范围则在原经度基础上减去范围宽度。 换句话说就是将不在经度范围内的坐标转换到范围以内。 (只会转换lon,不会转换lat,主要用于转移到日界线以内)
destroy: function()
销毁此对象。 销毁后此对象的所有属性为null,而不是初始值。
SuperMap.LonLat.fromString = function( str )
通过字符串生成一个<SuperMap.LonLat>对象
SuperMap.LonLat.fromArray = function( arr )
通过数组生成一个<SuperMap.LonLat>对象
创建一个新的地图位置对象。如:
坐标转换类。这个类封装了与 proj4js 投影对象进行交互的几种方法。
表示边界类实例。使用bounds之前需要设置left,bottom, right, top四个属性,这些属性的初始值为null。
Close