ArcGIS API for JavaScript可以与使用ArcGIS.com地图查看器创建的Web地图一起工作。使用地图查看器可以快速轻松地创建和共享地图。Web地图可以包含ArcGIS Server的地图、图像和要素服务，KML文档，以及OGC web服务的图层。您还可以导入存储在逗号分隔的值表(.csv或.txt)或GPS交换格式(.gpx)文件中的数据。在创建web地图时，您可以创建和定义弹出内容，设置一个basemap（底图）并指定初始extent（范围）。更多信息和示例可在web地图规范帮助主题中获得。

    使用ArcGIS.com查看器创建地图并保存和共享地图后，就可以在API中使用它们。查看ArcGIS.com资源中心，以获得关于创建和共享Web地图的更多细节。

1、开始使用模板

    您还可能希望使用您的地图创建Web应用程序，您可以使用自己的外观和功能部署在您的组织的Web服务器上。ArcGIS.com包括可自定义的模板，可以轻松创建Web地图应用程序。它们包括常见的地图元素，如图例和比例尺以及更高级的功能，如编辑。有关其他信息，请参考制作Web应用程序帮助主题。

2、创建来自ArcGIS.com网站的地图

    esri.arcgis.utils命名空间包含用于处理ArcGIS.com中的web地图的使用方法。

    您可以在使用ArcGIS API构建的应用程序中使用esri.arcgis.utils工具方法显示Web地图。esri.arcgis.utils.createMap方法使用ArcGIS.com 中地图的信息创建地图，该信息可以是web地图id或者是web地图的值表示形式。

    使用web地图id创建地图

    使用web地图id导航到web地图的详细信息页来创建一个地图，web地图的id是详细信息页的URL的终端。例如，Topographic map（地形图）的详细页URL是http://www.arcgis.com/home/item.html?id=d5e02a0c1f2b4ec399823fdd3c2fdebd，ID是d5e02a0c1f2b4ec399823fdd3c2fdebd。

    一旦您有了web地图id就可以使用esri.arcgis.utils.createMap方法创建地图。

var mapid="d5e02a0c1f2b4ec399823fdd3c2fdebd"
var mapDeferred = esri.arcgis.utils.createMap(mapid, "map", {
  mapOptions: {
    slider: true,
    nav:false
  }
});

    使用JSON创建地图

    创建web地图的另一种方法是使用JSON创建地图。JSON是Web地图的值表示形式。这在应用程序无法访问ArcGIS.com的情况下是很有用的。查看ArcGIS web map JSON格式文档以了解有关此规范的更多细节。

    这个片段创建了一个新的web地图，并定义了地图的标题、描述和初始范围。

var webmap = {};
webmap.item = {
  "title":"Soil Survey Map of USA",
  "snippet": "Detailed description of data",
  "extent": [[-139.4916, 10.7191],[-52.392, 59.5199]]
};

    接下来，指定构成地图的图层，在这段代码中，添加了来自ArcGIS.com的World Terrain basemap（世界地形图）以及一个覆盖图层，该覆盖图层为地图添加了更多信息，如边界、城市、水特征、地标和道路，还添加了一个显示美国农业部土壤信息的操作层。

    

webmap.itemData = {
"operationalLayers": [{
  "url": "http://server.arcgisonline.com/ArcGIS/rest/services/Specialty/Soil_Survey_Map/MapServer",
  "visibility": true,
  "opacity": 0.75,
  "title": "Soil Survey Map",
  "itemId": "204d94c9b1374de9a21574c9efa31164"
}],
"baseMap": {
  "baseMapLayers": [{
    "opacity": 1,
    "visibility": true,
    "url": "http://services.arcgisonline.com/ArcGIS/rest/services/World_Terrain_Base/MapServer"
    },{
    "isReference": true,
    "opacity": 1,
    "visibility": true,
    "url": "http://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Reference_Overlay/MapServer"
    }],
  "title": "World_Terrain_Base"
},
"version": "1.1"
};

    一旦web地图被定义，就可以使用esri.arcgis.utils.createMap方法从该定义中创建地图。

var mapDeferred = esri.arcgis.utils.createMap(webmap, "map", {
  mapOptions: {
    slider: true
  }
});

注意：您可以使用esri.arcgis.utils.getItem()从ArcGIS.com项目检索项目定义。

3、使用地图

    esri.arcgis.utils.createMap方法的返回值是dojo.Deferred。若要使用deferred，定义一个.then()的回调函数，该回调函数将在异步请求完成时执行。

mapDeferred.then(function(response) {
  map = response.map;
});

    返回给回调函数的response对象中包含的信息取决于您正在使用的ArcGIS API for JavaScript的版本。

ArcGis for Java Script 中文教程 arcgis for js中文文档_Web

ArcGis for Java Script 中文教程 arcgis for js中文文档_应用程序_02

    要访问web地图中的图层，请使用itemInfo.itemData.operationalLayers，在下面的代码中，操作层用于创建一个地图中图层的图例。

var layers = response.itemInfo.itemData.operationalLayers;
var layerInfo = [];
dojo.forEach(layers,function(layer){
  if(!layer.featureCollection){
   layerInfo.push({"layer":layer.layerObject,"title":layer.title});
  }
});
var legendDijit = new esri.dijit.Legend({
  map:map,
  layerInfos:layerInfo
},"legendDiv");
legendDijit.startup();