location/pois/search/by_area
根据关键词按矩形区域获取POI点的信息
URL
https://api.weibo.com/2/location/pois/search/by_area.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| q | false | string | 查询的关键词，必须进行URLencode，与category参数必选其一。 |
| category | false | string | 查询的分类代码，与q参数必选其一，取值范围见：分类代码对应表。 |
| coordinates | true | string | 查询的矩形区域坐标，第一个坐标为左上角的点，第二个为右下角，经度纬度用逗号分隔，坐标间用“|”分隔，示例：coordinates=116.37,39.93|116.43,39.91。 |
| city | false | string | 城市代码，默认为全国搜索。 |
| page | false | int | 返回结果的页码，默认为1，最大为40。 |
| count | false | int | 单页返回的记录条数，默认为10，最大为20。 |
注意事项
通过该接口获取到的poi信息，不适用于Place系列的位置服务。如需使用Place系列定位服务，建议使用place/nearby/pois接口或place/nearby/pois接口获取poiid。
调用样例及调试工具
返回结果
JSON示例
{
"coordinates": "116.37,39.93|116.43,39.91",
"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
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2014-02-21
