ooomap-geolocation/README.md

ooomap geolocation plugin

## ooomap geolocation

方便在 `ooomap SDK` 中使用浏览器提供的 `navigator.geolocation` 获得坐标的插件

> 会获得3种坐标: 相对坐标(ooomap地图坐标), 墨卡托坐标, 经纬度坐标

### 安装

```bash
npm install ooomap-geolocation --save
```

### 引入

使用模块引入

```js
import * as om from "ooomap"
import { GeoLocation } from "ooomap-geolocation"
```

也可以使用`<script>`标签引入此插件

### 创建 GeoLocation 对象

es6: 

```js
let geolocation = new GeoLocation( om )
```

script标签:

```js
let geolocation = new om.GeoLocation( om )
```

### 方法

* start
	- 开始获取位置
	
	```js
	geolocation.start()
	```

* stop
	- 终止获取位置
	
	```js
	geolocation.stop()
	```
### 字段

是否暂停

```js
geolocation.pause = true; 	// true or false
```

### 事件

在获取到位置后, 会触发 `position` 事件, 会返回3个坐标, 一个是`web墨卡拖`坐标`{x:, y: }`, 还有一个是原始的`经纬度`坐标`{lng:, lat:}`

* 相对坐标(position): {x:, y:}
	- (墨卡托坐标) - (地图中心点center) = 相对坐标
	- 用于在 ooomap 地图中设置位置坐标
* 墨卡托坐标(mercator): {x:, y:}
* 经纬度坐标(lnglat): {lng:, lat:}

```js
geolocation.on('position', (position, mercator, lnglat) => {

	console.log(position, mercator, lnglat)

})
```