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 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
到 帮助中心 查看更多问题或提问