基础类 最后更新时间: 2023年03月30日

使用 JS API 开发之前有几个基础类型需要了解一下，包括：

1. 经纬度AMap.LngLat 
2. 像素点AMap.Pixel
3. 像素尺寸 AMap.Size
4. 经纬度矩形边界 AMap.Bounds

经纬度 AMap.LngLat

经纬度是利用三维球面空间来描述地球上一个位置的坐标系统，每个经纬度坐标由经度 lng 和纬度 lat 两个分量组成。在 JS API 里使用经纬度来表示地图的中心点center、点标记的位置position、圆的中心点center、折线和多边形的路径path等，以及其他所有表述实际位置的地方。

格式

JS API 支持的经纬度的写法有两种，使用时经度在前，纬度在后，推荐使用标准写法：

var position = new AMap.LngLat(116, 39);//标准写法
var position = [116, 39]; //简写
var map = new AMap.Center('conatiner',{
  center:position
})

对于使用到经纬度数组的时候，比如创建一个折线的路径，写法如下：

var path = [new AMap.LngLat(116,39), new AMap.LngLat(116,40), new AMap.LngLat(117,39)] //标准写法
var path = [ [116,39], [116,40], [117,39] ]; //简写
var polyline = new AMap.Polyline({
  path : path,
})
map.add(polyline);

var position = '116,39'
var position = ['116','39']
var path = [ '116,39', '117,39', '116,40']

计算

使用经纬度类型可以进行一些简单的位置计算，比如点与点、点与线的距离，根据距离差计算另一个经纬度等：

var lnglat1 = new AMap.LngLat(116, 39);
var lnglat2 = new AMap.LngLat(117, 39);
var distance = lnglat1.distance(lnglat2);//计算lnglat1到lnglat2之间的实际距离(m)
var lnglat3 = lnglat1.offset(100,50)//lnglat1向东100m，向北50m的位置的经纬度

像素点 AMap.Pixel

像素点由 x 和 y 两个分量组成，通常用来描述地图的容器坐标、地理像素坐标 (平面像素坐标)、点标记和信息窗体的的锚点等。使用方式如下：

var offset  = new AMap.Pixel(-16,-30);
var marker = new AMap.Marker({
  offset:offset,
  icon:'xxx.png',
});
map.add(marker);

像素尺寸 AMap.Size

像素尺寸由width和height两个分量构成，通常用来描述具有一定大小的对象，比如地图的尺寸，图标的尺寸等

var mapSize = map.getSize();//获取地图大小，返回的是地图容器的像素大小
var width = mapSize.width;
var height = mapSize.height;
var marker = new AMap.Marker({
  position: [116.405467, 39.907761],
  icon: new AMap.Icon({            
    size: new AMap.Size(40, 50),  //图标的大小
    image: "https://webapi.amap.com/theme/v1.3/images/newpc/way_btn2.png",
    imageOffset: new AMap.Pixel(0, -60)
  })        
});
map.add(marker)

经纬度矩形边界 AMap.Bounds

经纬度矩形边界为一个矩形的经纬度范围，用西南角和东北角的两个经纬度来描述，这两个经纬度分别代表边界的最小值和最大值。矩形经纬度边界通常用来描述：地图的当前边界、覆盖物的外包矩形边界、图片图层的覆盖范围等。比如构造一个新的Bounds对象来调成地图的边界范围：

var southWest = new AMap.LngLat(110,20);
var northEast = new AMap.LngLat(120,30);
var bounds = new AMap.Bounds(southWest, northEast);
map.setBounds(bounds);