ArcGIS API for JavaScript 入门教程[1] 渊源

• ->对于萌新，你可能需要了解一下这个东西是什么
• ->对于已经知道要用这个东西的开发者，你可能需要了解一下它的底层机制
• 不针对大牛。龟速更新ing.

1. 是什么【萌新别跳这一步】

如果非萌新，可以跳过这一段文字。

想要知道ArcGIS API for JavaScript是什么，我大概用以下几条条目描述：

• 是一个WebGIS二次开发（如果不知道什么是WebGIS请用搜索引擎···）的前端开发包，使用JavaScript语言
• 出自美国Esri公司
• 是Esri的ArcGIS Runtime SDK家族中的一员
• 它不是纯Js写的库

能说明什么呢？

1. 它能制作在线地理信息系统平台，能做数据分析、空间分析、数据展示等；
2. 歪果仁写的，英文资料多，虽然中文也有一定数量的资料（博客、书籍等），但是呢，由于Esri更新贼快，一年三四更的，中文资料不一定跟得上速度；
3. 你可能需要学很多附属的东西，这个API很庞大、很笨重，入门门槛其实不高，但是深入难，前端上，你得知道造这个API的基础——Dojo框架，而Dojo框架由于历史渊源，又来自从属AMD（异步模块定义）规范的RequireJs，要想了解AMD，又不得不去看一些前端和后端的发展史，甚至不可避免要学一些基础的后端。

如果你做好了这些准备，继续。

哦对了，这个API当前有两个大支线，一个是3.x版本，一个是4.x版本；

3.x版本已经很成熟，用于2D的WebGIS二次开发很完美，如果你用的是ArcGIS整套产品；

我重点讲一下类和模块经过重新构造、较为简单的4.x版本，因为它最大的特征是数据视图分离、支持3D，旗帜鲜明对接ArcGIS Pro.

2. 学习此API需要些什么

熟练HTML 5的学习方式、熟练CSS 3的学习方式、能自我学习JavaScript，最好有一定的GIS基础知识、一定的数学知识。

我们在这里约定

ArcGIS API for JavaScript = jsapi/JsAPI/jsAPI...

你可能还要学习的是：

• NodeJs与npm（在4.7及3.24版本后可能要用npm下载）——作备选项，不学也无所谓
• webpack——上面那俩如果你学了，这个肯定要学了。
• 英语

对了，你不需要学怎么配置本地环境（就是说用官方的在线API进行学习就好了），我觉得那些东西网上太多了，查一下就行。有可能遇到跨域的问题，你也可以问搜索引擎，这里更关注的是“入门”而不是全面、细节，我需要把你快速带入门，之后看你的造化。

3. 它怎么来的

它基于一个更复杂的前端框架，Dojo.js。

除了当前两条支线3.x和4.x，其实早些年还有过ArcGIS API for Sliverlight和ArcGIS API for Flex，当然他们已经退休了。

JavaScript那么火热，自然而然选他啦。

由于GIS数据模型的复杂性，和普通的Web信息系统不同，面向对象的机制更合适去描述GIS数据和GIS分析。当时，没有别的好选择，只能选Dojo，因为它支持许多符合WebGIS的特性，如异步操作、面向对象等。

现如今，基于Node的包管理模式的前端开发早已不是什么难事，甚至还冒出了MVVM框架的一大堆火热框架。老迈的Dojo框架不能很好地融入其中，这让人很无奈。

在JsAPI中，地图可以是一个模块，图层可以是一个模块，一个用于空间分析的“东西”也可以是一个模块。类似于桌面编程中的类、继承机制，AMD规范下的RequireJs就产生了。Dojo基于此，定制了一大批的有用模块，能做图表，能做页面，能读写DOM，能做动画，当然是你需要什么模块就调用什么模块，并不需要一次性全部加载。JsAPI基于Dojo，定制了各个方面的模块，从而向开发者提供了一套强大的WebGIS二次开发包。

4. 我必须学它吗？

如果你的项目需求很大，大量用到空间分析、三维展示，频繁交互ArcGIS家族的产品（Server、ArcGIS Desktop等），请学；

如果你的项目需求比较小，也可以学，当然也可以有别的选择：

• 开源解决方案：Openlayers/Leaflets替代JsAPI。

Openlayers和Leaflets同样是WebGIS二次开发工具包，排名很靠前，二者区别是ol自己提供了封装好的功能模块，而lf则支持插件式，它的插件很多。他们都支持npm方式引入。

• 当然，为了实现简单的三维GIS，Cesium了解一下；
• 如果只是3D数据展示，ThreeJs了解一下；
• 如果数据源缺乏，不想自己做数据服务，对WebGIS标准缺少耐心，可以试试高德地图API、百度地图API等。
• 如果想全开源，就目前而言3DGIS还是ArcGIS最强外，传统二维WebGIS可以用QGIS代替ArcGIS Desktop、用PostgreSQL代替Geodatabase、用GeoServer代替ArcGIS for Server。

使用JsAPI最强大的特征就是真三维空间分析+无比强大的ArcTools工具箱了。

——————————

好了，可以开始讲了。