# 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);

```

## :memo: 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).