Pois/round
Zhangchao2 (讨论 | 贡献) (→XML示例) |
Zhangchao2 (讨论 | 贡献) (→XML示例) |
||
第93行: | 第93行: | ||
<center_poi> | <center_poi> | ||
<poi> | <poi> | ||
− | + | <pid>B000A7O1CU</pid> | |
− | + | <name>颐和园</name> | |
− | + | <address>北京市海淀区颐和园路21号</address> | |
− | + | <category>110201</category> | |
− | + | <telephone>010-62881144</telephone> | |
− | + | <pic_url>mapabcpic/db7282901da891bea2fcd73840caad1c-1252980038.bmp</pic_url> | |
− | + | <longitude>116.2739</longitude> | |
− | + | <latitude>39.99957</latitude> | |
</poi> | </poi> | ||
</center_poi> | </center_poi> |
2011年3月23日 (三) 13:12的版本
目录 |
周边搜索
根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息
URL
http://api.t.sina.com.cn/pois/round.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
false
请求数限制
true
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
注意:以下参数至少填一个 | |||
q | false | string | 查询的关键字 |
category | false | string | 查询poi分类代码(详见分类代码对照表) |
注意:以下参数选填一个 | |||
coordinate | false | float | 搜索中心点坐标(用逗号分隔。若只有坐标,则输出不含中心点poi信息) |
pid | false | int | 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息) |
注意:以下参数选填 | |||
dr | false | int | 搜索半径,最大为500,默认为500。 |
sign | false | string | 返回值查询关键词标红(y或n,默认为n) |
city | false | string | 城市代码(不填城市代码,默认在全国搜索,详见城市代码对照表) |
注意:结果最多只返回50条记录,若有其他需求请及时与我们取得联系 | |||
page | false | int | 返回的首条结果在结果集中的页码(默认为1,最大为10) |
count | false | int | 返回的结果集中每页的结果数(默认为20,最大为50) |
返回结果
XML示例
<?xml version="1.0" encoding="utf-8" ?> <geoSearchResult> <result>1</result> <total>6</total> <count>2</count> <page>1</page> <center_poi> <poi> <pid>B000A7O1CU</pid> <name>颐和园</name> <address>北京市海淀区颐和园路21号</address> <category>110201</category> <telephone>010-62881144</telephone> <pic_url>mapabcpic/db7282901da891bea2fcd73840caad1c-1252980038.bmp</pic_url> <longitude>116.2739</longitude> <latitude>39.99957</latitude> </poi> </center_poi> <pois> <poi> <pid>P010A00D46N</pid> <name>老八旗营饮食</name> <address>青龙桥东街1号平房</address> <category>100200</category> <navigator>旅馆招待所</navigator> <telephone>010-62876066</telephone> <pic_url /> <longitude>116.27088</longitude> <latitude>40.00284</latitude> <bus>1</bus> </poi> ... </pois> </geoSearchResult>
JSON示例
{ "result":"1", "total":"6", "count":"2", "page":"1", "center_poi": { "cp_poi_id":"B000A7O1CU", "cp_category":"110201", "cp_title":"\u9890\u548c\u56ed", "cp_addr":"\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u9890\u548c\u56ed\u8def21\u53f7", "cp_tel":"010-62881144", "cp_pic_url":"mapabcpic\/db7282901da891bea2fcd73840caad1c-1252980038.bmp", "cp_longitude":"116.2739","cp_latitude":"39.99957"}, "list": [{ "pid":"P010A00D46N", "title":"\u8001\u516b\u65d7\u8425\u996e\u98df", "address":"\u9752\u9f99\u6865\u4e1c\u88571\u53f7\u5e73\u623f", "category":"100200","navigator":"\u65c5\u9986\u62db\u5f85\u6240", "telephone":"010-62876066", "pic_url":"", "longitude":"116.27088", "latitude":"40.00284", "bus":"1"}, { "pid":"P010A00CWWJ", "title":"\u4e2d\u56fd\u94f6\u884c\u897f\u82d1\u5206\u7406\u5904", "address":"\u9890\u548c\u56ed\u5bab\u95e8\u524d\u8857\u75321\u53f7", "category":"160000", "navigator":"\u91d1\u878d\u4fdd\u9669\u673a\u6784", "telephone":"010-62882548", "pic_url":"", "longitude":"116.2739", "latitude":"39.99957", "bus":"1"} ] }
字段说明
- result:是否有结果(0为没有搜索到结果,1为有搜索结果)
- total:结果总数
- count:本页返回的结果数
- page:本页返回的首条结果在结果集中的页码
- center_poi:中心点的信息(用id和city查询时返回,用xy作为中心点参数时,不返回center_poi信息)
- cp_poi_id:中心点的poi_id(全局id)
- cp_category:中心点的类别代码
- cp_title:中心点的名称
- cp_addr:中心点的地址
- cp_tel:中心点的电话
- cp_pic_url:中心点的图片地址
- cp_longitude:中心点的经度
- cp_latitude:中心点的纬度
- list:结果poi集
- pid:本条poi记录的id
- title:poi点名称
- address:poi点的地址
- category:poi点的分类
- navigator:poi点的类别名称
- telephone:poi点的电话
- pic_url:poi点的图片地址
- longitude:poi点的经度
- latitude:poi点的纬度
- bus:该poi点是否可以查询公交
使用示例
xml: http://api.t.sina.com.cn/pois/round.xml?pid=P010A00D46N&q=1&source=appkey http://api.t.sina.com.cn/pois/round.xml?coordinate=116.354,39.889&q=1&source=appkey json: http://api.t.sina.com.cn/pois/round.json?pid=P010A00D46N&q=1&source=appkey http://api.t.sina.com.cn/pois/round.json?coordinate=116.354,39.889&q=1&source=appkey