npm 包 ol-gis-tools 使用教程-JavaScript中文网-JavaScript教程资源分享门户

什么是 ol-gis-tools

ol-gis-tools 是一个基于 OpenLayers 的 JavaScript GIS 库，以 npm 包的形式提供了一套简洁易用的工具函数，方便 WebGIS 应用的开发者处理 GIS 相关的任务，如坐标转换、图形绘制、空间分析等等。

安装和使用

安装

安装 ol-gis-tools 最简单的方式是通过 npm：

npm install ol-gis-tools

引入

在 WebGIS 应用的 JavaScript 文件中，使用 require 方法将 ol-gis-tools 引入：

var olGisTools = require('ol-gis-tools');

坐标转换

在 GIS 应用中，经常需要进行坐标转换的操作。ol-gis-tools 提供了两种常用的坐标系转换方法：WGS84 经纬度坐标系和墨卡托投影坐标系之间的转换，以及 Web Mercator 投影坐标系和墨卡托投影坐标系之间的转换。

WGS84 和墨卡托投影的转换

WGS84 这种坐标系以地球为基准，用经度和纬度来表示地球表面上的任意一点，而墨卡托投影坐标系是常见的平面直角坐标系，常用于进行地图的显示和绘制。在使用 ol-gis-tools 进行坐标转换时，首先需要使用 ol.proj.get('EPSG:4326') 获取 WGS84 坐标系对象，然后使用 ol.proj.get('EPSG:3857') 获取墨卡托投影坐标系对象。

代码示例：

let lonLat = [118.8, 32.1];
let mercator = olGisTools.wgs84ToMercator(lonLat);
console.log(mercator); // [13302697.703956918, 3920941.9264772118]

Web Mercator 和墨卡托投影的转换

Web Mercator 是一种具有等角特性的投影方式，在 Mapbox、Google Maps 等底图服务中被广泛使用。在使用 ol-gis-tools 进行 Web Mercator 和墨卡托投影之间的转换时，需要先获取 Web Mercator 投影坐标系对象 ol.proj.get('EPSG:3857')，然后就可以直接调用 olGisTools.webMercatorToMercator(webMercator) 和 olGisTools.mercatorToWebMercator(mercator) 来进行转换了。

代码示例：

let webMercator = [13302697.703956918, 3920941.9264772118];
let mercator = olGisTools.webMercatorToMercator(webMercator);
console.log(mercator); // [118.8, 32.1]

let mercator2 = [13161707.472620693, 3826553.2016305423];
let webMercator2 = olGisTools.mercatorToWebMercator(mercator2);
console.log(webMercator2); // [14698259.040714185, 4480863.482161753]

空间分析

除了坐标转换，空间分析也是 WebGIS 开发中的重要部分。ol-gis-tools 提供了一些常用的空间分析函数。

判断点是否在多边形内

使用 olGisTools.isPointInPolygon(point, polygon) 可以判断一个点是否在一个多边形内。其中 point 为要判断的点，polygon 为多边形的点集合。

代码示例：

-- -------------------- ---- -------
--- ----- - ------- ------
--- ------- - -
    ------- ------
    ------- ------
    ------- ------
    ------- -----
--
--- -------- - ---------------------------------- ---------
---------------------- -- ----

计算两点之间距离

使用 olGisTools.getDistance(point1, point2) 可以计算两个点之间的距离。其中 point1 和 point2 分别为两个点的坐标。

代码示例：

let point1 = [118.8, 32.1];
let point2 = [119.0, 32.3];
let distance = olGisTools.getDistance(point1, point2);
console.log(distance); // 23411.423175796953

图形绘制

ol-gis-tools 中也包含了一些常用的图形绘制函数。

绘制点

使用 olGisTools.drawPoint(map, point) 可以在地图上绘制一个点。其中 map 为地图对象，point 为点的坐标。

代码示例：

let point = [118.8, 32.1];
olGisTools.drawPoint(map, point);

绘制线

使用 olGisTools.drawLine(map, points) 可以在地图上绘制一条线。其中 map 为地图对象，points 为线的坐标点集合。

代码示例：

let points = [
    [118.8, 32.0],
    [119.0, 32.2],
    [118.9, 32.3]
];
olGisTools.drawLine(map, points);

绘制多边形

使用 olGisTools.drawPolygon(map, points) 可以在地图上绘制一个多边形。其中 map 为地图对象，points 为多边形的坐标点集合。

代码示例：

let points = [
    [118.7, 32.0],
    [119.0, 32.0],
    [118.9, 32.3],
    [118.7, 32.2]
];
olGisTools.drawPolygon(map, points);

结语

以上就是 ol-gis-tools 的使用教程，希望对 WebGIS 开发者能有所帮助。ol-gis-tools 提供了丰富的 GIS 相关工具函数，让 GIS 开发变得更加便捷。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/60056e9c81e8991b448e75c3