<map_uri_>/map[.<format>]
WebMap 资源是地图的内容资源。
支持的方法:
支持的表述格式:RJSON、JSON。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。
http://supermapiportal:8190/iportal/web/maps/{id}/map.rjson
获取指定地图的内容。
对 WebMap 资源执行 GET 请求,返回如下结构的符合 WebMap 规范的地图内容 RJSON 表述。有关 WebMap 的介绍,请参见:SuperMap 提供的 WebMap 地图规范。
属性 | 说明 |
title |
地图的名称。 |
description |
地图描述信息。 |
extent |
地图的范围。 |
level |
地图的缩放级别。 |
center |
地图中心点。 |
baseLayer |
地图的底图信息。 |
layers |
地图的图层信息。 |
projection |
地图的投影坐标系 |
version |
地图的版本号。 |
对 WebMap 资源:http://localhost:8190/iportal/web/maps/3/map.rjson 执行 GET 请求,返回的 rjson 格式的表述如下:
{
"extent": {
"leftBottom": {
"x": 7851611.545458,
"y": 2436200.9655012
},
"rightTop": {
"x": 14896048.07222,
"y": 6320424.9948408
}
},
"level": 5,
"center": {
"x": 11373829.808839,
"y": 4378312.980171
},
"baseLayer": {
"layerType": "TILE",
"visible": true,
"name": "China",
"url": "http://localhost:8080/iserver/services/map-china400/rest/maps/China"
},
"description": "",
"projection": "EPSG:3857",
"title": "China",
"version": "1.0"
}
修改指定地图的内容。
发送请求时,需要在请求体中传递符合 WebMap 规范的 RJSON 数据。有关 WebMap 的介绍,请参见:SuperMap 提供的 WebMap 地图规范。
属性 | 说明 |
title |
地图的名称。 |
description |
地图描述信息。 |
extent |
地图的范围。 |
level |
地图的缩放级别。 |
center |
地图中心点。 |
baseLayer |
地图的底图信息。 |
layers |
地图的图层信息。 |
projection |
地图的投影坐标系 |
version |
地图的版本号。 |
返回的资源表述结构如下:
字段 | 类型 | 说明 |
succeed | boolean | 修改地图是否成功。 |
error | Httperror | 出错信息,如果修改地图成功,则没有本字段。 |
修改地图内容,对 WebMap 资源:http://localhost:8190/iportal/web/maps/4/map.rjson 执行 PUT 请求,发送请求体如下:
{
"version": "1.0",
"title": "Untitled Map",
"description": "",
"projection": "EPSG:3857",
"center": {
"x": 2191602.47499257,
"y": 4050551.00288805
},
"level": 2,
"extent": {
"leftBottom": {
"x": -20037508.3427892,
"y": -20037508.3427892
},
"rightTop": {
"x": 20037508.3427892,
"y": 20037508.3427892
}
},
"baseLayer": {
"layerType": "TIANDITU_VEC_3857",
"name": "Tianditu",
"labelLayerVisible": true
},
"layers": [
{
"layerType": "TILE",
"name": "China_4326",
"visible": true,
"url": "http://localhost:8080/iserver/services/map-china400/rest/maps/China_4326"
},
{
"layerType": "MARKER",
"name": "Untitled\r\nmarker layer1",
"visible": true,
"serverId": "853160733"
}
]
}
则返回的 rjson 格式响应结果如下:
{
"succeed": true
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 WebMap 资源是否存在,或者客户端是否有权限访问 WebMap 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 WebMap 资源是否支持<format>格式的表述。