1
文档编号：PTM02_WAPI201306130102
版 本 号： V1.0
范 围 ：公开
ArcGIS API for Javascript
开发教程
2013 年 3 月
易智瑞（中国）信息技术有限公司
2
刘宇
A
杜保坤
M
黄超
M
高杰
M
张楠
M
马鑫
M
伏伟伟
M
* 修订类型分为 A - ADDED M - MODIFIED D – DELETED
注：对该文件内容增加、删除或修改均需填写此记录，详细记载变更信息，以保
证其可追溯性。
3
目 录
1 基本概念 ............................................................................................................................... 9
1.1 Javascript 介绍.................................................................................................................. 9
1.2 Dojo 介绍........................................................................................................................ 10
1.3 REST 介绍 ...................................................................................................................... 10
1.4 JSON 介绍 ..................................................................................................................... 11
1.5 ArcGIS API for Javascript 介绍 ..................................................................................... 13
1.5.1 ArcGIS API for Javascript 介绍 .......................................................................................................... 13
1.5.2 ArcGIS API for Javascript 主要特点 .................................................................................................. 13
1.6 ArcGIS for Server 服务类型 .......................................................................................... 14
1.6.1 主要服务具备的能力 .......................................................................................................................... 15
2 应用开发起步 ..................................................................................................................... 18
2.1 集成开发环境和 API 的准备 ................................................................................... 18
2.1.1 ArcGIS API for Javascript 离线部署 .................................................................................................. 19
2.1.2 ArcGIS API for Javascript 帮助的离线部署 ...................................................................................... 20
2.1.3 关于智能提示 ....................................................................................................................................... 21
2.2 第一个应用程序 ........................................................................................................ 21
3 基础入门 ............................................................................................................................. 26
3.1 基本概念 .................................................................................................................... 26
3.1.1 地图........................................................................................................................................................ 26
3.1.2 图层........................................................................................................................................................ 26
3.1.3 Geometry ............................................................................................................................................... 27
3.1.4 Symbol ................................................................................................................................................... 28
3.1.5 Graphic .................................................................................................................................................. 29
3.1.6 Render .................................................................................................................................................... 29
3.1.7 FeatureSet .............................................................................................................................................. 29
3.2 常用控件（小部件） ................................................................................................ 30
3.2.1 鹰眼图 ................................................................................................................................................... 30
3.2.2 Scalebar.................................................................................................................................................. 32
4
3.2.3 书签........................................................................................................................................................ 34
3.2.4 InfoWindow ........................................................................................................................................... 36
3.2.5 编辑控件 ............................................................................................................................................... 38
3.2.6 图例........................................................................................................................................................ 39
3.2.7 时间滑块 ............................................................................................................................................... 42
4 服务访问 ............................................................................................................................. 45
4.1 预备知识 .................................................................................................................... 45
4.1.1 Dojo 基本函数 ...................................................................................................................................... 46
4.2 动态 2D 地图服务加载 ............................................................................................. 49
4.2.1 动态 2D 地图服务主要方法 ............................................................................................................... 49
4.2.2 主要属性 ............................................................................................................................................... 50
4.2.3 动态 2D 地图服务加载示例 ............................................................................................................... 50
4.3 切片服务加载（缓存 2D 地图服务） ..................................................................... 52
4.3.1 切片服务加载示例............................................................................................................................... 53
4.4 要素服务加载 ............................................................................................................ 53
4.4.1 如何使用要素服务............................................................................................................................... 54
4.4.2 要素图层按需模式显示示例 .............................................................................................................. 54
4.5 影像服务加载 ............................................................................................................ 58
4.5.1 什么是影像服务 ................................................................................................................................... 58
4.5.2 ArcGIS 影像服务可以做什么 ............................................................................................................ 59
4.5.3 ArcGISImageServiceLayer 介绍 ......................................................................................................... 60
4.5.4 影像服务动态处理............................................................................................................................... 61
4.5.5 影像服务加载示例............................................................................................................................... 63
4.5.6 影像服务的时态展示示例 .................................................................................................................. 64
4.6 OpenStreetMap 地图服务 .............................................................................................. 68
4.6.1 OpenStreetMap 加载示例代码............................................................................................................ 68
4.7 OGC 标准服务 ............................................................................................................... 69
4.7.1 WMS 服务加载示例 ............................................................................................................................ 70
4.8 GraphicsLayer ................................................................................................................. 71
4.8.1 GraphicsLayer 的主要方法 ................................................................................................................. 72
4.8.2 GraphicsLayer 的主要属性 ................................................................................................................. 72
4.8.3 GraphicsLayer 示例 ........................................................................................................................... 72
4.9 动态图层 .................................................................................................................... 76
5
4.9.1 什么是动态图层 ................................................................................................................................... 76
4.9.2 如何注册工作空间............................................................................................................................... 77
4.9.3 动态图层使用示例............................................................................................................................... 78
5 地图操作 ............................................................................................................................. 80
5.1 地图 ............................................................................................................................ 80
5.1.1 Map 的主要方法 ................................................................................................................................. 81
5.1.2 属性........................................................................................................................................................ 82
5.1.3 事件........................................................................................................................................................ 84
5.1.4 地图操作示例 ....................................................................................................................................... 85
5.2 导航 ............................................................................................................................ 86
5.2.1 Navigation 定义的主要方法 .............................................................................................................. 86
5.2.2 事件........................................................................................................................................................ 86
5.2.3 导航示例 ............................................................................................................................................... 87
5.3 绘图 ............................................................................................................................ 87
5.3.1 绘图工具的主要方法 .......................................................................................................................... 88
5.3.2 属性........................................................................................................................................................ 89
5.3.3 事件........................................................................................................................................................ 89
5.3.4 绘图示例 ............................................................................................................................................... 90
5.4 图形编辑 .................................................................................................................... 90
5.4.1 编辑工具的主要方法 .......................................................................................................................... 91
5.4.2 事件........................................................................................................................................................ 91
6 符号渲染 ............................................................................................................................. 92
6.1 渲染器 ........................................................................................................................ 92
6.2 简单符号渲染 ............................................................................................................ 93
6.2.1 示例........................................................................................................................................................ 93
6.3 唯一值渲染 ................................................................................................................ 94
6.3.1 示例........................................................................................................................................................ 94
6.4 分级渲染 .................................................................................................................... 95
6.4.1 示例........................................................................................................................................................ 95
7 任务知多少 ......................................................................................................................... 96
7.1 查询检索 .................................................................................................................... 97
7.1.1 QueryTask .............................................................................................................................................. 97
