WebMap


URI

<map_uri_>/map[.<format>]

支持的方法

GETPUTHEAD

父资源

map

介绍

WebMap 资源是地图的内容资源。

支持的方法:

支持的表述格式:RJSON、JSON。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。

http://supermapiportal:8190/iportal/web/maps/{id}/map.rjson

GET 请求

获取指定地图的内容。

响应结构

对 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"

}

PUT 请求

修改指定地图的内容。

请求参数

发送请求时,需要在请求体中传递符合 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

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 WebMap 资源是否存在,或者客户端是否有权限访问 WebMap 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 WebMap 资源是否支持<format>格式的表述。

请参见