Pois/round
Zhangchao2 (讨论 | 贡献) (→JSON示例) |
|||
(未显示2个用户的8个中间版本) | |||
第1行: | 第1行: | ||
− | == ''' | + | == '''pois/round''' == |
根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息 | 根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息 | ||
== '''URL''' == | == '''URL''' == | ||
− | http://api. | + | http://api.t.sina.com.cn/location/pois/round.(json|xml) |
== '''支持格式''' == | == '''支持格式''' == | ||
第12行: | 第12行: | ||
== '''是否需要登录''' == | == '''是否需要登录''' == | ||
− | ''' | + | '''true''' |
== '''请求数限制''' == | == '''请求数限制''' == | ||
'''true''' | '''true''' | ||
第27行: | 第27行: | ||
| 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 | | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 | ||
|- style="color:red" | |- style="color:red" | ||
− | |colspan=4 | | + | |colspan=4 | 注意:以下两个参数至少填一个 |
|- | |- | ||
| style="text-align:center;" |q | | style="text-align:center;" |q | ||
第39行: | 第39行: | ||
| 查询poi分类代码(详见[[Location/category|分类代码对照表]]) | | 查询poi分类代码(详见[[Location/category|分类代码对照表]]) | ||
|- style="color:red" | |- style="color:red" | ||
− | |colspan=4 | | + | |colspan=4 | 注意:以下两个参数选填一个 |
|- | |- | ||
| style="text-align:center;" |coordinate | | style="text-align:center;" |coordinate | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |string |
− | | | + | | 搜索中心点坐标(经纬度用逗号分隔。若只有坐标,则输出不含中心点poi信息) |
|- | |- | ||
| style="text-align:center;" |pid | | style="text-align:center;" |pid | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |string |
| 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息) | | 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息) | ||
|- style="color:red" | |- style="color:red" | ||
第55行: | 第55行: | ||
| style="text-align:center;" |dr | | style="text-align:center;" |dr | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |float |
| 搜索半径,最大为500,默认为500。 | | 搜索半径,最大为500,默认为500。 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| style="text-align:center;" |city | | style="text-align:center;" |city | ||
第73行: | 第68行: | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
| style="text-align:center;" |int | | style="text-align:center;" |int | ||
− | | | + | | 返回的首条结果在结果集中的页码(默认为1,最大为40) |
|- | |- | ||
| style="text-align:center;" |count | | style="text-align:center;" |count | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
| style="text-align:center;" |int | | style="text-align:center;" |int | ||
− | | | + | | 返回的结果集中每页的结果数(默认为10,最大为50) |
|} | |} | ||
第86行: | 第81行: | ||
<pre> | <pre> | ||
<?xml version="1.0" encoding="utf-8" ?> | <?xml version="1.0" encoding="utf-8" ?> | ||
− | <geoSearchResult | + | <geoSearchResult> |
− | + | ||
<total>6</total> | <total>6</total> | ||
<count>2</count> | <count>2</count> | ||
第96行: | 第90行: | ||
<name>颐和园</name> | <name>颐和园</name> | ||
<address>北京市海淀区颐和园路21号</address> | <address>北京市海淀区颐和园路21号</address> | ||
− | <category>110201</category> | + | <category>110201</category> |
+ | <navigator>世界遗产</navigator> | ||
<telephone>010-62881144</telephone> | <telephone>010-62881144</telephone> | ||
<pic_url>mapabcpic/db7282901da891bea2fcd73840caad1c-1252980038.bmp</pic_url> | <pic_url>mapabcpic/db7282901da891bea2fcd73840caad1c-1252980038.bmp</pic_url> | ||
第135行: | 第130行: | ||
"address":"\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u9890\u548c\u56ed\u8def21\u53f7", | "address":"\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u9890\u548c\u56ed\u8def21\u53f7", | ||
"category":"110201", | "category":"110201", | ||
+ | "navigator":"\u6751\u5e84\u7ea7\u5730\u540d", | ||
"telphone":"010-62881144", | "telphone":"010-62881144", | ||
"pic_url":"mapabcpic\/db7282901da891bea2fcd73840caad1c-1252980038.bmp", | "pic_url":"mapabcpic\/db7282901da891bea2fcd73840caad1c-1252980038.bmp", | ||
"longitude":"116.2739", | "longitude":"116.2739", | ||
− | "latitude":"39.99957"}}, | + | "latitude":"39.99957" |
− | "pois": | + | } |
+ | }, | ||
+ | "pois": | ||
[{ | [{ | ||
"pid":"P010A00D46N", | "pid":"P010A00D46N", | ||
第145行: | 第143行: | ||
"address":"\u9752\u9f99\u6865\u4e1c\u88571\u53f7\u5e73\u623f", | "address":"\u9752\u9f99\u6865\u4e1c\u88571\u53f7\u5e73\u623f", | ||
"category":"100200","navigator":"\u65c5\u9986\u62db\u5f85\u6240", | "category":"100200","navigator":"\u65c5\u9986\u62db\u5f85\u6240", | ||
+ | "navigator":"\u6751\u5e84\u7ea7\u5730\u540d", | ||
"telephone":"010-62876066", | "telephone":"010-62876066", | ||
"pic_url":"", | "pic_url":"", | ||
第156行: | 第155行: | ||
=== '''字段说明 ''' === | === '''字段说明 ''' === | ||
− | |||
:total:结果总数 | :total:结果总数 | ||
:count:本页返回的结果数 | :count:本页返回的结果数 | ||
第163行: | 第161行: | ||
::pid:中心点的poi_id(全局id) | ::pid:中心点的poi_id(全局id) | ||
::category:中心点的类别代码 | ::category:中心点的类别代码 | ||
+ | ::navigator:中心点的分类导航名称 | ||
::name:中心点的名称 | ::name:中心点的名称 | ||
::address:中心点的地址 | ::address:中心点的地址 | ||
第174行: | 第173行: | ||
::address:poi点的地址 | ::address:poi点的地址 | ||
::category:poi点的分类 | ::category:poi点的分类 | ||
− | :: | + | ::navigator:poi点的分类导航名称 |
::telephone:poi点的电话 | ::telephone:poi点的电话 | ||
::pic_url:poi点的图片地址 | ::pic_url:poi点的图片地址 | ||
::longitude:poi点的经度 | ::longitude:poi点的经度 | ||
::latitude:poi点的纬度 | ::latitude:poi点的纬度 | ||
− | |||
− | == ''' | + | == '''其它''' == |
+ | |||
+ | === '''PHP示例''' === | ||
+ | 需要开启PHP的cURL扩展 | ||
<pre> | <pre> | ||
− | + | <?php | |
− | + | //改为你的微博账号,用户名和密码之间用:隔开 | |
− | + | $userPwd = 'user@sina.com:pwd'; | |
+ | //改为你微博应用的appkey | ||
+ | $appkey = '0123456789'; | ||
+ | //查询关键词 | ||
+ | $q = urlencode("123"); | ||
− | + | $url = "http://api.t.sina.com.cn/location/pois/round.xml?coordinate=116.36993,39.97646&q=$q&city=0010&source=$appkey"; | |
− | + | ||
− | http://api. | + | $rst = curlSample($url,$userPwd); |
+ | |||
+ | echo $rst; | ||
+ | |||
+ | function curlSample($url,$userPwd,$postFields = '',$header = ''){ | ||
+ | $ch = curl_init() or die (curl_error()) ; | ||
+ | curl_setopt($ch,CURLOPT_URL,$url); | ||
+ | curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); | ||
+ | curl_setopt($ch,CURLOPT_TIMEOUT,30); | ||
+ | if(!empty($userPwd)){ | ||
+ | curl_setopt($ch,CURLOPT_USERPWD,$userPwd); | ||
+ | } | ||
+ | if(!empty($postFields)){ | ||
+ | curl_setopt($ch,CURLOPT_POST,true); | ||
+ | curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields); | ||
+ | } | ||
+ | if(!empty($header)){ | ||
+ | curl_setopt($ch, CURLOPT_HTTPHEADER,$header); | ||
+ | } | ||
+ | $result = curl_exec($ch) or die (curl_error($ch)); | ||
+ | curl_close($ch); | ||
+ | return $result; | ||
+ | } | ||
+ | ?> | ||
</pre> | </pre> |
2012年9月24日 (一) 11:49的最后版本
目录 |
pois/round
根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息
URL
http://api.t.sina.com.cn/location/pois/round.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
请求数限制
true
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
注意:以下两个参数至少填一个 | |||
q | false | string | 查询的关键字 |
category | false | string | 查询poi分类代码(详见分类代码对照表) |
注意:以下两个参数选填一个 | |||
coordinate | false | string | 搜索中心点坐标(经纬度用逗号分隔。若只有坐标,则输出不含中心点poi信息) |
pid | false | string | 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息) |
注意:以下参数选填 | |||
dr | false | float | 搜索半径,最大为500,默认为500。 |
city | false | string | 城市代码(不填城市代码,默认在全国搜索,详见城市代码对照表) |
注意:结果最多只返回50条记录,若有其他需求请及时与我们取得联系 | |||
page | false | int | 返回的首条结果在结果集中的页码(默认为1,最大为40) |
count | false | int | 返回的结果集中每页的结果数(默认为10,最大为50) |
返回结果
XML示例
<?xml version="1.0" encoding="utf-8" ?> <geoSearchResult> <total>6</total> <count>2</count> <page>1</page> <center_poi> <poi> <pid>B000A7O1CU</pid> <name>颐和园</name> <address>北京市海淀区颐和园路21号</address> <category>110201</category> <navigator>世界遗产</navigator> <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> </poi> ... </pois> </geoSearchResult>
JSON示例
{ "result":"1", "total":"6", "count":"2", "page":"1", "center_poi": { "poi": { "pid":"B000A7O1CU", "name":"\u9890\u548c\u56ed", "address":"\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u9890\u548c\u56ed\u8def21\u53f7", "category":"110201", "navigator":"\u6751\u5e84\u7ea7\u5730\u540d", "telphone":"010-62881144", "pic_url":"mapabcpic\/db7282901da891bea2fcd73840caad1c-1252980038.bmp", "longitude":"116.2739", "latitude":"39.99957" } }, "pois": [{ "pid":"P010A00D46N", "name":"\u8001\u516b\u65d7\u8425\u996e\u98df", "address":"\u9752\u9f99\u6865\u4e1c\u88571\u53f7\u5e73\u623f", "category":"100200","navigator":"\u65c5\u9986\u62db\u5f85\u6240", "navigator":"\u6751\u5e84\u7ea7\u5730\u540d", "telephone":"010-62876066", "pic_url":"", "longitude":"116.27088", "latitude":"40.00284" }, ... ] }
字段说明
- total:结果总数
- count:本页返回的结果数
- page:本页返回的首条结果在结果集中的页码
- center_poi:中心点的信息(用id和city查询时返回,用xy作为中心点参数时,不返回center_poi信息)
- pid:中心点的poi_id(全局id)
- category:中心点的类别代码
- navigator:中心点的分类导航名称
- name:中心点的名称
- address:中心点的地址
- telephone:中心点的电话
- pic_url:中心点的图片地址
- longitude:中心点的经度
- latitude:中心点的纬度
- pois:结果poi集
- pid:本条poi记录的id
- title:poi点名称
- address:poi点的地址
- category:poi点的分类
- navigator:poi点的分类导航名称
- telephone:poi点的电话
- pic_url:poi点的图片地址
- longitude:poi点的经度
- latitude:poi点的纬度
其它
PHP示例
需要开启PHP的cURL扩展
<?php //改为你的微博账号,用户名和密码之间用:隔开 $userPwd = 'user@sina.com:pwd'; //改为你微博应用的appkey $appkey = '0123456789'; //查询关键词 $q = urlencode("123"); $url = "http://api.t.sina.com.cn/location/pois/round.xml?coordinate=116.36993,39.97646&q=$q&city=0010&source=$appkey"; $rst = curlSample($url,$userPwd); echo $rst; function curlSample($url,$userPwd,$postFields = '',$header = ''){ $ch = curl_init() or die (curl_error()) ; curl_setopt($ch,CURLOPT_URL,$url); curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); curl_setopt($ch,CURLOPT_TIMEOUT,30); if(!empty($userPwd)){ curl_setopt($ch,CURLOPT_USERPWD,$userPwd); } if(!empty($postFields)){ curl_setopt($ch,CURLOPT_POST,true); curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields); } if(!empty($header)){ curl_setopt($ch, CURLOPT_HTTPHEADER,$header); } $result = curl_exec($ch) or die (curl_error($ch)); curl_close($ch); return $result; } ?>
文档更新时间: 2012-09-24