小程序地图组件map

官方文档：https://developers.weixin.qq.com/miniprogram/dev/component/map.html

小程序地图提供的API：

媒体-地图：

• MapContext wx.createMapContext(string mapId, Object this)：创建map上下文MapContext对象。

参数：
    string mapId：map组件的id
    Object this：在自定义组件下，当前组件实例的this，以操作组件内 map组件

• MapContext.getCenterLocation(Object object)：获取当前地图中心的经纬度。返回的是 gcj02 坐标系，可以用于 wx.openLocation()

Object object参数：
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.getRegion(Object object)：获取当前地图的视野范围

Object object参数：
    success[function]：接口调用成功的回调函数
        southwest[number]：西南角经纬度
        northeast[number]：东北角经纬度
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.getRotate(Object object)：获取当前地图的旋转角

Object object参数：
    success[function]：接口调用成功的回调函数
        rotate[number]：旋转角
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.getScale(Object object)：获取当前地图的缩放级别

Object object参数：
    success[function]：接口调用成功的回调函数
        scale[number]：缩放值
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.getSkew(Object object)：获取当前地图的倾斜角

Object object参数：
    success[function]：接口调用成功的回调函数
        skew[number]：倾斜角
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.includePoints(Object object)：缩放视野展示所有经纬度

Object object参数：
    points[Array.<Object>]：要显示在可视区域内的坐标点列表
    padding[Array.<number>]：坐标点形成的矩形边缘到地图边缘的距离，单位像素。格式为[上,右,下,左]，安卓上只能识别数组第一项，上下左右的padding一致。开发者工具暂不支持padding参数。
    success[function]：接口调用成功的回调函数
        longitude[number]：经度
        latitude[number]：纬度
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.moveToLocation(Object object)：将地图中心移置当前定位点，此时需设置地图组件 show-location 为true。2.8.0起支持将地图中心移动到指定位置。

Object object参数：
    longitude[number]：经度
    latitude[number]：纬度
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• MapContext.translateMarker(Object object)：平移marker，带动画

Object object参数：
    markerId[number]：指定 marker
    destination[Object]：指定 marker 移动到的目标点
    autoRotate[boolean]：移动过程中是否自动旋转 marker
    rotate[number]：marker 的旋转角度
    duration[number]：动画持续时长，平移与旋转分别计算
    animationEnd[function]：动画结束回调函数
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

位置

• wx.stopLocationUpdate()：关闭监听实时位置变化，前后台都停止消息接收

Object object参数：
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• wx.startLocationUpdateBackground(Object object)：开启小程序进入前后台时均接收位置消息，需引导用户开启授权。授权以后，小程序在运行中或进入后台均可接受位置消息变化。

--调用前需要 用户授权scope.userLocationBackground
Object object参数：
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• wx.startLocationUpdate(Object object)：开启小程序进入前台时接收位置消息
  --调用前需要 用户授权scope.userLocation

Object object参数：
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• wx.openLocation(Object object)：使用微信内置地图查看位置

Object object参数：
    latitude[number]：纬度，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系
    longitude[number]：经度，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系
    scale[number]：默认值18，缩放比例，范围5~18
    name[string]：位置名
    address[string]：地址的详细说明
    success[function]：接口调用成功的回调函数
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• wx.onLocationChange(function callback)：监听实时地理位置变化事件，需结合 wx.startLocationUpdateBackground、wx.startLocationUpdate使用。

Object res参数：
    latitude[number]：纬度，范围为 -90~90，负数表示南纬
    longitude[number]：经度，范围为 -180~180，负数表示西经
    speed[number]：速度，单位 m/s
    accuracy[number]：位置的精确度
    altitude[number]：高度，单位 m
    verticalAccuracy[number]：垂直精度，单位 m（Android 无法获取，返回 0）
    horizontalAccuracy[number]：水平精度，单位 m

• wx.offLocationChange(Object object)：取消监听实时地理位置变化事件

Object object参数：
    function callback：实时地理位置变化事件的回调函数

• wx.getLocation(Object object)：获取当前的地理位置、速度。当用户离开小程序后，此接口无法调用。开启高精度定位，接口耗时会增加，可指定 highAccuracyExpireTime 作为超时时间

--调用前需要 用户授权scope.userLocation
Object object参数：
    type[string]：默认值wgs84，wgs84 返回 gps 坐标，gcj02 返回可用于 wx.openLocation 的坐标
    altitude[string]：默认值false，传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度
    isHighAccuracy[boolean]：默认值false，开启高精度定位
    highAccuracyExpireTime[number]：高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果
    success[function]：接口调用成功的回调函数
        latitude[number]：纬度，范围为 -90~90，负数表示南纬
        longitude[number]：经度，范围为 -180~180，负数表示西经
        speed[number]：速度，单位 m/s
        accuracy[number]：位置的精确度
        altitude[number]：高度，单位 m
        verticalAccuracy[number]：垂直精度，单位 m（Android 无法获取，返回 0）
        horizontalAccuracy[number]：水平精度，单位 m
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行)

• wx.chooseLocation(Object object)：打开地图选择位置

Object object参数：
    latitude[number]：目标地纬度
    longitude[number]：目标地经度
    success[function]：接口调用成功的回调函数
        name[string]：位置名称
        address[string]：详细地址
        latitude[string]：纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系
        longitude[string]：经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系
    fail[function]：接口调用失败的回调函数
    complete[function]：接口调用结束的回调函数（调用成功、失败都会执行）