qd-changjing/public/leaflet/libs/iclient8c/examples/developGuide.html

890 lines
53 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html>
<head>
<link href='./css/bootstrap.min.css' rel='stylesheet' />
<link href='./css/bootstrap-responsive.min.css' rel='stylesheet' />
<link href='./css/sm-extend.css' rel='stylesheet' />
<link href='./css/sm-doc.css' rel='stylesheet'>
<style>
#togglelink:hover{
cursor: pointer;
}
</style>
</head>
<body data-spy="scroll" data-target=".subnav" data-offset="50" onLoad="init()">
<!--导航条-->
<div class="navbar navbar-fixed-top" id="navbar">
</div>
<!--功能区-->
<div id='container' class='container'>
<div id="inner-container">
<div class="page-header">
<h2>目录&nbsp&nbsp<span class="label label-info" id="togglelink" onClick="toggleList()">隐藏</span></h2>
<div id="lists">
<ul>
<li> <a href="#details1"><span>1</span>地图应用"Hello World"</a>
<ul>
<li><a href="#details1_1"><span>1.1</span>获取开发包</a></li>
<li><a href="#details1_2"><span>1.2</span>创建HTML显示页面</a></li>
<li><a href="#details1_3"><span>1.3</span>引用资源文件</a></li>
<li><a href="#details1_4"><span>1.4</span>添加地图创建代码</a></li>
<li><a href="#details1_5"><span>1.5</span>使用浏览器运行查看</a></li>
</ul>
</li>
<li> <a href="#details2"><span>2</span>地图控件</a>
<ul>
<li><a href="#details2_1"><span>2.1</span>地图控件概述</a></li>
<li><a href="#details2_2"><span>2.2</span>控件使用</a></li>
<li><a href="#details2_3"><span>2.3</span>修改控件显示位置</a></li>
</ul>
</li>
<li> <a href="#details3"><span>3</span>地图图层</a>
<ul>
<li><a href="#details3_1"><span>3.1</span>地图图层概述</a></li>
<li><a href="#details3_2"><span>3.2</span>添加图层</a></li>
<li><a href="#details3_3"><span>3.3</span>移除图层</a></li>
</ul>
</li>
<li> <a href="#details4"><span>4</span>图层样式</a>
<ul>
<li><a href="#details4_1"><span>4.1</span>图层样式概述</a></li>
<li><a href="#details4_2"><span>4.2</span>图层样式使用</a></li>
</ul>
</li>
<li> <a href="#details4"><span>5</span>地图覆盖物</a>
<ul>
<li><a href="#details5_1"><span>5.1</span>地图覆盖物概述</a></li>
<li><a href="#details5_2"><span>5.2</span>矢量图形覆盖物Vector</a></li>
<!--<li><a href="#details4_3"><span>4.3</span>标注覆盖物Marker</a></li>
<li><a href="#details4_4"><span>4.4</span>信息窗Popup</a></li>-->
</ul>
</li>
<li> <a href="#details6"><span>6</span>事件</a>
<ul>
<li><a href="#details6_1"><span>6.1</span>事件概述</a></li>
<li><a href="#details6_2"><span>6.2</span>浏览器事件监听处理</a></li>
<li><a href="#details6_3"><span>6.3</span>使用自定义事件</a></li>
<li><a href="#details6_4"><span>6.4</span>定义用户自己的事件</a></li>
</ul>
</li>
<li> <a href="#details7"><span>7</span>地图服务</a>
<ul>
<li><a href="#details7_1"><span>7.1</span>地图服务概述</a></li>
<li><a href="#details7_2"><span>7.2</span>地图服务使用流程</a>
<ul>
<li><a href="#details7_2_1"><span>7.2.1</span>构建服务参数类</a></li>
<li><a href="#details7_2_2"><span>7.2.2</span>构建服务类并发送请求</a></li>
<li><a href="#details7_2_3"><span>7.2.3</span>使用结果类</a></li>
</ul>
</li>
<li><a href="#details7_3"><span>7.3</span>交通换乘服务</a>
<ul>
<li><a href="#details7_3_1"><span>7.3.1</span>交通换乘简介</a></li>
<li><a href="#details7_3_2"><span>7.3.2</span>交通换乘接口使用方法</a></li>
<li><a href="#details7_3_3"><span>7.3.3</span>示例效果展示</a></li>
</ul>
</li>
</ul>
</li>
<li> <a href="#details8"><span>8</span>坐标投影转换</a>
<ul>
<li><a href="#details8_1"><span>8.1</span>坐标投影转换概述</a></li>
<li><a href="#details8_2"><span>8.2</span>坐标投影转换使用</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div id="content">
<!--初始化Hello World-->
<h2 class="title" id="details1">地图应用"Hello World"</h2>
<div>
<h3 id="details1_1">获取开发包</h3>
<p>下载 SuperMap iClient 8C(2017) for JavaScript 压缩包文件,解压安装包文件于本地磁盘,解压后的安装包结构如下: </p>
<div class="pageImage"> <img src="./images/packageCatalog_All.png" alt="SuperMap iClient 8C(2017) for Javascript 安装包结构" /></div>
<h3 id="details1_2">创建HTML显示页面</h3>
<p>在磁盘上任意位置新建文件夹并自定义该文件夹,本例命名为"MyFirst";在 "MyFirst"文件夹下用文本编辑工具如NotePad++)新建一个"GettingStarted.html"的 html 页面,注意将该 html 页面保存为 UTF-8 编码格式,并添加入以下代码:</p>
<pre>
<code>&lt;!DOCTYPE HTML&gt;
&lt;html&gt;
&lt;body onload="init()"&gt;
&lt;!--地图显示的div--&gt;
&lt;div id="map" style="position:absolute;left:0px;right:0px;width:800px;height:500px;" &gt;
&lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
<h3 id="details1_3">引用资源文件</h3>
<p> 分两步引用资源:</p>
<ol>
<li>将第一步得到的 theme 文件夹拷贝到"MyFirst"文件夹下;</li>
<li>拷贝libs文件夹到"MyFirst"文件夹下;</li>
</ol>
<h3 id="details1_4">添加地图创建代码</h3>
<p>&lt;html&gt;&lt;body&gt;之间添加如下代码,实现创建地图功能。</p>
<pre class="code"><code>&lt;head&gt;
&lt;title&gt;SuperMap iClient for JavaScript:TiledDynamicRESTLayer&lt;/title&gt;
&lt;!--引用需要的脚本--&gt;
&lt;script src="./libs/SuperMap.Include.js"&gt;&lt;/script&gt;
&lt;script type="text/javascript"&gt;
//声明变量map、layer、url
var map, layer,
url = "http://localhost:8090/iserver/services/map-world/rest/maps/World";
//创建地图控件
function init() {
map = new SuperMap.Map ("map");
//创建分块动态REST图层该图层显示iserver 8C 服务发布的地图,
//其中"world"为图层名称url图层的服务地址{transparent: true}设置到url的可选参数
layer = new SuperMap.Layer.TiledDynamicRESTLayer("World", url,
null, {maxResolution:"auto"});
layer.events.on({"layerInitialized": addLayer});
}
function addLayer() {
//将Layer图层加载到Map对象上
map.addLayer(layer);
//出图map.setCenter函数显示地图
map.setCenter(new SuperMap.LonLat(0, 0), 0);
}
&lt;/script&gt;
&lt;/head&gt;
</code></pre>
<h3 id="details1_5">使用浏览器运行查看</h3>
<p>启动 SuperMap iServerJava 8C 并运行 GettingStarted.html 文件,浏览地图数据。 </p>
<div id="map"></div>
</div>
<!--地图控件-->
<h2 class="title" id="details2">地图控件</h2>
<div>
<h3 id="details2_1">地图控件概述</h3>
<div>
<p>控件用来控制地图的显示和对交互操作的响应在没有明确指定的情况下地图默认添加Navigation、PanZoomBar控件。在SuperMap iClient for Javascript地图API中提供了丰富的控件下面举例说明<br>
<p>具有显示界面控件有如下:</p>
<table border="0">
<tr>
<td><strong>PanZoomBar</strong> 地图平移缩放控件,提供对地图的平移和缩放的控制操作,默认位于地图左上角
</td>
<td width="200px"><img class="icon" src="./images/panzoomBar.png"></img></td>
</tr>
<tr>
<td><strong>ScaleLine</strong> 比例尺控件,显示地图的比例关系,默认位于地图左下角</td>
<td><img class="icon" src="./images/scaleLine.png"></img></td>
</tr>
<tr>
<td><strong>LayerSwitcher</strong> 地图图层切换控件,可以查看图层信息和控制图层显示,默认位于地图右上角</td>
<td><img class="icon" src="./images/layerSwitcher.png"></img></td>
</tr>
<tr>
<td><strong>OverviewMap</strong>地图鹰眼控件,辅助查看地图更大范围的显示,默认位于右下角,可折叠</td>
<td><img class="icon" src="./images/overview.png"></img></td>
</tr>
</table>
<ul><li>不可见控件有如下:</li>
<li><strong>Navigation</strong>地图浏览控件,监听鼠标点击、平移、滚轮等事件来实现对地图的浏览操作。</li>
<li><strong>SelectFeature</strong>要素选择控件监听鼠标悬停点击事件来选择vector图层上面的要素。</li>
<li><strong>DrawFeatue</strong> 要素绘制控件,监听鼠标事件来实现要素的绘制。</li>
<li><strong>……</strong></li>
</ul>
</p>
</div>
<h3 id="details2_2">控件使用</h3>
<div><p>向地图添加控件有两种方式其一可以通过在初始化构造Map的时候设置Map的controls属性来添加控件。代码如下</p>
<pre>
<code>var map = new SuperMap.Map('map', {controls: [new SuperMap.Control.PanZoomBar()]});
</code></pre>
<p>也可以在Map构造完成后调用接口Map的接口addControl()来添加控件。下面示例中在map构建完成后添加比例尺控件
</p>
<pre><code>var map = new SuperMap.Map('map');
map.addControl(new SuperMap.Control.ScaleLine());
</code></pre>
</div>
<h3 id="details2_3">修改控件显示位置</h3>
<div>
<p> 对于显示控件我们可以在添加控件的时候通过设置addControl接口的第二参数px来设置控件显示相对于地图左上角的像素位置不可见控件不支持该操作。<br>
下面的代码中修改默认的ScaleLine控件的位置为800,400</p>
<pre>
<code>var map = new SuperMap.Map('map');
map.addControl(new SuperMap.Control.ScaleLine(), new SuperMap.Pixel(800,400));
</code></pre>
</div>
</div>
<!--地图图层-->
<h2 class="title" id="details3">地图图层</h2>
<div>
<h3 id="details3_1">地图图层概述</h3>
<div>
<p>图层用来承载地图信息的显示。地图可以添加一个或者多个图层组合显示用户所需要的最终效果。SuperMap iClient for JavaScript提供了丰富的图层分别对应不同的地图服务和客户端展示需求支持的图层如下<br>
<ul>
<li><strong>TiledDynamicRestLayer</strong> 动态分块图层用来对接SuperMap iServer 8C的分块动态REST图层服务。</li>
<li><strong>CloudLayer</strong>云图层用来显示SuperMap云服务发布的图层。</li>
<li><strong>SimpleCachedLayer</strong>缓存图层用来显示SuperMap iServer 8C的缓存图层(Version3.1)。</li>
<li><strong>WMS</strong> 该图层用来显示OGC地图服务的地图数据。</li>
<li><strong>WMTS</strong> 用来显示基于OGC WMTS 1.0.0标准实现的地图服务的地图数据。</li>
<li><strong>Vector</strong> 矢量要素渲染图层。</li>
<li><strong>Markers</strong>标签图层。</li>
<li><strong>OpenLayers提供的其他第三方图层...</strong></li>
</ul>
</p>
</div>
<h3 id="details3_2">添加图层</h3>
<div><p> 使用map的addLayer()、addLayers()方法可以添加图层到map上,其中addLayers()方法可添加多个图层,即图层数组。</p>
<p> 针对图层的添加,需要分两种情况进行考虑:</p>
<p>一种是需要异步加载信息的图层异步加载的图层需要监听图层构建完成的layerInitialized事件在图层初始化完成后才能调用addLayer()接口添加到Map上。TiledDynamicRestLayer就属于需要异步加载的图层它通过设置url向服务端发送请求来得到相关参数进而加载图层到Map上。</p>
<p>示例添加TiledDynamicRestLayer到地图上</p>
<pre>
<code>var map, layer,
url = "http://localhost:8090/iserver/services/map-world/rest/maps/World";
function init(){
//初始化地图
map = new SuperMap.Map("map");
//初始化图层
layer = new SuperMap.Layer.TiledDynamicRESTLayer("World", url, null,{maxResolution:"auto"});
//监听图层信息加载完成事件
layer.events.on({"layerInitialized":addLayer});
}
//异步加载图层
function addLayer(){
map.addLayer(layer);
//显示地图范围
map.setCenter(new SuperMap.LonLat(0, 0), 0);
}
</code></pre>
<p>另一种则是不需要异步加载信息的图层,此类图层在初始化的时候由用户设置相关信息,初始化之后直接添加地图中便可显示。除去 TiledDynamicRestLayer 之外的图层都属于此类以WMS添加为例</p>
<pre>
<code>var map, layer,
url = "http://localhost:8090/iserver/services/map-world/wms130/World Map";
function init(){
//初始化地图
map = new SuperMap.Map("map");
//初始化图层
layer = new SuperMap.Layer.WMS("World Map",url,{layers: "0.12,0.8"});
map.addLayer(layer);
//显示地图范围
map.setCenter(new SuperMap.LonLat(0, 0), 2);
}
</code></pre>
</div>
<h3 id="details3_3">移除图层</h3>
<div>
<p> 移除地图的使用map.removeLayer()接口,没有差异化操作:</p>
<pre>
<code>map.removeLayer(layer);
</code></pre>
</div>
</div>
<!--图层样式-->
<h2 class="title" id="details4">图层样式</h2>
<div>
<h3 id="details4_1">图层样式概述</h3>
<div>
<p>图层的样式相关类有 Symbolizer 类、Style类、StyleMap 类,其中,
<ul>
<li><strong>Symbolizer</strong> 用于要素渲染的样式基类, 其特点是样式只针对具体的点、线、面等对象,一般不需要用户构建,而是由 Style 创建出来,内部在使用的时候通过 css 或者 canvas 的画笔控制来显示不同效果。</li>
<li><strong>Style</strong>样式类,定义某种状态的完全样式,点、线、面等全部包括在内。如果在构造 Style 时没有设置 style 属性,则会使用 SuperMap.Feature.Vector 的默认风格。</li>
<li><strong>StyleMap</strong>图层样式,定义多种状态下的图层样式,其属性 styles 类型为 SuperMap.Style存储了由 key(state), value(Style) 组成的状态-样式键值对构成的信息。StyleMap 信息被赋予到使用样式显示的 Vector 图层,默认支持四种样式 "default", "temporary", "select", "delete"。</li>
</ul>
</p>
</div>
<h3 id="details4_2">图层样式使用</h3>
<div><p><strong>1.图层样式定义</strong></p>
<p>(1)直接设置状态-样式键值对,需要注意的是,只有定义样式的状态才具有样式,未定义的状态的样式其样式 style 为 null。如下示例只 default 和 select 两个状态的样式 所以仅仅这两个状态有样式,另外两种状态 temporary、delete 的样式为 null代码如下所示</p>
<pre>
<code>var myStyles = new SuperMap.StyleMap({
"default":new SuperMap.Style({
fillColor:"#ffcc33",
strokeColor:"#ccff99",
strokeWidth:2,
graphZIndex:1
}),
"select":{
fillColor:"33eeff",
strokeColor:"3366aa",
graphicZIndex:2
}
});
</code></pre>
<p>(2)直接设置单一 style依照此方式定义样式之后四种状态都有下面的 style 样式, 实现代码如下:</p>
<pre>
<code></code><code>var myStyles = new SuperMap.StyleMap(
new SuperMap.Style({
fillColor:"#ffcc33",
strokeColor:"#ccff99",
strokeWidth:2,
graphZIndex:1
})
);
</code></pre>
<p>(3)直接传入样式信息参数,依照此方式定义样式之后,四种状态都有下面的 style 样式, 实现代码如下:</p>
<pre>
<code>var myStyles = new SuperMap.StyleMap({
fillColor:"#ffcc33",
strokeColor:"#ccff99",
strokeWidth:2,
graphZIndex:1
});
</code></pre>
<p>(4)当默认支持的四种状态不能满足用户需求时,用户也可自定义状态及其样式,代码如下:</p>
<pre>
<code>var myStyles = new SuperMap.StyleMap({
"default":new SuperMap.Style({
fillColor:"#ffcc33",
strokeColor:"#ccff99",
strokeWidth:2,
graphZIndex:1
}),
"click": new SuperMap.Style({
fillColor:"33eeff",
strokeColor:"3366aa",
graphicZIndex:2
})
});
</code></pre>
<p><strong>2.图层的样式使用</strong></p>
<p>定义样式之后,可通过以下两种方式使用:</p>
<p>(1)通过设置 SuperMap.Layer.Vector 的 styleObject 对象)
或者 styleMapkey: Style对象样式。代码如下</p>
<pre>
<code>Var vectorLayer = new SuperMap.Layer.Vector("Vector Layer", {styleMap: myStyles});
</code></pre>
<p>(2)通过设置 SuperMap.Feature.Vector 的样式 Style 属性获得样式</p>
<pre>
<code>Var vectorLayer = new SuperMap.Layer.Vector("Vector Layer");
feature = new SuperMap.Feature.Vector();
feature.style = new SuperMap.Style({
strokeColor: "#304DBE",
strokeWidth: 1,
pointerEvents: "visiblePainted",
fillColor: "#304DBE",
fillOpacity: 0.8,
pointRadius:2
}) ;
vectorLayer.addFeatures(feature);
</code></pre>
</div>
</div>
<!--覆盖物-->
<h2 class="title" id="details5">地图覆盖物</h2>
<div>
<h3 id="details5_1">地图覆盖物概述</h3>
<div>
<p>我们把叠加到地图上标注、矢量图层元素、弹窗信息等内容统称为地图覆盖物。覆盖物拥有自己的地理坐标,会在地图浏览的过程中伴随着地图同时移动。当前支持的覆盖物有以下几种:
<ul><li><strong>Vector</strong> 矢量元素覆盖物配合Geometry和Style可以以丰富的形式展示点、线、面等地理矢量图形需要添加到Vector图层上显示。</li>
<li><strong>Marker</strong> 标签覆盖物对地图上的点进行标准可以自定义选择标注的图标需添加到Markers图层上显示。</li>
<li><strong>Popup</strong> 信息窗口覆盖物,提供更灵活的信息展示能力,在弹窗中可以自定义信息的展示。</li>
</ul>
</p>
</div>
<h3 id="details5_2">矢量图形覆盖物Vector</h3>
<div><p>矢量图形覆盖物vector在定义的时候必须指明定对应的地理矢量图形Geometry。样式Style属性可选如果指定则默认获取要素所在vector图层设置的style样式。</p>
<p>下面的示例定义一个点矢量图形覆盖物,没有设置样式,显示默认效果:
</p>
<pre>
<code>//构造geometry对象
var point = new SuperMap.Geometry.Point(0,0);
//构建覆盖物对象
var pointVector = new SuperMap.Feature.Vector(point);
</code></pre>
<div class="pageImage">
<img src="./images/defaultStyle.png"/>
</div>
<p>修改点样式为红色填充,黄色边框:</p>
<pre>
<code>//构造geometry对象
var point = new SuperMap.Geometry.Point(0,0);
//构建覆盖物对象
var pointVector = new SuperMap.Feature.Vector(point);
//修改点样式红色
pointVector.style = {fillColor: "red",strokeColor: "yellow",pointRadius:6};
</code></pre>
<div class="pageImage">
<img src="./images/customStyle.png"/>
</div>
<p>使用Vector图层的addFeatures(),removeFeatures(),removeAllFeatueres()可以实现对矢量图形要素的添加显示和移除。下面的示例从构建地图、图层到最后添加覆盖物的完整流程:</p>
<pre><code>var map, layer, vectorLayer,
url = "http://localhost:8090/iserver/services/map-world/rest/maps/World";
function init(){
//初始化地图
map = new SuperMap.Map("map");
//初始化图层
layer = new SuperMap.Layer.TiledDynamicRESTLayer("world", url, null, {maxResolution:"auto"});
layer.events.on({"layerInitialized":addLayer});
vectorLayer = new SuperMap.Layer.Vector();
}
function addLayer(){
map.addLayers([layer,vectorLayer]);
//显示地图范围
map.setCenter(new SuperMap.LonLat(0, 0), 0);
addFeature();
}
function addFeature(){
var point = new SuperMap.Geometry.Point(0,0);
var pointVector = new SuperMap.Feature.Vector(point);
//添加矢量图形覆盖物
vectorLayer.addFeatures(pointVector);
}
</code></pre>
</div>
<!--<h3 id="details4_3">标注覆盖物Marker</h3>
<div>
<p> </p>
</div>
<h3 id="details4_3">信息弹窗Popup</h3>
<div>
<p> </p>
</div>-->
</div>
<!--事件-->
<h2 class="title" id="details6">事件</h2>
<div>
<h3 id="details6_1">事件概述</h3>
<div>
<p>浏览器机制中的JavaScript事件驱动是完成用户交互的主要方法。通过监听事件并在事件上注册事件监听的处理方法可以在事件被激活的时候获取用户的操作信息调用事件监听器上的代码进行响应处理。
</p>
<p>SuperMap iClient for JavaScript 拥有一个自己的自定义事件模型用来处理地理API中定义的事件(如layer的layerInitialized事件)。使用Events来处理自定义事件的过程和普通的浏览器事件处理流程基本相似。
</p>
</div>
<h3 id="details6_2">浏览器事件注册监听</h3>
<div>
<p>SuperMap iClient for Javascript地图API提供了公共的方法来帮助开发者解决注册监听浏览器事件时候的跨浏览器兼容问题。使用SuperMap.Event.observe()和SuperMap.Event.stopObserving()方法来处理对浏览器事件的监听使用SuperMap.Function.bind()和SuperMap.Function.bindAsEventListener()方法来解决事件处理在跨浏览器时候的参数和this对象不一致问题。关于接口的具体信息请参考API描述。</p>
<p>下面示范代码对一个div对象注册监听鼠标点击事件
</p>
<pre>
<code>function init(){
var div = document.createElement("div");
document.body.appendChild(div);
div.innerText = "点击测试";
//将处理函数和调用对象绑定函数最终调用里面的this对象即指向第二个参数指定的object对象
var observeFun = SuperMap.Function.bindAsEventListener(clickHandler, div);
//监听div的click事件处理函数为observeFun即最终的clickHandler
SuperMap.Event.observe(div, "click",observeFun);
}
function clickHandler(event){
//this对象指向绑定的object即DIV本身
alert(this.innerText);
}
</code></pre>
</div>
<h3 id="details6_3">使用自定义事件</h3>
<div>
<p>自定义事件机制的核心类是SuperMap.Events该类提供了事件监听、触发的相关方法
<ul><li><strong>register()</strong>注册事件监听到事件处理队列的尾端。</li>
<li><strong>registerPriority()</strong>注册优先事件监听,即添加到事件处理队列的最前面。</li>
<li><strong>on()</strong>注册事件监听,参数为一个由事件/事件处理函数组成的键值对对象。</li>
<li><strong>unregister()</strong>移除事件监听。</li>
<li><strong>un()</strong>移除事件监听参数同on()。</li>
<li><strong>triggerEvent()</strong>触发(派发)自定义事件。</li></ul>
</p>
<p>在Map、Layer、SelectFeature控件等以及其他可操作类中我们都内置了events对象来实现对自定义事件的注册监听处理layer的异步加载就是一个很好的示例。下面我们分别演示使用register()和on()方法来实现对图层异步加载完成事件的监听处理,最终效果一样:</p>
<pre><code>//使用on()接口监听事件
layer.events.on({"layerInitialized": addLayer});
</code></pre>
<pre><code>//使用register()接口监听事件
layer.events.register("layerInitialized", undefined, addLayer)
</code></pre>
<p>使用unregister()和un()来移除事件的使用方法也很简单,示范代码如下:</p>
<pre><code>//使用un()接口监听事件
layer.events.un({"layerInitialized": addLayer});
//使用unregister()接口监听事件
//layer.events.unregister("layerInitialized", undefined, addLayer)
</code></pre>
</div>
<h3 id="details6_4">定义用户自己的事件</h3>
<div>
<p>使用地图API中的自定义事件机制开发者也可以定义属于自己的事件类型和处理。使用的时候需要初始化一个events对象然后调用该对象完成事件的相关处理。下面示例中我们点击div对象触发一个自定义的事件"userselect"然后监听events监听来完成</p>
<pre><code>var div;
function init(){
div = document.createElement("div");
div.innerText = "点击测试";
document.body.appendChild(div);
//初始化一个events。定义事件的监听器和自定义事件名称
var events = new SuperMap.Events(div, div, ["userselect"]);
//将事件对象保存到div对象上
div.events = events;
//监听自定义事件,注册处理函数,参数一指定事件类型,参数二指定事件处理对象,参数三定义处理函数
div.events.register("userselect", div, userselectHandler)
//将处理函数和调用对象绑定函数最终调用里面的this对象即指向第二个参数指定的object对象
var observeFun = SuperMap.Function.bindAsEventListener(clickHandler, div);
SuperMap.Event.observe(div, "click",observeFun);
}
function clickHandler(event){
//this对象指向绑定的object即DIV本身
this.events.triggerEvent("userselect", event);
}
//响应自定义事件处理
function userselectHandler(event){
alert(this.innerText + event.type);
}
</code></pre>
</div>
</div>
<!--Rest服务-->
<h2 class="title" id="details7">地图服务</h2>
<div>
<h3 id="details7_1">地图服务概述</h3>
<div>
<p>地图服务是指对地图提供的量算、查询、分析等服务的统称Supermap iClient for JavaScript核心库中提供了对接SuperMap iServer 8C相关服务所需的类和接口。目前已对接的服务有
<ul><li><strong>MapService服务</strong>地图信息服务类,用来获取服务器上提供的地图服务的详细信息 。</li>
<li><strong>Mesure服务</strong>量算服务,提供地图上距离,面积的的量算功能。</li>
<li><strong>Data服务</strong>对接iServer相关数据查询编辑等服务。</li>
<li><strong>Query服务</strong>地图查询服务。</li>
<li><strong>NetworkAnalyst服务</strong>网络分析服务。</li>
<li><strong>SpatialAnalyst服务</strong>空间分析服务。</li>
<li><strong>Theme服务</strong>专题图服务</li>
<li><strong>LayerServices服务</strong>图层服务类,提供图层信息的获取和对临时图层的修改设置。</li>
<li><strong>TrafficTransferAnalyst服务</strong>交通换乘服务类。</li></ul>
</p>
</div>
<h3 id="details7_2">地图服务使用流程</h3>
<div>
<p>地图服务在使用的过程中一般会用到以下相关类服务类Service参数类Parameter事件服务数据类EventArgs结果信息类Result。使用流程也围绕这四个类的使用展示下面以MeasureService为例逐步说明
</p>
<div>
<h4 class="thirdTitle" id="details7_2_1">构建服务参数类</h4>
<div>
<p>服务参数类提供服务请求所需的信息不同服务具有不同的信息需求MeasureParameters类提供量算的查询参数封装所需的参数有geometry和unit定义量算的几何对象和单位代码如下</p>
<pre>
<code>var measureParam = new SuperMap.REST.MeasureParameters();
//设置量算查询的矢量对象geometry可以通过用户绘制查询结果直接初始化等方法获取
measureParam.geometry = geometry;
mesureParam.unit = SuperMap.REST.Unit.MILE;
</code></pre>
</div>
<h4 class="thirdTitle" id="details7_2_2">构建服务类并发送请求</h4>
<div>
<p>服务类负责向服务端发送请求并将查询结果返回封装到对应的服务结果类中。使用服务类指定服务URL等服务参数向服务端发送请求信息然后通过监听服务请求完成事件从事件服务数据类中获取最终的结果Result对象按照用户需求进行处理代码如下</p>
<pre>
<code>//初始化服务类,设置服务请求关键参数
var myMeasuerService = new SuperMap.REST.MeasureService(URL);
myMeasuerService.measureMode = SuperMap.REST.MeasureMode.DISTANCE;
//注册服务请求完成事件
myMeasuerService.events.on({ "processCompleted": measureCompleted });
//提交服务请求,传递服务查询参数
myMeasuerService.processAsync(measureParam);
</code></pre>
</div>
<h4 class="thirdTitle" id="details7_2_3">使用结果类</h4>
<div>
<p>在服务请求事件的处理过程中,我们可以获取结果信息并予以展示,下面使用弹窗的形式展示量算结果:</p>
<pre>
<code>//在每个服务对应的结果事件中我们都封装了其返回结果结果信息如MeasureEventArgs.result
function measureCompleted(measureEventArgs) {
//result为MeasureResult类型
var distance = measureEventArgs.result.distance,
area = measureEventArgs.result.area,
unit = measureEventArgs.result.unit;
if (distance != -1) {
alert(distance + "米");
} else if (area != -1) {
alert(area + "平方米");
}
}
</code></pre>
</div>
</div>
</div>
<h3 id="details7_3">交通换乘服务</h3>
<div>
<h4 class="thirdTitle" id="details7_3_1">交通换乘简介</h4>
<div>
<p>
交通换乘的目的便是为用户的出行提供准确、及时、优化的公交信息服务,
用户可以对现有的公交站点、公交线路、进行查询,通过输入任意出行起点、
终点,交通换乘系统可在相应的约束条件下,查找搜索出公交出行路线和换乘方案,
用户根据自己的需要选择合适的出行方案,极大的方便了人们出行和生活。
</p>
</div>
<h4 class="thirdTitle" id="details7_3_2">交通换乘接口使用方法</h4>
<div>
<p>
交通换乘的方法如下:一,首先定义起始站点和终点站点名查询函数;
二,进行交通换乘查询,首先需在客户端设置用于向服务
端发送的交通换乘参数,其次定义交通换乘服务,
用于向服务端发送请求并从服务端获得交通换乘结果数据,
最后将返回的结果在客户端进行展示。
</p>
<p>下面以长春交通数据模拟的公交线路数据为例,用户通过输入起始站点名
(支持模糊查询)可查找出相关匹配的站名,范例提供了时间最短、
距离最短、最少换乘、最少步行四种换乘策略类型同时提供了地铁优先、不乘坐地铁、公交优先、NONE四种乘车偏好设置用户可根据自己
的需要选择最为合适的出行路线。</p>
<p><strong>1、交通站点查询</strong></p>
<p>使用方式如下:</p>
<p>1定义站点查询参数stopQueryParameters,需要设置的参数有keyWord 和 returnPosition</p>
<p>2定义站点查询服务stopQueryService。此函数监听了processCompletedprocessFailed两个事件
processAsync方法向服务端发送请求当请求成功时会触发processCompleted事件请求返回结果失败会触发processFailed事件。
</p>
<p>实现代码如下所示:</p>
<pre>
<code>
function execStopQuery() {
//设置站点查询参数
var params = new SuperMap.REST.StopQueryParameters({
keyWord: "园", // 站点名称关键字
returnPosition: true //是否返回站点坐标信息
});
//定义站点查询服务。设置服务url地址,同时监听stopQuerySucceed和stopQueryFailed两个事件
var stopQueryService = new SuperMap.REST.StopQueryService(url, {
eventListeners: {
processCompleted: stopQuerySucceed,
processFailed: stopQueryFailed
}
});
// 向服务端发送请求,返回请求结果
stopQueryService.processAsync(params);
}
//站点查询成功回调函数
function stopQuerySucceed(stopQueryEventArgs) {
//todo
}
//站点查询失败回调函数
function stopQueryFailed(serviceFailedEventArgs) {
//todo
}
</code></pre>
<p><strong>2、交通换乘方案查询</strong></p>
<p>交通方案查询该方法返回所有的乘车方案根据方案中的介绍信息可以获取具体的乘车路线。实现过程首先需要设置交通换乘参数需要设置的参数包括solutionCount、transferTactic、transferPreference、walkingRatio、points定义交通换乘服务函数通过此函数的processAsync方法向服务端发送请求并从服务端获得交通换乘结果数据。该函数监听了processCompleted和processFailed两个事件服务端返回查询结果失败时触发 processFailed 事件,服务端成功返回查询结果时触发 processCompleted 事件。</p>
<p>实现代码如下所示:</p>
<pre>
<code>//定义公交换乘方案查询
function execTransSolutionsQuery() {
//配置公交换乘方案查询参数
var params = new SuperMap.REST.TransferSolutionParameters({
solutionCount: 6,//最大换乘导引数量
transferTactic: SuperMap.REST.TransferTactic.LESS_WALK,//公交换乘策略类型
transferPreference: SuperMap.REST.TransferPreference.NONE,//乘车偏好
walkingRatio: 10,//步行与公交的消耗权重比
points: points //起始点坐标
});
// 配置公交换乘服务,监听两个事件processCompleted和processFailed,服务端成功返回查询结果时触发
//processCompleted 事件,服务端返回查询结果失败时触发 processFailed 事件。
var solutionService = new SuperMap.REST.TransferSolutionService(DemoURL.traffic_transfer, {
eventListeners: {
processCompleted: transferSolutionsSucceed,
processFailed: transferSolutionsFailed
}
});
//execute
solutionService.processAsync(params);
}
//执行公交换乘方案成功返回结果
function transferSolutionsSucceed(transferSolutionEventArgs) {
//TODO
}
//执行公交换乘方案失败返回
function transferSolutionsFailed (serviceFailedEventArgs) {
//TODO
}</code></pre>
<p><strong>3、乘车路线查询</strong></p>
<p>根据换乘方案查询结果transferSolutions得到的乘车方案获取某一条乘车路线的详细信息。</p>
<p>实现代码如下所示:</p>
<pre>
<code>function execTransferPathQuery() {
//设置乘车线路参数
var params = new SuperMap.REST.TransferPathParameters({
points: points, //起始点坐标
transferLines: [transferLine] //当前换乘路线包含路线ID、起止点等。
});
// 配置乘车路线查询服务,监听两个事件processCompleted和processFailed,服务端成功返回查询结果时触发
//processCompleted 事件,服务端返回查询结果失败时触发 processFailed 事
var transPathService = new SuperMap.REST.TransferPathService(DemoURL.traffic_transfer, {
eventListeners: {
processCompleted: transferPathSucceed,
processFailed: transferPathFailed
}
});
//执行查询
transPathService.processAsync(params);
}
//成功返回结果时调用此函数
function transferPathSucceed(transferPathEventArgs) {
//TODO
}
//返回结果失败时调用此函数
function transferPathFailed(serviceFailedEventArgs) {
//TODO
}
</code></pre>
<p><strong>3.执行交通换乘查询,提供了最短时间、最短距离,少步行、少换乘四种不同策略的方案查询。</strong></p>
<p>四种不同策略查询:</p>
<p>1时间最短查询</p>
<pre>
<code>//设置最短距离交通换乘路线策略
SuperMap.REST.TransferTactic.LESS_TIME;
</code></pre>
<p>2最少步行查询</p>
<pre>
<code>//设置最少步行交通换乘路线策略
SuperMap.REST.TransferTactic.LESS_WALK;
</code></pre>
<p>3少换乘查询</p>
<pre>
<code>//设置少换乘交通换乘路线策略
SuperMap.REST.TransferTactic.LESS_TRANSFER;
</code></pre>
<p>4最短距离</p>
<pre>
<code>//设置最短距离交通换乘路线策略
SuperMap.REST.TransferTactic.MIN_DISTANCE;
</code></pre>
<p><strong>3.设置交通换乘查询提供了地铁优先、公交优先不乘坐地铁、NONE四种不同偏好的方案查询。</strong></p>
<p>四种不同偏好查询:</p>
<p>1地铁优先</p>
<pre>
<code>//设置地铁优先交通换乘路线偏好
SuperMap.REST.TransferPreference.SUBWAY;
</code></pre>
<p>2公交优先</p>
<pre>
<code>//设置公交优先交通换乘路线偏好
SuperMap.REST.TransferPreference.BUS;
</code></pre>
<p>3不乘地铁</p>
<pre>
<code>//设置不乘地铁交通换乘方案偏好
SuperMap.REST.TransferPreference.NO_SUBWAY;
</code></pre>
<p>4最短距离</p>
<pre>
<code>//无偏好设置
SuperMap.REST.TransferPreference.NONE;
</code></pre>
</div>
<h4 class="thirdTitle" id="details7_3_3">示例效果展示</h4>
<div>
<p>这里仅展示少换乘查询结果效果图,
其中起始站点为绿园,终点站点为儿童广场,查询效果图如下所示:</p>
<div class="pageImage">
<img src="./images/lessTransfer1.png"/>
</div>
</div>
</div>
</div>
<h2 class="title" id="details8">坐标投影转换</h2>
<div>
<h3 id="details8_1">坐标投影转换概述</h3>
<div>
<p>JavaScript提供的坐标投影转换类---SuperMap.Projection 用于在客户端进行投影变换,这个类封装了与 Pro4js 投影对象进行交互的方法。</p>
<p>其中Proj4js 是一个JavaScript 脚本库,用来进行坐标投影转换,详细介绍请参见 Proj4js 官网,地址如下:<a href="http://trac.osgeo.org/proj4js/">http://trac.osgeo.org/proj4js/</a>
</p>
<p>目前 Proj4js 支持的投影种类有WGS84, EPSG:4326, EPSG:4269, EPSG:3875, EPSG:3785, EPSG4139,EPSG:4181, EPSG:4272, EPSG:4302, EPSG:21781, EPSG:102113,EPSG:26591,EPSG:26912, EPSG:27200, EPSG:27563, EPSG:41001, EPSG:42304,EPSG:102067, EPSG:102757, EPSG:102758, EPSG:900913, GOOGLE
</p>
<p>SuperMap 默认支持 EPSG:4326, CRS:84, urn:ogc:def:crs:EPSG:6.6:4326, EPSG:900913, EPSG:3857,
EPSG:102113 和 EPSG:102100 等投影间的转换。</p>
</div>
<h3 id="details8_2">坐标投影转换使用</h3>
<div>
<p>客户端坐标投影转换的使用方法如下:</p>
<p>1对于SuperMap支持的投影可用如下方法实现客户端的投影转换
</p>
<p>方法通过设置map的 projection 和 displayProjection 属性实现,例如:</p>
<pre>
<code>var mapOptions = {
//设置地图的投影方式
projection: "EPSG:3857",
//设置MousePosition控件的鼠标位置的需要进行的投影方式
displayProjection: "EPSG:4326"
};
var map = new SuperMap.Map('map', mapOptions);
map.addControl(new SuperMap.Control.MousePosition());
</code></pre>
<p>方法(二),可调用 transform() 方法进行坐标转换,例如:</p>
<pre>
<code>var point = new SuperMap.LonLat(-71.147, 42.472);
point.transform("EPSG:3857", "EPSG:4326");
</code></pre>
<p>详细方法可参见范例 <strong>地图图层---地图投影转换</strong></p>
</div>
<div>
<p>(2) 对于SuperMap 不支持或者用户自定义的投影</p>
<p>首先需要<a href="http://trac.osgeo.org/proj4js/wiki/Download">下载</a>、解压缩 proj4 的产品包,并引入产品包中的 proj4.js 文件。</p>
<p>自定义投影可通过Proj4js.defs[]静态常量定义键值对实现。有关各种投影的参数定义,可参考<a href="http://spatialreference.org">http://spatialreference.org</a>如果已有定义可搜索并查看其投影参数例如EPSG:21418其投影参数为<a href="http://spatialreference.org/ref/epsg/21418/proj4/">http://spatialreference.org/ref/epsg/21418/proj4/</a>
</p>
<p>用户自定义一个EPSGCODE然后再用1的方法调用代码如下</p>
<pre>
<code>//自定义一个defs用来实现用户自定义的投影转换。其中EPSG:10010为自定义的EPSGCODE键值内容为参考投影参数其分别代表了名称、
//投影、转换到wgs84坐标系三参数、椭球长半轴、扁率、原点纬线、中央经线、两条标准纬线、东偏移量、北偏移量、单位等。
Proj4js.defs["EPSG:10010"] = "+title=Beijing1954 +proj=lcc +towgs84=0.0000,0.0000,0.0000 +a=6378245.0000 +rf=298.3 +lat_0=0.00000000 +lon_0=104.000000000 +lat_1=24.000000000 +lat_2=40.000000000 +x_0=0.000 +y_0=0.000 +units=m +no_defs";
var map = new SuperMap.Map({
div: "map",
//设置地图的投影方式
projection: "EPSG:3857",
//设置MousePosition控件的鼠标位置的需要进行的投影方式
displayProjection: new SuperMap.Projection("EPSG:10010")
});
map.addControl(new SuperMap.Control.MousePosition());
</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class='footer'>
<p>版权所有&nbsp;&copy; 2000-2016 &nbsp;北京超图软件股份有限公司</p>
</div>
<script src='./js/jquery.js'></script>
<script src='./js/bootstrap.js'></script>
<script src="./js/navbar.js"></script>
<script src="./js/GoTop.js" id="js_gotop"></script>
<script src="../libs/SuperMap.Include.js"></script>
<script>
var map, local, url, layer, isListToggled = false,
htmlUrl = document.location.toString(),
stringIndex = htmlUrl.indexOf("//"),
subString = htmlUrl.substring(0, stringIndex-1);
if (subString == "file") {
url = "http://localhost:8090/iserver/services/map-world/rest/maps/World";
} else {
local = document.location.host;
url = "http://" + local + "/iserver/services/map-world/rest/maps/World";
}
//创建地图控件
function init() {
map = new SuperMap.Map ("map");
//创建分块动态REST图层该图层显示iserver 8C 服务发布的地图,
//其中“world”为图层名称url图层的服务地址{transparent: true}设置到url的可选参数
layer = new SuperMap.Layer.TiledDynamicRESTLayer("World", url,
null, {maxResolution:"auto"});
layer.events.on({"layerInitialized": addLayer});
}
function addLayer() {
//将Layer图层加载到Map对象上
map.addLayer(layer);
//出图map.setCenter函数显示地图
map.setCenter(new SuperMap.LonLat(0, 0), 0);
}
function toggleList(){
var lists = $("#lists");
var link = document.getElementById("togglelink");
if(!isListToggled){
link.innerText = "显示";
lists.hide('slow');
isListToggled = true;
}else{
link.innerText = "隐藏";
lists.show();
isListToggled = false;
}
}
</script>
</body>
</html>