weex-amap

一款高德地图weex插件，当前版本支持定位，缩放，显示信息窗体等地图常用操作。

快速开始

编辑你的weex文件

<template>
  <div class="container">
      <weex-amap class="map" id="map2017" scale="true" geolocation="true" center="{{pos}}" >
        <weex-amap-marker position="{{point.position}}" title="{{point.title}}"></weex-amap-marker>
      </weex-amap>
  </div>
</template>

<style>
  .container{
    position: relative;
    flex:1; 
    background-color: #fff;
  }
  .map{
    flex: 1;
    position: relative;
    background-color: #fff;
    min-height: 600;
  }
</style>

<script>

  module.exports = {
    data: {
      pos:[116.487, 40.00003],
      point: {
        position: [112,36],
        title: 'this is a marker'
      }
    },
    
  }
</script>

API

weex-amap 属性

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | center | array | [116.487, 40.00003] | 传入地理位置坐标[x,y] 默认为当前定位位置 | | zoom | number | 11 | 缩放级别 | | zoomEnable | boolean | true | 是否允许缩放 | marker | array | [{position:[116,12]}] | 点标记物的属性 | geolocation | boolean | true | 添加定位控件 | sdkKey | object | {ios:'xxx',android: 'xxx',h5: 'xxx'} | 指定开发者的 SDK 密匙

建议你前往高德开发者社区申请你对应产品的Key，保证地图正常工作

weex-amap 事件

|事件 | 描述 | | ------------- |----------:| |zoomchange | 用户缩放改变 | |dragend | 用户拖拽完成 |

weex-amap-marker 属性

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | position | array | [116.487, 40.00003] | 传入地理位置坐标[x,y] 默认为当前定位位置 | | icon | string | some_icon_url | 图标的url地址 | | title | string | 'this is a marker' | 坐标点的名称 |

weex-amap-marker 事件

|事件 | 描述 | | ------------- |----------:| |click | 用户点击标记物 |

weex-amap-polyline 属性

在地图上绘制折线

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | path | array | [[116.487, 40.00003],[113.487, 40.0002]...]| 折线的节点坐标数组 | | stroke-color | string | #000 | 线条颜色 | | stroke-width | number | 2 | 线条宽度 | | stroke-opacity | number | 0.5 | 线条透明度[0-1] | stroke-style | string | solid | 线条的样式 实线:solid，虚线:dashed

code example：

<weex-amap-polyline path="path" stroke-color="#000" stroke-weight="2"></weex-amap-polyline>

<script>
module.exports = {
  data: {
    path: [  
      [116.368904, 39.913423],
      [116.382122, 39.901176],
      [116.387271, 39.912501],
      [116.398258, 39.904600]
    ],
  
  }
}
</script>

weex-amap-polygon 属性

在地图上绘制多边形

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | path | array | [[116.487, 40.00003],[113.487, 40.0002]...]| 多边形轮廓线的节点坐标数组 | | fill-color | string | #000 | 多边形填充颜色 | | fill-opacity | string | #000 | 多边形填充透明度 | | stroke-color | string | #000 | 线条颜色 | | stroke-width | number | 2 | 线条宽度 | | stroke-opacity | number | 0.5 | 线条透明度[0-1] | stroke-style | string | solid | 线条的样式 实线:solid，虚线:dashed

weex-amap-circle 属性

在地图上绘制圆形

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | center | array | [116.346, 40.234234]| 圆形位置 | | radius | number | 50 | 圆的半径 | | fill-color | string | #000 | 圆的填充颜色 | | fill-opacity | string | #000 | 圆的填充透明度 | | stroke-color | string | #000 | 圆的轮廓线条颜色 | | stroke-width | number | 2 | 圆的轮廓线条宽度 | | stroke-opacity | number | 0.5 | 圆的轮廓线条透明度[0-1] | stroke-style | string | solid | 圆的轮廓线条的样式 实线:solid，虚线:dashed

weex-amap-info-window 属性

在地图上显示自定义窗体

| 属性 | 类型 | Demo | 描述 | | ------------- |:-------------:| -----:|----------:| | position | array | [[116.487, 40.00003]| 在地图上的位置 | | open | boolean | true | 是否在地图上打开 | | offset | array | 偏移 | 相对定位点坐标偏移 | | children | weex comonnet | This is a info window | 窗体的内容 |

SDK限制，一个地图只允许显示一个infoWindow

amap 模块

它支持下面的方法：

getUserLocation(completeFunc,errorFunc)

获取用户的位置信息

• completeFunc 定位成功后的回调函数，返回的数据:

{ 
  data:{
    position: []
  },
  result: 'success' 
}

getLineDistance(coor1, coor2, callback)

计算两个标记点的距离

该方法接收三个参数 进行计算比如:

@param coor1 坐标1

@param coor2 坐标2

@param callback 计算完成后的回调 会返回一个计算出的具体距离，单位 米

//...
amap.getLineDistance(this.marker1.position, this.marker2.position, (res) => {
  if (res.result == 'success') {
    this.distance = '两点相距' + res.data + '米';
    console.log(res.data.distance + '米');
  } else {
    console.log('计算失败');
  }
})   

polygonContainsMarker(coor, polygonRef, callbcak)

判断几何形是否包含某个点

该方法接收两个参数，返回一个boolean值

@param coor 点的坐标

@param polygonRef 多边形的ref

@param callbcak 计算完成后的回调 会返回一个运算的结果,其中data字段是个boolean，表示是否包含

amap.polygonContainsMarker([114.23423, 43.2222], this.$ref('polygon2017'), (res) => {
  if (res.result == 'success') {
    console.log(res.data ? '存在' : '不存在' );
  }
})

如何使用amap模块

<template>
  <weex-amap class="map" id="map2017" center="{{pos}}" ></weex-amap>
  <div class="btn-wrap">
    <div onclick="setUserLocation" class="btnbox"><text class="btn" >set location </text></div>
    <text class="tips">进行当前定位</text>
  </div>
</template>

<script>
  const Amap = require('@weex-module/amap');
  module.exports = {
    data: {
      pos:[116.487, 40.00003]
    },
    
    methods: {
      setUserLocation() {
        const self = this;
        Amap.getUserLocation(this.$el('map2017').ref, function (data) {
          if(data.result == 'success') {
            self.pos = data.data.position;
          }
        });  
    }
  };
  
</script>

Demo

H5 demo

直接点击Demo可以演示当前版本支持的功能

用weexpack运行demo(Android／iOS／H5)

参考weexpack命令(网址)来测试地图组件demo:

1.安装weexpack

npm install -g weexpack

2.创建工程，如MyApp

weexpack create MyApp

3.创建运行平台

cd MyApp & weexpack platform add ios (/android)

4.添加地图插件，有两种方式

－从插件市场下载安装： weexpack plugin add weex-amap

－地图插件代码clone到本地后安装， weexpack plugin add /users/abcd/Code/weex-plugins/weex-amap (这后面是地图插件本地代码的目录)

5.编译和运行demo

把demo文件（所有在目录plugins/weex-amap/demos/下的文件）拷贝到项目工程MyApp/src下，然后：

对H5用如下命令：weexpack build web & weexpack run web

对安卓和iOS用命令：weexpack run ios (/android) 可在模拟器或者device上运行

ios demo 如下所示

集成插件

如何将地图插件集成到自己的项目呢，请参考weexpack文档说明