Pois/round
Zhangchao2 (讨论 | 贡献) (→XML示例) |
Zhangchao2 (讨论 | 贡献) (→XML示例) |
||
| 第101行： | 第101行： | ||
<longitude>116.2739</longitude> | <longitude>116.2739</longitude> | ||
<latitude>39.99957</latitude> | <latitude>39.99957</latitude> | ||
| − | + | </poi> | |
</center_poi> | </center_poi> | ||
<pois> | <pois> | ||
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
