antv-l7/README.md

# L7

[![travis ci](https://travis-ci.com/antvis/L7.svg?branch=master)](https://travis-ci.com/antvis/L7) [![](https://flat.badgen.net/npm/v/@antv/l7?icon=npm)](https://www.npmjs.com/package/@antv/l7) ![最近提交](https://badgen.net/github/last-commit/antvis/L7)

Large-scale WebGL-powered Geospatial data visualization analysis framework.

[中文 README](./README.zh-CN.md)

Powered by WebGL, the rendering technology of L7 supports fast and efficient rendering of big data, 2D/3D rendering, possible through calculation and analysis of spatial data by GPU Parallel Compu-ting.

L7 focuses on  geographic data expressiveness，interaction and design of geographic visualization layers. The basemaps on the platform are powered by third-party services 


## l7 visualization demos

![l7 demo](https://gw.alipayobjects.com/mdn/antv_site/afts/img/A*SGU-QIZsnyoAAAAAAAAAAABkARQnAQ)


## ✨ Highlight features of L7 2.0


🌏	Data-driven Visualization
 
Layer visualization API design base Semiology of Graphics.

it supports rich map visualization types for a better insight on data.


🌏High performance rendering with 2D/3D effect
	
  Real-time and dynamic rendering with millions of spatial data.


🌏	Simple and flexible data format:

 L7 supports a wide variety of data formats including CSV, JSON, geojson, among others, eliminating the need to run conversions ahead of time.


🌏Multi-basemap: 

For global users, Mapbox is easy to be embedded by a simple line of code.



## Getting Started



.

 ###  📦 Installation

```
npm install @antv/l7@beta
```

### init Map by L7  scene

```javascript
import { Scene } from '@antv/l7';
import { Mapbox } from '@antv/l7-maps';
new Scene({
  id: 'map',
  map: new Mapbox({
    style: 'light',
    pitch: 0,
    center: [ 107.054293, 35.246265 ],
    zoom: 4.056
  })
})

```
### add Layer 

``` javascript

import { PointLayer } from '@antv/l7';
  const pointLayer = new PointLayer()
      .source(data)
      .shape('circle')
      .size('mag', [ 1, 25 ])
      .color('mag',['#5B8FF9', '#5CCEA1'])
      .style({
        opacity: 0.3,
        strokeWidth: 1
      });

scene.addLayer(pointLayer);

```

## Documentation

[Getting started with L7](https://l7.antv.vision/en/docs/api/l7)

[Tutorials](https://l7.antv.vision/en/docs/tutorial/quickstart)

[API documentation](https://l7.antv.vision/en/docs/api/l7)

[Examples](https://l7.antv.vision/en/examples/gallery/basic)


##  🔨 Development

使用 Yarn Workspace 完成依赖安装以及各包之间的 link 工作：
```bash
yarn install
```

开发模式：
```bash
yarn watch
```

运行 Demo，基于 Storybook：
```bash
yarn storybook
```

## view doc example

```bash
yarn start
```
visit http://localhost:8000/


## ✅ License

[MIT license](./LICENSE).