交通地理信息服务REST服务接口调用方法

1、DB32/T 3572-2019BB附录B（资料性附录）交通地理信息服务REST服务接口调用方法B.1REST服务地址描述交通地理信息服务REST服务的地址为：http:/域名或 IP: 端口号 /component.<format>其中“ component ”为服务类型标识名称。根据交通运输业务特点，交通地理信息服务可分为地图服务、数据服务、空间分析服务和路径分析服务，其标识名称和对应地址如表B.1 所示：表 B.1交通地理信息服务REST服务地址表服务类型服务类型标识名称服务地址地图服务maphttp:/域名或 IP: 端口号 /map.<format>数据服务d

2、atahttp:/域名或 IP: 端口号 /data.<format>空间分析服务spatialanalysthttp:/域名或 IP: 端口号 /spatialanalyst.<format>路径分析服务transportationAnalysthttp:/域名或 IP: 端口号 /transportationAnalyst.<format>B.2REST服务接口描述地图服务 REST服务接口服务地址：http:/域名或 IP: 端口号 /map/mapName.<format>；地图资源由具体的地图名称“mapName”来标识，地图名称可以是

3、中文。请求参数：服务地址中，支持传递的参数如表B.2 所示：表 B.2地图服务REST服务请求参数表名称类型含义cacheboolean【可选参数】是否使用缓存。prjCoordSysPrjCoordSys【可选参数】用于指定请求地图的坐标参考系统。响应结构：对地图资源执行请求，返回的资源表述的结构如表B.3 所示：表 B.3地图服务REST服务响应结构表16DB32/T 3572-2019字段类型说明nameString当前地图的名称。centerPoint2D地图显示的中心点。scaledouble地图的显示比例尺。maxScaledouble地图的最大显示比例尺。minScaledoub

4、le地图的最小显示比例尺。boundsRectangle2D地图的全幅地理范围。prjCoordSysPrjCoordSys返回当前地图的坐标参考系统。B.2.2 数据服务 REST服务接口服务地址：http:/ 域名或 IP: 端口号 /data.rjson请求参数：对服务资源执行POST请求，对数据进行查询，需传递参数如表B.4 所示：表 B.4 数据服务 REST服务请求参数表名称类型含义returnContentbooleantrue 表示直接返回查询结果，默认不传时为 false 。fromIndexint查询结果的最小索引号。toIndexint查询结果的最大索引号。getFeat

5、ureModeGetFeatureMode【必选参数】数据查询的模式。datasetNamesString【必选参数】数据集名称数组。idsint要获取的资源的 ID 数组。boundsRectangle2D进行范围查询时， 需要设置的矩形坐标范围。geometryGeometry几何对象。bufferDistancedouble缓冲区半径，单位和数据集坐标单位一致。attributeFilterString属性查询过滤器。spatialQueryModeSpatialQueryMode空间查询模式。queryParameterQueryParameter查询参数。响应结构：对服务资源执行PO

6、ST请求，返回的创建结果的结构如表B.5所示：表 B.5数据服务REST服务响应结构表17DB32/T 3572-2019名称类型含义IDint要素的 ID 。fieldNamesString要素的属性字段名集合。fieldValuesString要素的属性字段值集合。geometryGeometry要素对应的几何对象。B.2.3 空间分析服务 REST服务接口服务地址：http:/域名或 IP: 端口号 /spatialanalyst.rjson请求参数：服务地址中的请求参数如表B.6 所示：表 B.6 空间分析服务REST服务请求参数名称类型含义asynchronousReturnbool

7、ean是否采用异步操作。returnContentboolean是否立即返回新创建资源的表述还是返回新资源的 URI 。sourceGeometryGeometry源几何对象数据，即被操作几何对象。operateGeometryGeometry操作几何对象数据， 数据类型为面状几何对象数据。operationString叠加操作，可选值为 clip（裁剪）、erase （擦除）、 identity（同一）、intersect （相交）、 union （合并）、update （更新）、 XOR（对称差）。响应结构：对资源执行 POST请求后，响应参数如表 B.7所示：表 B.7 空间分析服务RE

8、ST服务响应结构表字段类型说明succeedboolean查询是否成功。newResourceIDString分析结果资源的ID 。postResultTypePostResultTypePOST 请求的结果类型。newResourceLocationString创建的新资源的URI 。B.2.4 路径分析服务 REST服务接口服务地址：http:/ 域名或 IP: 端口号 /transportationAnalyst.rjson请求参数：对资源执行请求，服务地址中需包含的参数如表B.8 所示：18DB32/T 3572-2019表 B.8路径分析服务REST服务请求参数表名称类型含义nodesint/Point2D【必选参数】进行最佳路径分析的点集合。hasLeastEdgeCountboolean是否按弧段数最少的模式查询。parameterTransportat