arc.js 技术文档

1. 安装指南

1.1 使用 npm 安装

要安装 arc.js，请在终端中运行以下命令：

$ npm install --save arc

1.2 浏览器使用

如果你希望在浏览器中使用 arc.js，可以将 arc.js 文件引入到你的 HTML 页面中：

<script src="./arc.js"></script>

2. 项目使用说明

2.1 在 Node.js 中使用

在 Node.js 环境中，首先需要引入 arc 库：

var arc = require('arc');

2.2 在浏览器中使用

在浏览器环境中，直接使用 <script> 标签引入 arc.js 文件即可。

3. 项目 API 使用文档

3.1 创建起点和终点坐标

首先，需要声明弧线的起点和终点坐标。x 表示经度，y 表示纬度，单位为度。

var start = { x: -122, y: 48 };
var end = { x: -77, y: 39 };

3.2 创建 GreatCircle 对象

接下来，将起点和终点传递给 GreatCircle 构造函数，并可以传入一个可选的对象来表示这条线的属性。

var generator = new arc.GreatCircle(start, end, {'name': 'Seattle to DC'});

3.3 生成弧线

然后，调用 GreatCircle 对象的 Arc 方法来生成弧线：

var line = generator.Arc(100, {offset: 10});

生成的 line 将包含起点和终点坐标，以及一系列中间坐标对。

> line
{
  properties: { name: 'Seattle to DC' },
  geometries: [
    {
      coords:
       [ [ -122, 48 ],
         [ -112.06162, 47.724167 ],
         [ -102.384043, 46.608132 ],
         [ -93.227189, 44.716217 ],
         [ -84.74824, 42.144155 ],
         [ -77, 39 ] ],
      length: 6
    }
  ]
}

3.4 Arc 选项

Arc 方法的第一个参数指定生成的弧线中中间顶点的数量。数量越多，弧线越密集和准确。

第二个参数是一个可选的对象，用于声明选项。offset 选项控制弧线在跨越国际日期变更线时被分割的可能性。数值越高，越有可能被分割。默认值为 10，表示在距离国际日期变更线 10 度以内的弧线将被分割。

3.5 转换为 GeoJSON 几何对象

要将生成的弧线转换为 GeoJSON 几何对象，可以使用 json 方法：

> line.json();
{ geometry:
   { type: 'LineString',
     coordinates: [ [Object], [Object], [Object], [Object], [Object], [Object] ] },
  type: 'Feature',
  properties: { name: 'Seattle to DC' } }

3.6 转换为 WKT 格式

要将生成的弧线转换为 WKT（Well known text）格式，可以使用 wkt 方法：

> line.wkt();
'LINESTRING(-122 48,-112.061619 47.724167,-102.384043 46.608131,-93.227188 44.716217,-84.748239 42.144155,-77 38.999999)'

4. 项目安装方式

arc.js 可以通过 npm 进行安装，具体命令如下：

$ npm install --save arc

安装完成后，你可以在 Node.js 或浏览器环境中使用该库。