stopListByKeyword

URI

<transferNetwork_uri>/keyword/{stopKeyword}[.<format>]

支持的方法

GET、HEAD

父资源

stops

介绍

根据传入的关键词进行公交站点查询，返回名称与关键词相关的公交站点。

支持的方法：

支持的表述格式：rjson、json、html、xml。

资源层次

root.htm trafficTransferAnalyst.htm transferNetwork.htm keyword.htm stops.htm

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/traffictransferanalyst-sample/restjsr/traffictransferanalyst/Traffic-Changchun/stops/keyword/人民.rjson

GET 请求

获取名称与关键词相关的公交站点。

请求参数

名称 类型 含义
returnPosition boolean 是否返回站点的坐标信，默认为 false，即不返回坐标信息。

 

响应结构

返回满足条件的站点数组， 每个站点的对应的类为TransferStopInfo，包含以下字段：

字段 类型 说明
alias String 公交站点别名。
id int 公交站点 ID。
name String 公交站点名称。
position Point2D 公交站点坐标。
stopID long 公交站点 ID，对应服务提供者配置中的 stopIDField。

响应示例

对以下地址执行 GET 请求：

http://supermapiserver:8090/iserver/services/traffictransferanalyst-sample/restjsr/traffictransferanalyst/Traffic-Changchun/stops/keyword/人民.rjson?returnPosition=false

则返回的 rjson 格式表述如下：

[{

  "alias": null,

  "id": 164,

  "name": "人民广场",

  "position": null,

  "stopID": 164

}]

HEAD 请求

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

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

请参见