微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
== '''周边搜索''' == 根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息 == '''URL''' == http://api.t.sina.com.cn/pois/round.(json|xml) == '''支持格式''' == '''XML/JSON''' == '''HTTP请求方式''' == '''GET''' == '''是否需要登录''' == '''false''' == '''请求数限制''' == '''true''' == '''请求参数''' == {| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0" ! style="text-align:center;width:20%;" |参数 ! style="text-align:center;width:10%" |必选 ! style="text-align:center;width:20%" |类型及范围 ! style="text-align:center;width:50%" |说明 |- style="height:px" | style="text-align:center;" |source | style="text-align:center;" |true | style="text-align:center;" |string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |- style="color:red" |colspan=4 | 注意:以下参数至少填一个 |- | style="text-align:center;" |q | style="text-align:center;" |false | style="text-align:center;" |string | 查询的关键字 |- | style="text-align:center;" |category | style="text-align:center;" |false | style="text-align:center;" |string | 查询poi分类代码(详见[[Location/category|分类代码对照表]]) |- style="color:red" |colspan=4 | 注意:以下参数选填一个 |- | style="text-align:center;" |coordinate | style="text-align:center;" |false | style="text-align:center;" |float | 搜索中心点坐标(用逗号分隔。若只有坐标,则输出不含中心点poi信息) |- | style="text-align:center;" |pid | style="text-align:center;" |false | style="text-align:center;" |int | 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息) |- style="color:red" |colspan=4 | 注意:以下参数选填 |- | style="text-align:center;" |dr | style="text-align:center;" |false | style="text-align:center;" |int | 搜索半径,最大为500,默认为500。 |- | style="text-align:center;" |sign | style="text-align:center;" |false | style="text-align:center;" |string | 返回值查询关键词标红(y或n,默认为n) |- | style="text-align:center;" |city | style="text-align:center;" |false | style="text-align:center;" |string | 城市代码(不填城市代码,默认在全国搜索,详见[[Location/citycode|城市代码对照表]]) |- style="color:red" |colspan=4 | 注意:结果最多只返回50条记录,若有其他需求请及时与我们取得联系 |- | style="text-align:center;" |page | style="text-align:center;" |false | style="text-align:center;" |int | 返回的首条结果在结果集中的页码(默认为1,最大为10) |- | style="text-align:center;" |count | style="text-align:center;" |false | style="text-align:center;" |int | 返回的结果集中每页的结果数(默认为20,最大为50) |} == '''返回结果''' == === '''XML示例''' === <pre> <?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> </pre> === '''JSON示例''' === <pre> { "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"} ] } </pre> === '''字段说明 ''' === :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点是否可以查询公交 == '''使用示例''' == <pre> 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 </pre>
返回到
Pois/round
。
反馈
分享
顶部