综述
本地搜索服务,可以通过url来获得本地搜索服务。接口 url符合此公式:[WEBNAME]/[服务名称]?[子服务名称][&[参数名称]=[参数数值]]*。本服务采用的服务名称为SE_LS,本文档在此后的示例采用此服务名称。
URL示例:http://[SERVER]:[PORT]/ SE_LS?st=LocalSearch&city=北京&class=2100&encoding=utf8&words=超市&area=RECT(110 30,120 40)&uid=test
详细说明请参见:本地搜索说明文档
SE_LS
描述:
此服务为SE_LS的主服务,完成了 SE_LS服务的大部分功能。
参数:
SE_LS服务的有效参数如下,关键字(包括名称、地址)、分类、空间搜索必有其一,否则服务将提示错误。
参数名称 | 含义 | 必有 | 错误处理 | 备注 |
st | 服务类型 | 是 | 取值为 LocalSearch | |
city | 城市名称 | 是 | ||
words | 关键字 | 否 | 忽略此参数 | 智能数字匹配智能全角半角匹配 |
area | 区域 | 否 | 忽略此参数 | 矩形字符串如:RECT(110 30, 120 40),则进行矩形的“空间几何搜索”。矩形坐标选左下角和右上角(经纬度坐标)。 |
class | 分类 | 否 | 出错位置之后的输入被忽略(只对于这个参数) | 分类编号,整数 |
page | 开始页数 | 否 | 忽略此参数,返回第一页 | 正整数,从1开始计数 |
pagecap | 返回信息条数 | 否 | 忽略此参数,取默认值 10 | 正整数 |
output | 输出模式 | 否 | 忽略此参数 | 支持xml和json的结果输出。默认:xml |
callback | 回调函数名 | 否 | 忽略此参数 | output=xml时,该参数无效。callback输出结果示例,假设 callback=aaa:aaa&&aaa(json的输出结果) |
示例:
http://[SERVER]:[PORT]/ SE_LS?st=LocalSearch&city=北京&class=2100&encoding=utf8&words=超市&area=RECT(110 30,120 40) &uid=test
描述:查询在北京的,经纬度范围为(110 30,120 40)内的,类型为2100的超市。
XML输出:
JSON输出: