Pois/keyword
Zhangchao2 (讨论 | 贡献) (→请求参数) |
Zhangchao2 (讨论 | 贡献) (→请求参数) |
||
第45行: | 第45行: | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
− | | 城市代码(不填城市代码,默认在全国搜索,详见[[ | + | | 城市代码(不填城市代码,默认在全国搜索,详见[[location/citycode|城市代码对照表]]) |
|- style="color:red" | |- style="color:red" | ||
|colspan=4 | 注意:一次调用最多只返回50条记录,若有其他需求请及时与我们取得联系 | |colspan=4 | 注意:一次调用最多只返回50条记录,若有其他需求请及时与我们取得联系 |
2011年3月23日 (三) 12:56的版本
目录 |
关键字搜索
根据关键字和(或)分类进行搜索,返回相关的poi点信息。
URL
http://api.t.sina.com.cn/pois/keyword.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
false
请求数限制
true
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
q | true | string | 查询的关键字 |
category | false | string | 查询poi分类代码(详见分类代码对应表) |
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" ?> <xml> <result>1</result> <total>695</total> <count>2</count> <page>1</page> <list> <item> <pid>P010A00CHR9</pid> <title>123烤鸡翅</title> <address>石景山区石景山路22号长城大厦附近</address> <category>50000</category> <navigator>餐饮相关</navigator> <telephone /> <pic_url /> <longitude>116.22074</longitude> <latitude>39.90652</latitude> <bus>1</bus> </item> <item> <pid>P010A00CGSY</pid> <title>123小炒馆</title> <address>丰台区丰桥路食尚街</address> <category>50000</category> <navigator>餐饮相关</navigator> <telephone /> <pic_url /> <longitude>116.30636</longitude> <latitude>39.84985</latitude> <bus>1</bus> </item> </list> </xml>
JSON示例
{ "result":"1", "total":"695", "count":"2", "page":"1", "list": [{ "pid":"P010A00CHR9", "title":"123\u70e4\u9e21\u7fc5", "addr":"\u77f3\u666f\u5c71\u533a\u77f3\u666f\u5c71\u8def22\u53f7\u957f\u57ce\u5927\u53a6\u9644\u8fd1", "category":"50000", "navigator":"\u9910\u996e\u76f8\u5173", "tel":"", "pic_url":"", "longitude":"116.22074", "latitude":"39.90652", "bus":"1"}, { "pid":"P010A00CGSY", "title":"123\u5c0f\u7092\u9986", "addr":"\u4e30\u53f0\u533a\u4e30\u6865\u8def\u98df\u5c1a\u8857", "category":"50000", "navigator":"\u9910\u996e\u76f8\u5173", "tel":"", "pic_url":"", "longitude":"116.30636", "latitude":"39.84985", "bus":"1"} ] }
字段说明
- result:是否有结果(0为没有搜索到结果,1为有搜索结果)
- total:结果总数
- count:本页返回的结果数
- page:返回的首条结果在结果集中的页码
- 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/keyword.xml?q=123&city=0010&source=appkey json: http://api.t.sina.com.cn/pois/keyword.json?q=123&city=0010&source=appkey