react-amap-next

    1.2.3 • Public • Published

    项目目标

    此项目是对高德地图的react封装,相比较于react-amap,集成更原生化,更简单. 用最react的方式使用高德地图AMap.

    使用方法

    // 首先安装react-amap-next
    yarn add react-amap-next
    // 加载所需组件
    import { loadMap } from 'react-amap-next/lib/api'; //加载高德地图方法,如果与redux配合,可以写在action/reducer中
    import Map from 'react-amap-next/lib/Map';
    import Marker from 'react-amap-next/lib/Marker';
    
    // 在componentDidMount中加载js
    componentDidMount() {
      loadMap('<amap-key>').then(AMap=>{
        // 可在此做一些初始化
        this.setState({AMap});
      })
    }
    // 在render中使用Map,注意其中参数refer类似react中ref,只支持函数,可以获得amap实例;options是参数,更新的参数也通过此处传下去,events是地图事件的回调,设置后将会被调用,可以触发属性的改变.
    // 一般地图组件都包含AMap, refer, options, events4个属性.
    // 注意, options和events中的函数和变量最好都为外面声明的,而不使用匿名的函数.否则容易触发事件的频繁移除及更新,耗费性能.
    render() {
      return (
      <Map refer={} AMap={this.state.AMap} style={{width:1200, height:800}} options={{}} events={{}} >
        <Marker
          refer={(entity) => this.setState({carEntity: entity})}
          options={{
            position: [116.397428, 39.90923],
            icon: "https://webapi.amap.com/images/car.png",
            offset: this.state.carOffset,
            autoRotation: true
          }}
          events={{
            moving:this._carMoving
          }}
        />
      </Map>
      )
    }
    

    测试用例

    例子请参考src/App.js,

    git clone https://github.com/windsome/react-amap-next
    yarn install # npm install
    npm start
    

    方案介绍

    1. api.js为amap相关的操作,主要包含高德js的加载及各种组件的创建及更新方法.
    2. webservice.js为地图webservice服务,与UI无关的操作均使用webservice进行
    3. Map.js为根节点地图组件,其他所有子UI组件都必须作为其一级子元素.遵循react生命周期函数,主要使用componentDidMount, componentDidUpdate进行创建和更新的处理.
    4. Marker.js为标记点组件
    5. MassMarks为海量点组件,此组件是一个layer图层,因为比traffic, sattelite复杂,需要设置很多属性,所以独立成一个组件.其他图层也可以参考设置成独立组件
    6. Polygon.js为多边形控件,可以用来画行政区域图
    7. Polyline.js为多折点线组件,可以用来模拟汽车行驶轨迹
    8. InfoWindow.js为InfoWindow组件,可以用来显示弹出框
    9. LayerTraffic.js为LayerTraffic组件,可以用来显示交通层
    10. 其他组件,有待添加.

    注意事项

    1. loadScript.js是用来加载js和css的,希望能确保加载文件的唯一性,可以参考requirejs的实现机制改掉.注意:这里已经用react-amap的加载方式替换了.
    2. react-amap的不同之处,加载高德地图js与Map,Marker等组件是分离的.

    已知问题

    1. 有时海量点图层(MassMarks层)不显示,见此版本例子中的App.js,首先点击MarkerTest,然后再打开MassMarksTest,会发现海量点图层有时不显示.原因为:MassMarks层是属于Map的其中一个层,如果Map的layers属性后于海量点图层加载,则海量点图层会被layers属性替代. 建议以后将所有图层均做成组件,并且Map组件不再支持layers属性.

    反馈

    We are always open to your feedback.

    更新计划

    团队协作

    Install

    npm i react-amap-next

    DownloadsWeekly Downloads

    0

    Version

    1.2.3

    License

    none

    Unpacked Size

    665 kB

    Total Files

    38

    Last publish

    Collaborators

    • windsome