地图API是支持各种客户端，包括Javascript、富客户端、三维插件胖客户端等，它能够帮助您在网站中构建功能丰富、交互性强的地图应用程序。地图API不仅包含构建地图的基本接口，还提供了诸如本地搜索、路线规划等数据服务，可根据自己的需要进行选择。
基本地图操作：拖动、平移、缩放等；
地图控件操作：比例尺、导航、缩放等控件的显示/隐藏、对齐；
地图绘制操作：画圆、画矩形、画线、画多边形等；
地图标注操作：图片、文本等标记的显示/隐藏、拖拽、动画等；
矢量编辑操作：支持线、面节点编辑和拖曳；
本地搜索：提供指定地区的位置检索服务，比如在北京搜索“酒店”；
驾车导航：提供驾车出行方案的检索服务；
开始学习云在线地图API最简单的方式是看一个简单的示例。例如，我们要显示以北京的天安门为中心的 800x500 地图，可以这样做：
示例代码：
即使在此简单的示例中，也需要注意五点：
加载地图 API
源代码示例：
地图 DOM 元素
示例代码
要使地图在网页上显示，必须为其在网页中留出一个位置。通常，我们通过创建名为 div 的元素并在浏览器的文档对象模型 (DOM) 中获取此元素的引用执行此操作。在上述示例中，我们定义名为 "mapDiv" 的 div，并使用样式属性设置其尺寸。地图会自动使用容器尺寸调整自身的尺寸。
地图基本对象
源代码示例：
表示地图的 JavaScript 类是 Map 类。此类的对象在页面上定义单个地图。我们使用 JavaScript new 操作符创建此类的一个新实例。当创建新的地图实例时，在页面中指定一个 DOM 节点（通常是 div 元素）作为地图的容器。此代码定义一个全局变量（名为map），并将该变量分配给新的 Map 对象。函数 Map() 称为构造函数，其定义请参考《参考手册》。
加载地图
源代码示例：
当 HTML 页面显示时，文档对象模型 (DOM) 即会扩展，接收其他外部图像和脚本并将其合并到 document 对象中。为了确保只有在完全加载页面后才将我们的地图放在页面上，我们仅在 HTML 页面的'<'body'>' 元素收到onload 事件后才执行构造 Map 的函数。这样做可以避免出现不可预期的行为，并使我们可以对地图绘制的方式和时间进行更多控制。body 标签的 onload 属性是事件处理程序的一个示例。云在线地图Javascript API还提供了一组事件，可供您进行处理以确定状态变化。有关详细信息，请参阅地图事件部分。
北京超图软件股份有限公司
地址：北京市朝阳区酒仙桥北路 甲10号院电子城IT产业园107楼6层
邮编：100015
电话：+86-010-59896373
我已经阅读并同意条款 不同意条款
我的地址：
域名与key的生成规则
一个 Key 只对您域名（或IP）及域名（或IP）下的子目录有效。
例如:如果您为网址http://www.supermapcloud.com/注册，得到的 Key 可用于http://www.supermapcloud.com/域名下所有目录。
例如:如果您为网址http://www.supermapcloud.com/map注册，得到的 Key 可用于http://www.supermapcloud.com/map/域名下所有目录。
地图API是支持各种客户端，包括Javascript、富客户端、三维插件胖客户端等，它能够帮助您在网站中构建功能丰富、交互性强的地图应用程序。地图API不仅包含构建地图的基本接口，还提供了诸如本地搜索、路线规划等数据服务，可根据自己的需要进行选择。
地图有很多属性，通过更改这些属性可以更改地图实例的状态。我们来看下面两个例子：
源代码示例：
通过 get_level 可以得到当前地图的缩放级别，通过 zoomToLevel 方法可以修改地图的缩放级别。示例中定时每隔 2 秒钟将地图的缩放级别加 1，地图缩放级别为 0-18。
源代码示例：
通过 panTo 方法来设置地图的中心点，每次刷新后 2 秒钟，地图的中[12956382.042450484, 4855280.036674386] 移动至 [12747250.333062245, 4586221.6971105635]。
用来表示地图位置的方法。 SuperMap.LonLat 对象提供了此类机制，来实现一个地理坐标位置。您可以构建一个 Point2D 对象，以 {纬度, 经度} 的顺序传递其参数：
如果不知道一个地点（如”天安门“）的地理坐标，可以通过 “地址解析” 来得到。请注意：将 “地址” 转变为地理地点的过程叫做 “地址解析” 。有关详细信息，请参见服务部分中的 地址解析 。也可以通过 《参考手册》 来具体了解这个接口如何去使用。
使用地图 API 可在您自己的网页上内嵌超图在线地图。一个地图 API Key 只对您网络服务器上的一个“目录”有效。
要获得 API，您必须有超图地理信息云门户的帐户。向超图地理信息云门户提供您的帐户信息、服务网址并同意使用条款后，我们会向您发送一个由超图地理信息云门户系统自动分配的 Key ，该 Key 由字母数字组成，只与您的超图地理信息云门户帐户和服务网址相关。如地图 API 文档所述，您的服务必须使用含此 Key 的 HTML ”script”标记导入 超图地理信息云门户地图 API，否则超图地理信息云门户会因无效 Key 或无效网址而拦截请求。
key的引用方法如下：
具体获取key的过程请参见获取key页面。
SuperMapCloud地图 API具有事件接口，用户可以根据各自不同的需求添加不同的事件扩展。
如果你想对地图添加鼠标移动事件，只需要在代码中添加如下内容：
使用map.events.register 可以给map的鼠标注册移动事件，在lonlat的方法中可以获取到屏幕的坐标。通过map.getLonLatFromPixel()方法可以把拿到的坐标转发为所需要的经纬度坐标。
SuperMapCloud地图 API控件是用户与地图交互的 UI 元素。API提供多样的控件便于用户直接使用，并提供自定义控件Control，最大限度满足用户需求。
目前 SuperMapCloud地图 API中提供的控件有：
在地图上添加一个指北针控件，并将控件放置在地图的左上角，可在代码中添加如下内容：
首选初始化一个SuperMap.Control.PanZoomBar对象,然后通过map.addControl()来添加控件
代码示例：
几何图形是指覆盖到地图上面的所有图形，几何图统一类型是SuperMap.Geometry
SuperMapCloud 地图API中的主要包括的几何图形有：
如果想要在地图上的绘制点线面，通过SuperMapCloud地图API可以几何图形的显示样式，以及指定图形不同事件的相应方法，我们来看看下面例子：
源代码示例：
地图服务是指提供地图数据的接口，如 Poi检索、路线计算服务、公交线路详情、公交站点详情等。
提供指定地区的位置检索服务。你可以通过 SuperMap.OSP.Service.POISearch 对象检索POI数据。此对象与SuperMapCloud地图API Search Service 进行通信，该服务将接收检索请求并传回计算结果。
通过指定要检索的关键字文本字符串("如酒店")，要检索的地理区域范围（当前地图显示范围）来查找POI数据。检索服务返回的是多个 SuperMap.OSP.UI.POI 对象，并且能够分页获取。
SuperMapCloud地图 API 需要调用外部服务器，因此，对检索服务的访问是异步的。为此，您需要传递一个回调方法，以在请求完成后执行。此回调方法将会对结果进行处理。请注意，检索服务以 SearchResult 对象的形式传回Poi 数据,多个poi对象被包含在SearchResult对象的 records[] 属性中。
要检索Poi数据。需要创建一个类型为 SuperMap.OSP.Service.POISearch 的对象，并调用 POISearch.getPOIsByGeometry() 向检索服务发送一条请求，方法是为其传递三个参数分别是: SuperMap.OSP.Service.GetPOIsByGeometryParam 参数对象，回调方法，错误处理函数。
SearchRequest 的参数SuperMap.OSP.Service.GetPOIsByGeometryParam对象常量包含下列字段：
示例 SearchRequest 如下所示：
检索服务要求一个回调方法，在检索方法中返回结果。回调函数返回一个json格式的对象。
SearchResult 对象常量表示一个检索结果，并且是采用以下形式的对象：
POI是“Point of Interest”的缩写，可以翻译成“兴趣点”，这是一个GIS的术语。一般而言POI是相对于地名等普通地理信息的，狭义上不包含地名等。不过，广义上POI应该指一切可以抽象为点的地理对象。SuperMapCloud地图 API中 POI 对象提供了此类机制。代表一个地点对象。它有以下属性：
我们通过SuperMap.OSP.UI.POIGroup的addPOIs方法来保存分页查询出来的每一个POI,并将这个POIGroup由SuperMap.OSP.UI.POIManager来管理POI组的显示和隐藏。
下面举例说明本地检索、周边检索、矩形区域检索的使用。比如在北京搜索“酒店”，我们来看看下面几个例子：
示例代码
源代码示例：
在周边检索中，通过构markRoundGeometry(返回SuperMap.Geometry.Polygon类型的对象)函数来绘制一个圆形搜索区域,方法两个参数如下
用于计算两个或多个位置之间路线的服务。你可以通过 SuperMap.OSP.Service.TransportationAnalyst 对象检索路线计算服务。此对象与 SuperMapCloud Maps API Search Service 进行通信，该服务将接收检索请求并传回路线计算的结果。
要检索Poi数据。需要创建一个类型为 SuperMap.OSP.Service.TransportationAnalyst 的对象，并调用 findPath 向检索服务发送一条请求，方法是为其传递三个参数,分别是 SuperMap.OSP.Service.TransportionAParameter 参数对象，回调方法，错误处理函数。
transportationAnalyst 的参数SuperMap.OSP.Service.TransportionAParameter对象包含下列字段：
示例 SearchRequest 如下所示：
查询服务要求一个回调方法，在检索方法中返回结果。回调函数返回一个json格式的对象。
SearchResult 对象常量表示一个查询结果，并且是采用以下形式的对象：
查询的结果分为两部分,几何线路图和途径点。几何图通过featuresLayer.addFeatures(feature)显示;途经点我们可以把每个途经点的信息进行以文本形式展现。
示例代码
SuperMapCloud地图 API 需要调用外部服务器，因此，对地址解析服务的访问是异步的。为此，您需要传递一个回调方法，以在请求完成后执行。此回调方法将会对结果进行处理。
您可以通过在代码中使用SuperMap.OSP.ExtentionService.Geocoder 对象，访问 SuperMapCloud地图 API 地址解析服务。Geocoder.getPoint() 方法发起地址解析服务请求，方法是向地址解析服务传递三个参数,分别是:请求参数SuperMap.OSP.ExtentionService.GeocodeParam,回调函数和错误处理函数。
地址解析服务要求一个回调方法，以在检索到地址解析器返回的结果后执行。此回调有一个参数 GeocoderResult。
GeocoderResult 对象常量表示一个地址解析结果，并且是采用以下形式的对象：
每个结果是 Point2D 类型的对象
源代码示例：
SuperMap iClient 6R for Silverlight 是一套基于 Microsoft Silverlight 4.0 技术的 Web 地理信息系统开发包，利用该套开发包并结合 Microsoft .NET 开发框架，可快速方便地构建跨平台跨浏览器的Service GIS富客户端应用程序。Sliverlight API不仅可以在客户端流畅的显示地图，还可以迅速地使用 SuperMap GIS 服务器或第三方服务器提供的地图与服务，从而构建界面丰富、高度互动、体验优越的地图应用。
根据页面提示流程申请key，得到key后可根据需要调用接口，进行开发应用。标准key形式如下：8dsSDyqvi43wi%2BlOvLZZjg%3D%3D%0D%0A
下载开发包描述：点击转入下载页面
新建一个基于web应用的SilverLight工程，并在工程中引入开发包。
在 GettingStarted.mxml 中添加如下代码，实现访问 SuperMap iServer Java 2008 服务提供的分块动态图层。
SuperMap iClient 6R for Flex 是一套基于 Adobe Flex 技术和 Adobe Flash Builder4 开发平台的 Web 地理信息系统开发包。Flex API不仅支持普通用户对地图的浏览、查询等操作，还支持企业级用户构架高级的 GIS 客户端程序，定制专业的 GIS 服务。
根据页面提示流程申请key，得到key后可根据需要调用接口，进行开发应用。标准key形式如下：8dsSDyqvi43wi%2BlOvLZZjg%3D%3D%0D%0A
下载开发包描述：点击转入下载页面
新建一个基于web应用的Flex工程，并在工程中引入开发包。
key：用户申请的许可，必设参数。
在 GettingStarted.mxml 中添加如下代码，实现访问超图云服务提供的地图。
概述
所见及所得的 SampleCode 向用户演示了如何利用 SuperMap Online Service Platform 的各个接口实现相应的 GIS 功能，软件的大部分功能在示范代码中都能找到。 左侧的功能列表区展示了我们提供了哪些功能示范；右边页面上部对当前选中功能进行了介绍；右边页面下部为实现当前功能的代码；在右边页面顶部，可以看到 "运行代码" 的链接，点击它即可看见该示范代码运行效果。要保证示范程序能够正常运行，请按照以下步骤操作。
地图浏览
指地图基本的浏览功能和展示
点击这里查看源代码
地图操作
指地图基本的放大、缩小、漫游、全幅显示等地图操作，这是一个在线地图应用最基本的功能，OSP支持所有的基本地图操作，同时也支持鼠标滑轮、键盘操作。
地图上一列按钮分别是绘制点、绘制线、绘制面、放大、缩小、清除矢量要素共5个按钮。地图右方是填充颜色、透明度、线宽、边线颜色可以对矢量绘制的线型、颜色等进行设置，设置完成后，点击绘制点、线、或面按钮后，可以在地图上绘制自定义风格的矢量图形。
点击这里查看源代码
地物标记
本范例介绍：点击添加点、线、面的按钮，在地图上进行绘制。绘制完成后，点击绘制元素弹出信息框并且将元素置成选中状态，点击删除。删除所有元素。
点击这里查看源代码
地物标记
本示例介绍：地物标记指可以实现对点、线、面的标记，将属性信息填写好，点、线、或者面画于地图上，点击点、线、面就能弹出带有它们属性的信息框。
点击这里查看源代码
关键字查询
本示例主要通过搜索关键字查询到可视范围内的POI。
点击这里查看源代码
基于几何对象的搜索
本示例介绍：点击“绘制查询面”按钮，可以在地图上绘制一个矢量面区域，绘制完成，自动执行查询，查询结果为矢量面区域内的所有公园。
点击这里查看源代码
缓冲区分析
本示例介绍：可以设置缓冲半径，默认为500米，点击“绘制缓冲线”按钮，然后在地图上绘制一个矢量线对象，绘制完成后，在地图上显示出分析结果面区域，同时在地图下方会显示缓冲区域的面积和周长值。
点击这里查看源代码
最佳路径分析
通过设置起点和终点在地图上绘制两个POI,点击路径分析就会得到最佳路径。
点击这里查看源代码
地图打印
OSP提供的打印服务，可以将地图页面输出到打印设备。 本示例介绍：点击“打印地图”，会弹出地图打印窗口。
点击这里查看源代码
地图测量
提供两点之间的实地长度测量服务，面状区域的面积、周长测量服务。 本示例介绍：点击“绘制线并量算长度”按钮，程序会计算出绘制出的线的长度值。
点击这里查看源代码
地址匹配
通过搜索关键字来确定地理位置
点击这里查看源代码
圆选查询
本示例介绍：右键点击地图，可以在地图上绘制圆的中点，可输入想查询的词，点击确定即可得到结果，查询结果为圆面区域内的所有POI，圆的半径默认为1Km。
点击这里查看源代码
效果演示
| 图例 |
|
实现基于关键字查询POI。
点击“绘制查询面”按钮，可以在地图上绘制一个矢量面区域，绘制完成，自动执行查询，查询结果为矢量面区域内的所有POI。
关键字：可以设置缓冲半径，默认为500米，点击“绘制缓冲线”按钮，然后在地图上绘制一个矢量线对象，绘制完成后，自动查询这个线对象缓冲区内的POI。
缓冲范围:米,可以设置缓冲半径，默认为500米，点击“绘制缓冲线”按钮，然后在地图上绘制一个矢量线对象，绘制完成后，在地图上显示出分析结果面区域，同时在地图下方会显示缓冲区域的面积和周长值。
缓存半径米本示例介绍：点击“显示地图覆盖物”按钮，可以在地图上添加一组POI，同时还可以加上一条矢量线。点击“截图”按钮，完成地图截图，得到图片的URL。
路径分析模式:
| 最少路程 | 最少时间 | |
| 选择起点: | 健翔桥 | |
| 选择终点: | 三元桥 | |
OSP提供的打印服务，可以将地图页面输出到打印设备。。
点击“绘制线并量算长度”按钮，程序会计算出绘制出的线的长度值。
点击“获取实体”按钮，获取指定数据集下的所有实体对象列表。
点击“添加实体”按钮，可以在地图上添加一个实体到该数据集。
点击“显示地图覆盖物”按钮，可以在地图上添加一组POI，同时还可以加上一条矢量线。点击“分享地图”按钮，会将地图状态信息保存到服务器，同时返回一个key，将key传到另一个页面（即“查看分享的地图”链接打开的页面），在这个页面中可以使用key从服务器上获取地图状态信息，并恢复地图地图的状态，完成一次地图共享过程。
统计自定义面内宾馆酒店的各项指标
选择统计指标类型：在输入框中输入要查询的地址，点击地址匹配按钮，则程序会调用地址匹配服务，返回一个地址对应的经纬度坐标。
| 查询结果： | |||
| Lng: |
|
||
| Lat: |
|
||
感谢您使用超图地理信息云门户地图服务API！使用超图地理信息云门户地图服务API即表示您同意接受本“API使用条款”（以下称“条款”）以及超图地理信息云门户其他条款的约束。
超图地理信息云门户地图服务API由Javascript、Flex、Sliverlight、三维四种API构成，可让您在接受下述条款约束的情况下，在您的网站上显示超图地理信息云门户提供服务的地图图片；并可进行搜索服务、缓冲区分析、路径分析、地址匹配等服务。
在接受条款的情况下，您只可使用超图地理信息云门户地图服务API文档中所列明开放的API功能来对API相关服务数据的结果进行展示，不得直接存取、使用内部数据、图片、程序、模块或是任何其他超图地理信息云门户地图服务或功能。在接受使用条款约束的情况下，您可以在向最终用户提供其他信息的同时，使用API获得API相关服务数据。
要获得 API，您必须有超图地理信息云门户的帐户。向超图地理信息云门户提供您的帐户信息、服务网址并同意使用条款后，我们会向您发送一个由超图地理信息云门户系统自动分配的 Key ，该 Key 由字母数字组成，只与您的超图地理信息云门户帐户和服务网址相关。如地图 API 文档所述，您的服务必须使用含此 Key 的 HTML “script” 标记导入 超图地理信息云门户地图 API，否则超图地理信息云门户会因无效 Key 或无效网址而拦截请求。超图地理信息云门户对地图的数据和格式拥有完全和绝对的控制权。
在提供网络服务时，可能会对部分网络服务的用户收取一定的费用。在此情况下，北京超图软件股份有限公司会在相关页面上做明确的提示。如用户拒绝支付该等费用，则不能使用相关的网络服务。 北京超图软件股份有限公司（以下简称“超图”）对于地图的数据与格式保有绝对的权利，有权在未事前通知您的情况下，拒绝向您或任何其他人提供服务。
您必须保证：(i)您在开始使用服务时及使用服务期间，向超图提供的所有信息都是正确的和最新的；(ii)您具备必要的权利或授权，能够接受并履行使用条款；(iii)您承认使用条款具有书面协议的效力。
可通过“服务”访问的超图地理信息云门户的地图图片可能含照片图片。您对此照片图片的使用仅限于在“服务”本身范围内向最终用户展示，展示方式、形式、格式以及外观都必须与“服务”中的相同。除了通过“服务”得到的照片图片原样，您不得，也不得允许其他人复制、分发、显示、更改或以其他方式使用此照片图片。超图保留自行判定您对通过“服务”得到的照片图片的显示方式是否符合本条要求的权利，并保留出于任何原因随时终止或暂停您对照片图片访问的权利，恕不另行通知。
超图保留发布API后续版本以及要求您获得并使用最新版API的权利。超图可能会随时在事先通知或不通知的情况下下修改使用条款，您可以随时在www.supermapcloud.com上查看最新版本的使用条款。如果您无法接受修改，可通过从网站中删除API来取消“服务”。如果您继续在任何网站上使用“服务”，将被视为接受修改。如果使用条款与超图网络服务使用协议条款发生冲突，以使用条款为准。
如需使用本服务，您的网站所提供给用户的服务必须是开放给一般大众使用，并且是免费提供。
使用本服务时，即表示您同意对于您的服务内容与行为，以及由此产生的任何后果承担完全的责任。使用本服务，您必须接受和遵守使用条款。您不得从事以下活动，也不得同意、授权或指示任何第三人从事包括但不限于以下内容的活动：
违反《中华人民共和国电信条例》第五十七条规定或中华人民共和国其他法律、法规、规章制度的行为；
约束或限制其他用户使用或享用超图地理信息云门户地图服务；
出于任何非法或未经授权的目的使用超图地理信息云门户地图服务；
删除超图地理信息云门户地图服务中包含的任何版权声明、商标声明或其他所有权声明；
干扰或中断超图地理信息云门户地图服务或与超图地理信息云门户地图服务相连的服务器或网络，或违反任何与超图地理信息云门户地图服务相连网络的要求、程序、政策或法规；
使用任何漫游器、抓取工具、网站搜索/检索应用程序或其他设备检索或索引超图地理信息云门户地图服务的任一部分，或出于任何未经授权的目的收集关于用户的信息；
提交错误地明示或暗示此服务为超图地理信息云门户地图所属、赞助或认可的内容；
宣扬或提供关于非法行为的说明信息、宣扬针对任何团体或个人的人身伤害；或传播任何病毒、蠕虫、缺陷、特洛伊木马或其他具有破坏性的内容。
违反本使用条款。
如果您有任何该条款禁止的行为活动超图有权切断您的服务使用，且对超图造成损害的，应承担赔偿责任。
