opencloud/.agents/skills/amap-jsapi-skill/references/api/foundation.md

基础类

经纬度、像素、边界、大小、这些是地图 JSAPI 开发必须了解的基本类型

LngLat

Parameters

• lng
• lat
• noWrap (optional, default false)

lat

纬度

Type: number

lng

经度

Type: number

setLng

设置经度值

Parameters

• lng number 经度

setLat

设置纬度值

Parameters

• lat number

getLng

获取经度值

Returns number

getLat

获取纬度值

Returns number

equals

判断经纬度坐标和另外一个经纬度坐标是否相等

Parameters

• another LngLat 另外一个经纬度坐标

Returns Boolean 是否相等

add

与另外一个经纬度相加

Parameters

• another LngLat 另外一个经纬度坐标
• noWrap boolean 是否将相加的结果经度值修正到 [-180,180] 区间内

Returns LngLat 两个经纬度相加的结果

subtract

与另外一个经纬度相减

Parameters

• another LngLat 另外一个经纬度坐标
• noWrap boolean 是否将相减的结果经度值修正到 [-180,180] 区间内

Returns LngLat 两个经纬度相减的结果

offset

获取从当前经纬度位置向东移动 E 米，向北移动 N 米的坐标位置

Parameters

• E Number 经度方向移动，向东为正
• N Number 维度方向移动，向北为正

Returns LngLat 移动后的新经纬度

toString

LngLat对象以字符串的形式返回

Returns string 格式如'lng值,lat值'的字符串

toArray

LngLat对象以字符串的形式返回

Returns string 格式如'lng值,lat值'的字符串

distance

计算当前经纬度距离另一个经纬度或者经纬度数组组成的路径的距离 [相关示例][5]

Returns number 距离值，单位为米

LngLat

经纬度坐标，用来描述地图上的一个点位置, 目前高德地图使用的是 GCJ-02 坐标，如果你采集的是 WGS84 坐标，请先进行坐标转换

Parameters

• lng number 经度值
• lat number 纬度值
• noWrap boolean 是否自动将经度值修正到 [-180,180] 区间内，缺省为false; noWrap 为false时传入[190,30]，会被自动修正为[-170,30], noWrap 为true时不会自动修正，可以用来进行跨日期限的覆盖物绘制

Examples

var lnglat = new AMap.LngLat(116, 39);

lat

纬度

Type: number

lng

经度

Type: number

setLng

设置经度值

Parameters

• lng number 经度

setLat

设置纬度值

Parameters

• lat number

getLng

获取经度值

Returns number

getLat

获取纬度值

Returns number

equals

判断经纬度坐标和另外一个经纬度坐标是否相等

Parameters

• another LngLat 另外一个经纬度坐标

Returns Boolean 是否相等

add

与另外一个经纬度相加

Parameters

• another LngLat 另外一个经纬度坐标
• noWrap boolean 是否将相加的结果经度值修正到 [-180,180] 区间内

Returns LngLat 两个经纬度相加的结果

subtract

与另外一个经纬度相减

Parameters

• another LngLat 另外一个经纬度坐标
• noWrap boolean 是否将相减的结果经度值修正到 [-180,180] 区间内

Returns LngLat 两个经纬度相减的结果

offset

获取从当前经纬度位置向东移动 E 米，向北移动 N 米的坐标位置

Parameters

• E Number 经度方向移动，向东为正
• N Number 维度方向移动，向北为正

Returns LngLat 移动后的新经纬度

toString

LngLat对象以字符串的形式返回

Returns string 格式如'lng值,lat值'的字符串

toArray

LngLat对象以字符串的形式返回

Returns string 格式如'lng值,lat值'的字符串

distance

计算当前经纬度距离另一个经纬度或者经纬度数组组成的路径的距离 [相关示例][5]

Returns number 距离值，单位为米

Bounds

地物对象的经纬度矩形范围。

Parameters

• southWest LngLat 西南角经纬度
• northEast LngLat 东北角经纬度值

getSouthWest

获取西南角坐标。

Returns LngLat

getNorthEast

获取东北角坐标

Returns LngLat

getNorthEast

获取西北角坐标

Returns LngLat

getNorthEast

获取东南角坐标

Returns LngLat

contains

指定点坐标是否在矩形范围内 [相关示例][6]

Parameters

• obj LngLat

Examples

bounds.contains(new AMap.LngLat(116,39));

Returns Boolean

getCenter

获取当前Bounds的中心点经纬度坐标。

Returns LngLat

toString

以字符串形式返回地图对象的矩形范围

Returns String

Pixel

像素坐标，确定地图上的一个像素点。

Parameters

• x number
• y number

getX

获取像素横坐标

Returns Number

getY

获取像素纵坐标

Returns Number

toString

以字符串形式返回像素坐标对象

Returns string

equals

当前像素坐标与传入像素坐标是否相等

Parameters

• point Pixel

Returns boolean

Size

地物对象的像素尺寸

Parameters

• width number 宽度
• height number 高度

getWidth

获取像素横坐标

Returns Number

getHeight

获取像素纵坐标

Returns Number

toString

以字符串形式返回尺寸大小对象

Returns string