Pois/round
Zhangchao2 (讨论 | 贡献) (→请求参数) |
Zhangchao2 (讨论 | 贡献) (→请求参数) |
||
| 第43行： | 第43行： | ||
| 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信息） | | 搜索中心点坐标（用逗号分隔。若只有坐标，则输出不含中心点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" | ||
2011年4月19日 (二) 13:23的版本
目录 |
周边搜索
根据关键字和（或）分类，在中心点附近搜索，返回相关的poi点信息
URL
http://api.map.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 | string | 搜索中心点坐标（用逗号分隔。若只有坐标，则输出不含中心点poi信息） |
| pid | false | string | 搜索中心点的pid（若填此项会覆盖coordinate参数，此时输出会有中心点poi信息） |
| 注意：以下参数选填 | |||
| dr | false | int | 搜索半径，最大为500，默认为500。 |
| sign | false | string | 返回值查询关键词标红（y或n，默认为n） |
| city | false | string | 城市代码（不填城市代码，默认在全国搜索，详见城市代码对照表） |
| 注意：结果最多只返回40条记录，若有其他需求请及时与我们取得联系 | |||
| page | false | int | 返回的首条结果在结果集中的页码（默认为1，最大为10） |
| count | false | int | 返回的结果集中每页的结果数（默认为20，最大为40） |
返回结果
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>
</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",
"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",
"telephone":"010-62876066",
"pic_url":"",
"longitude":"116.27088",
"latitude":"40.00284"
},
...
]
}
字段说明
- result：是否有结果（0为没有搜索到结果，1为有搜索结果）
- total：结果总数
- count：本页返回的结果数
- page：本页返回的首条结果在结果集中的页码
- center_poi：中心点的信息（用id和city查询时返回，用xy作为中心点参数时，不返回center_poi信息）
- pid：中心点的poi_id（全局id）
- category：中心点的类别代码
- 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点的纬度
使用示例
xml: http://api.map.sina.com.cn/pois/round.xml?pid=P010A00D46N&q=1&source=appkey http://api.map.sina.com.cn/pois/round.xml?coordinate=116.354,39.889&q=1&source=appkey json: http://api.map.sina.com.cn/pois/round.json?pid=P010A00D46N&q=1&source=appkey http://api.map.sina.com.cn/pois/round.json?coordinate=116.354,39.889&q=1&source=appkey
