URI

<symbols_uri>/marker/items/{marker3dID}

支持的方法

GET、HEAD

父资源

3D、symbols

介绍

三维点符号资源，表示一个具体的三维点符号。

支持的方法：

  • GET：返回一个具体的三维点符号文件。
  • HEAD：检查 symbolMarker3d 资源是否存在，或权限是否可以访问 symbolMarker3d 资源。

支持的表述格式：返回一个以符号 ID 命名的具体的三维点符号文件，无后缀。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/symbols/marker3d/items/{marker3dID}

GET 请求

返回一个具体的三维点符号。

请求参数

获取三维点符号需要传递相应的参数如下表所示：

名称 类型 含义
marker3dID int 三维点符号的 ID。
_cache boolean 【可选参数】 是否使用缓存，默认为 true。如果为 false，则关闭所有缓存。

响应示例

对 ID 为907935的三维点符号资源执行 get 请求如下：

http://localhost:8090/iserver/services/realspace-RealspaceSymbols/rest/realspace/symbols/marker3d/items/907935

则返回以三维点符号 ID 命名的二进制流文件，即当前三维点符号的 sgm 压缩包，里面包含三维点符号模型和纹理文件。

HEAD 请求

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

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

请参见