(创建新页面为 '{{api_desc_v2| uri=location/pois/search/by_geo| desc=根据关键词按坐标点范围获取POI点的信息| httpMethod=GET| needAuth=是| level={{Api_L1}}| rateLimit=是| param…') |
|||
| 第15行： | 第15行： | ||
{{api_args|page|false|int|返回结果的页码，默认为1，最大为40。}} | {{api_args|page|false|int|返回结果的页码，默认为1，最大为40。}} | ||
{{api_args|count|false|int|单页返回的记录条数，默认为10，最大为20。}}| | {{api_args|count|false|int|单页返回的记录条数，默认为10，最大为20。}}| | ||
| + | apiToolPara=key1=q&value1=理想国际大厦&key2=coordinate&value2=116.322479,39.980781| | ||
result= | result= | ||
<pre> | <pre> | ||
2012年9月4日 (二) 18:51的版本
location/pois/search/by_geo
根据关键词按坐标点范围获取POI点的信息
URL
https://api.weibo.com/2/location/pois/search/by_geo.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| q | false | string | 查询的关键词，必须进行URLencode，与category参数必选其一。 |
| category | false | string | 查询的分类代码，与q参数必选其一，取值范围见：分类代码对应表。 |
| coordinate | false | string | 查询的中心点坐标，经度纬度用逗号分隔，与pid参数必选其一，pid优先。 |
| pid | false | string | 查询的中心点POI的ID，与coordinate参数必选其一，pid优先。 |
| city | false | string | 城市代码，默认为全国搜索。 |
| range | false | string | 查询范围半径，默认为500，最大为500。 |
| page | false | int | 返回结果的页码，默认为1，最大为40。 |
| count | false | int | 单页返回的记录条数，默认为10，最大为20。 |
注意事项
无
调用样例及调试工具
返回结果
JSON示例
{
"center_poi": {
"pid": "P010A00CHR9",
"longitude": "116.39794",
"latitude": "39.90817",
"name": "理想国际大厦",
"city_name": "北京",
"province_name": "北京",
"address": "北四环西路58号",
"telephone": "62670000",
"category": "110201",
"navigator": "写字楼",
"pic_url": "http://sinaimg/34759324759.jpg"
},
"pois": [
{
"pid": "P010A00CHR9",
"longitude": "116.39794",
"latitude": "39.90817",
"name": "理想国际大厦",
"city_name": "北京",
"province_name": "北京",
"address": "北四环西路58号",
"telephone": "62670000",
"category": "110201",
"navigator": "写字楼",
"pic_url": "http://sinaimg/34759324759.jpg"
},
...
],
"total_number": 36
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
