Pois/keyword
目录 |
关键字搜索
根据关键字和（或）分类进行搜索，返回相关的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" ?>
<geoSearchResult>
<result>1</result>
<total>695</total>
<count>2</count>
<page>1</page>
<pois>
<poi>
<pid>P010A00CHR9</pid>
<name>123烤鸡翅</name>
<address>石景山区石景山路22号长城大厦附近</address>
<category>50000</category>
<navigator>餐饮相关</navigator>
<telephone />
<pic_url />
<longitude>116.22074</longitude>
<latitude>39.90652</latitude>
<bus>1</bus>
</poi>
...
</pois>
</geoSearchResult>
JSON示例
{
"result":"1",
"total":"695",
"count":"2",
"page":"1",
"pois":
[{
"pid":"P010A00CHR9",
"name":"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"},
...
]
}
字段说明
- result：是否有结果（0为没有搜索到结果，1为有搜索结果）
- total：结果总数
- count：本页返回的结果数
- page：返回的首条结果在结果集中的页码
- pois：结果poi集
- pid：本条poi记录的id
- name：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
