【转】ArcGIS API for Silverlight/WPF 2.1学习笔记（一）
源自：http://blog.163.com/zwx_gis/blog/static/32434435201122193611576/ （主页：http://blog.163.com/zwx_gis/）
一、安装
1、Visual Studio:
（1）Visual Studio 2010或Visual Web Developer Express 2010
（2）Silverlight 4 Tools for Visual Studio (add-on) ：仅Silverlight 4支持
（3）Expression Blend 4 SDK for Silverlight (also included with Expression Blend 4)
（Necessary for behavior and Silverlight support）
2、Expression Blend:
（1）Expression Blend 4：Included with Expression Studio editions
3、其它附加（非必须安装）
（1）Deep Zoom Composer
（2）Silverlight Toolkit
1、VS2010，新建“Silverlight应用程序”
2、勾选“在新网站中承载Silverlight应用程序”（ASP.NET Web应用程序项目）
3、添加引用：.NET\ESRI.ArcGIS.Client
4、xaml文件中：添加命名空间指向ArcGIS Silverlight/WPF；添加Map控件，并指定其MapServiceLayer。
<UserControl x:Class="SilverlightApplication.MainPage" xmlns="…" …
xmlns:esri="http://schemas.esri.com/arcgis/client/2009">
<Grid x:Name="LayoutRoot">
<esri:Map x:Name="MyMap" >
<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"
Url="http://hostName/ArcGIS/rest/services/mapservName/MapServer"/>
</esri:Map>
</Grid>
</UserControl>
注意：为了能跨域访问（MapServer在不同域），需要将clientaccesspolicy.xml或 crossdomain.xml文件拷贝到网站根目录（如IIS的C:\inetpub\wwwroot\）。
三、ArcGIS API for Microsoft Silverlight/WPF 2.1的ODM：
1、OMD(Object model diagrams对象模型图表)总览：参见附件一
2、OMD(Object model diagrams对象模型图表)详表：参见附件二
exent属性：地图的左下角和右上角坐标值，即地图的显示范围
默认：所有地图图层的范围
spatial reference（空间参考）属性：如果空间参考不一致，地图将不显示
默认：采用第一个图层的空间参考值
<esri:Map x:Name="MyMap">
<esri:Map.Extent>
<esriGeometry:Envelope XMin="." YMin="." XMax="." YMax="." >
<esriGeometry:Envelope.SpatialReference>
<esriGeometry:SpatialReference WKID="26777"/>
</esriGeometry:Envelope.SpatialReference>
</esriGeometry:Envelope>
</esri:Map.Extent>
</esri:Map>
也可后台指定：
ESRI.ArcGIS.Client.Geometry.Envelope initialExtent = new ESRI.ArcGIS.Client.Geometry.
Envelope(ESRI.ArcGIS.Client.Bing.Transform.GeographicToWebMercator( new ESRI.
ArcGIS.Client.Geometry.MapPoint(-130, 20)),ESRI.ArcGIS.Client.Bing.Transform.
GeographicToWebMercator(new ESRI.ArcGIS.Client.Geometry.MapPoint(-65, 55)));
initialExtent.SpatialReference = new ESRI.ArcGIS.Client.Geometry.SpatialReference(102100);
MyMap.Extent = initialExtent;
注：WKID-Well Know ID：EPSG发布的代表特定椭球体、单位、地理坐标系或投影坐标系的ID，例如 "EPSG：4326" 指的就是WGS 84地理坐标系，其中WKID=4326
第一加载图层的空间参考决定了整个地图的空间参考
先加载的图层在地图下边，如下图：
Map Service Layers
两种类型：
tiled Service：瓦片，地图服务器上预先定义好的Image
Dyanmic Service：动态，动态生成的Image
|
Service host |
Map Service Layer Type |
描述 |
|
ArcGIS Service |
ArcGISTiledMapServiceLayer |
地图服务器的缓存地图服务已经存在所有地图image瓦片 |
|
ArcGISDynamicMapServiceLayer |
地图服务器的无缓存地图服务动态生成地图images，可动态访问矢量(vector)和(栅格)raster数据 |
|
|
ArcGISImageServiceLayer |
地图服务器的image服务动态生成地图images，可动态访问栅格数据 |
|
|
Bing Maps |
TileLayer |
|
Feature layers
包含features，如geometry（几何学）和attribute（属性）
不支持多图层缓存
ArcGISDynamicMapServiceLayer的背景颜色通常为透明
opacity属性用于定义图层的透明度（0-1）
地图不显示的原因有：
url不正确；
Map Service不可用
Map Service网站或主机没有跨域认证文件（clientaccesspolicy.xml或 crossdomain.xml）
Map Service要求token或credentials
（1）map的ZoomDuration属性和PanDuration 属性：用于指定缩放和平移动作的持续时间。
如<esri:Map ZoomDuration="00:00:00" PanDuration ="00:00:00” …>
（2）map的SnapToLevels属性：用于指定level of detail（LOD），地图在该级别是否显示。
如<esri:Map SnapToLevels=”ture” …>
（3）map的ZoomFactor属性：键盘+/-进行缩放时，缩放的级数
（4）系统已封装的键盘和鼠标导航地图快捷键：
|
键盘 |
鼠标 |
结果 |
|
上、下、左、右 |
|
地图平移 |
|
|
拖动 |
地图平移 |
|
+、- |
|
地图缩放，缩放比例为map的ZoomFactor属性指定的值 |
|
|
双击 |
地图放大，放大比例为map的ZoomFactor属性指定的值 |
|
Shift |
拉框 |
拉框放大 |
|
Shift+Ctrl |
拉框 |
拉框缩小 |
|
|
滚轮 |
地图缩放 |
（5）系统已封装的导航地图的方式和接口：
|
map的属性|方法 |
描述 |
|
Extent属性 |
map.Extent=envelope |
|
Zoom() |
map.Zoom(n) ，n为缩放比率，n>1为zoomin，n<1为zoomout |
|
Zoomto() |
map.Zoomto(envelope) |
|
ZoomToResolution() |
map.ZoomToResolution(lod.Resolution); Resolution指每pixel包含的map unit数，如 Lod lod=tiledMapServiceLayer.TileInfo.Lods[5]; map.ZoomToResolution(lod.Resolution); |
|
Panto() |
Panto(point)，point为地图窗口的中心点 |
4、Time-aware layers（此知识点不懂，有待继续研究）
ArcGIS10开始支持Time-aware layers，存储了随时间变化的信息，可用于：
（1）飓风路径及其它气象学事件；
（2）人口和土地利用的历史变化；
（3）监测生产现状的变化；
（4）火灾或洪水的行进；
（5）疾病的蔓延。
Time-aware layers的使用：
（1）使用Tookit里的TimeSlider控件
（2）使用API自己建立应用程序
Time-aware layers的建立：
在ArcMap中，右键图层\属性\Time，勾选Enable time on this layer
地图发布后，可以使用time-aware map或feature Service（ArcGISDynamicMapServiceLayer 或FeatureLayer classes）来随时间变化的查询和展示。
对于Image Services，栅格地图必须提供Mosaic Dateset，如下图：
访问TimeExtent类：通过time-aware layers的TimeExtent属性访问
TimeExtent timeExtent = (MyMap.Layers["MyFeatureLayer"] as FeatureLayer)
.TimeExtent;
//TimeExtent timeExtent = new ESRI.ArcGIS.Client.TimeExtent();
timeExtent.Start = DateTime.Parse("2002-01-01T17:33:46.0000000",
CultureInfo.CurrentCulture, DateTimeStyles.AdjustToUniversal);
BehaviorAPI位于Esri.ArcGIS.Client.Behaviors集（内藏在Expression Blend4中），用于定义用户与地图的交互。使用时必须添加System.Windows.Interactivity集。
xaml文件中必须添加命名空间如下：
xmlns:esriBehaviors="clr-namespace:ESRI.ArcGIS.Client.Behaviors;assembly=ESRI.ArcGIS.Client.Behaviors" xmlns:i="clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity"
BehaviorAPI包括三个核心类：
（1）Behavior：由trigger（地图上的事件）和action（产生结果）组成
|
Behavior |
Description |
Code Example |
|
ConstrainExtentBehavior |
Limit the map extent to an envelope. The user cannot navigate outside of the envelope defined on the behavior. |
<esri:Map x:Name="MyMap" Extent="-120,30,-60,60"> . . . <i:Interaction.Behaviors> <esriBehaviors:ConstrainExtentBehavior ConstrainedExtent="-120,30,-60,60"/> </i:Interaction.Behaviors> </esri:Map> |
|
MaintainExtentBehavior |
Maintain the current extent when the map is resized. |
<esri:Map x:Name="MyMap"> . . . <i:Interaction.Behaviors> <esriBehaviors:MaintainExtentBehavior /> </i:Interaction.Behaviors> </esri:Map> |
|
ShowCoordinatesBehavior |
Show map coordinates next to the mouse cursor when hovering over the map. |
<esri:Map x:Name="MyMap"> . . . <i:Interaction.Behaviors> <esriBehaviors:ShowCoordinatesBehavior FormatString="{}{0:0.00} , {1:0.00}"/> </i:Interaction.Behaviors> </esri:Map> |
（2）Action：由trigger（地图上的事件）和目标结果
|
Action |
Description |
Code Example |
|
ClearGraphicsAction |
Clears all graphics in a graphics layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:ClearGraphicsAction GraphicsLayerID="MyGraphicsLayer" TargetName="MyMap" /> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
MeasureAction |
Shows measure distance, radius, and area. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:MeasureAction AreaUnit="SquareMiles" DisplayTotals="True" DistanceUnit="Miles" MapUnits="DecimalDegrees" MeasureMode="Polygon" FillSymbol="{StaticResource DefaultFillSymbol}" TargetName="MyMap"/> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
PanToAction |
Pans to a specified geometry. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:PanToAction TargetName="MyMap"> <esriBehaviors:PanToAction.Geometry> <esriGeometry:MapPoint X="-120" Y="43" /> </esriBehaviors:PanToAction.Geometry> </esriBehaviors:PanToAction> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
RedlineAction |
Draw graphics on the map and add it to a graphics layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:RedlineAction Color="#FF32FF00" DrawMode="Freehand" GraphicsLayerID="MyGraphicsLayer" TargetName="MyMap"/> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
SpatialQueryAction |
Draw geometry on the map to query features in a feature layer. Draw the results in a graphics layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:SpatialQueryAction DrawMode="Rectangle" LayerID="MyGraphicsLayer" Url="http://myserver/ArcGIS/rest/myservice/MapServer/2" Symbol="{StaticResource GraphicsLayerFillSymbol}" TargetName="MyMap" /> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
ToggleLayerAction |
Toggle the visibility of a layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:ToggleLayerAction LayerID="MyDynamicLayer" TargetName="MyMap"/> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
UpdateFeatureLayerAcvtion |
Refresh the contents of a feature layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:UpdateFeatureLayerAction FeatureLayerID="MyFeatureLayer" TargetName="MyMap" /> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
ZoomToAction |
Zoom to a specified geometry. If the geometry is a point, the map will pan. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:ZoomToAction TargetName="MyMap"> <esriBehaviors:ZoomToAction.Geometry> <esriGeometry:Envelope XMin="-110" YMin="40" XMax="-100" YMax="50" /> </esriBehaviors:ZoomToAction.Geometry> </esriBehaviors:ZoomToAction> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
ZoomToFullExtentAction |
Zoom to the full extent of all layers. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:ZoomToFullExtentAction TargetName="MyMap"/> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
|
ZoomToLayerAction |
Zoom the extent of a specified layer. |
<Button> <i:Interaction.Triggers> <i:EventTrigger EventName="Click"> <esriBehaviors:ZoomToLayerAction LayerID="MyTileLayer" TargetName="MyMap"/> </i:EventTrigger> </i:Interaction.Triggers> </Button> |
（3）Trigger（略）
