ArcGIS API for JavaScript开发初探—

1、前言

在开始ArcGIS API for JavaScript开发之前我们需要了解一些基本的知识：

1、开发工具选什么？

前端技术的开发工具选择是一个仁者见仁智者见智的问题，有人喜欢Hbuilder，有人喜欢Sublime Text，notepad++，也有人喜欢直接在写字板写代码。还有很多功能更全面的集成开发环境，全凭个人喜好，这里笔者推荐使用Hbuilder，代码提示很给力，熟悉了快捷键后写代码也比较效率。

2、AMD规范

本教程展示了如何使用ArcGIS API的模块，其中JavaScript使用异步模块定义(AMD)。AMD规范代码和原始代码之间的主要区别是如何加载模块(require() vs. dojo.require()) ,以及类的模块引用(全局变量用于原始代码,而AMD样式代码使用局部变量)。具体区别可参照参考链接中的教程原始英文版本。

3、Dojo框架

ArcGIS API for JavaScript 基于Dojo框架搭建，所以学习 ArcGIS JavaScript API 需要对Dojo框架有一定的了解。

2、建立第一个应用程序HelloWord

2.1 、创建一个简单的HTML文档

首先我们先创建一个简单的Html文档，具体事例如下图：

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>HelloWord</title>
    </head>
    <body>
    </body>
</html>

2.2、引用的ArcGIS API JavaScript

要开始使用ArcGIS API为JavaScript工作，添加下面的脚本和链接到<head>标签中：

<link rel="stylesheet" href="http://js.arcgis.com/3.12/esri/css/esri.css">
<script src="http://js.arcgis.com/3.12/"></script>

script标签加载的ArcGIS API为JavaScript库。当新的JavaScript API的版本发布时，可更到新的版本号以匹配新版本的API。

esri.css样式表中包含特定于ESRI的部件和组件的样式。有关这个样式表的详细信息，请参阅上的帮助主题所需的CSS。

对于各种不同的主题样式表的URL如下：

http://js.arcgis.com/3.12/dijit/themes/claro/claro.css
http://js.arcgis.com/3.12/dijit/themes/tundra/tundra.css
http://js.arcgis.com/3.12/dijit/themes/nihilo/nihilo.css
http://js.arcgis.com/3.12/dijit/themes/soria/soria.css

2.3、加载模块

添加<SCRIPT>标签并从API加载指定的模块。JavaScript代码将直接在其内部增加。

<script>
    require(["esri/map"], function(Map) { ... });
</script>

2.4、确保DOM是可用

使用dojo/ domready！确保执行任何代码之前DOM是可用的。一旦DOM是可用的，则该函数传递给 require()将运行。该函数的代码会创建地图并添加底图。

 <script>
    require(["esri/map", "dojo/domReady!"], function(Map) {
      // code to create the map and add a basemap will go here
    });
  </script>

2.5、创建地图

通过加载esri/map模块的Map类，可用创建一个新的地图。“mapDiv”字符作为包含了地图的div元素的id号被传给Map。并指定其他地图的属性，如底图和起始中心点和缩放级别，在地图初始化的构造函数中。

var map ;
  require ([ "esri/map" ,  "dojo/domReady!" ], function ( Map )  {
     map =  new  Map ( "mapDiv" ,  {
      center :  [- 56.049 ,  38.485 ],
      zoom :  3 ,
      basemap :  "streets"
    });
  });

其他底图选项是："satellite", "hybrid", "topo", "gray", "oceans", "osm", "national-geographic"。可通过沙箱修改底图来替换不同的底图。查看附加的地图选项来查看地图类的更多细节。

2.6、定义页面内容

现在JavaScript已经在某一位置创建了地图，下一步是添加相关的HTML。此示例中，HTML页面是非常简单的：主体标记，它定义了浏览器中可见的内容，并且单个div元素将在被创建的地图主体中。

<body class="claro">
    <div id="mapDiv"></div>
</body>

2.7、页面设计

在本教程中，地图需要填充浏览器窗口。为了达到这一效果，需要早页面<head>标记中添加以下的CSS ：

 <style>
    html, body, #mapDiv {
      padding:;
      margin:;
      height: 100%;    }
  </style>

2.8、完整页面代码

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>HelloWord</title>
        <link rel="stylesheet" href="http://js.arcgis.com/3.12/esri/css/esri.css">
        <script src="http://js.arcgis.com/3.12/"></script>
        <script>
              var map ;
              require ([ "esri/map" ,  "dojo/domReady!" ], function ( Map )  {
                 map =  new  Map ( "mapDiv" ,  {
                  center :  [- 56.049 ,  38.485 ],
                  zoom :  3 ,
                  basemap :  "streets"
                });
              });
        </script>
        <style>
            html, body, #mapDiv {
              padding: 0;
              margin: 0;
              height: 100%;    }
        </style>
    </head>
    <body>
        <div id="mapDiv"></div>
    </body>
</html>

3、参考链接

https://developers.arcgis.com/javascript/jshelp/intro_firstmap_amd.html

https://developers.arcgis.com/javascript/jshelp/intro_firstmap.html