第7行: | 第7行: | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
− | {{api_args|q|false|string| | + | {{api_args|q|false|string|查询的关键词,必须进行URLencode。}} |
− | {{api_args|coordinate|false|string| | + | {{api_args|coordinate|false|string|查询的中心点坐标,经度纬度用逗号分隔。例:116.322479,39.980781。}} |
{{api_args|cenname|false|string|中心点名称,如:理想国际大厦。}} | {{api_args|cenname|false|string|中心点名称,如:理想国际大厦。}} | ||
{{api_args|city|false|string|城市编码:支持编码和名称形式,如0010或者北京,需要进行urlencode编码,默认为全国搜索。}} | {{api_args|city|false|string|城市编码:支持编码和名称形式,如0010或者北京,需要进行urlencode编码,默认为全国搜索。}} |
2012年11月21日 (三) 10:36的版本
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。 |
coordinate | false | string | 查询的中心点坐标,经度纬度用逗号分隔。例:116.322479,39.980781。 |
cenname | false | string | 中心点名称,如:理想国际大厦。 |
city | false | string | 城市编码:支持编码和名称形式,如0010或者北京,需要进行urlencode编码,默认为全国搜索。 |
range | false | string | 查询范围半径,默认为3000。 |
page | false | int | 返回结果的页码,默认为1,最大为40。 |
count | false | int | 单页返回的记录条数,默认为10,最大为200。 |
searchtype | false | string | 查询类型:POI分类类型,需要进行urlencode编码,如:住宅小区。 |
srctype | false | string | 数据源类型,POI:基础库,BUS:公交站台。可混合查询。例如公交数据+基础库数据查询,srctype取值为“BUS:1000%2bPOI ”,代表前1000条数据为公交数据,后面为基础库数据。 |
naviflag | false | int | 航距离排序标识, 默认为0,不按照导航距离排序,如果为1将按照导航距离排序,但性能比直线距离排序差。 |
sr | false | int | 排序参数, sr为1代表按照距离排序。 |
注意事项
- 此接口为综合查询接口coordinate、cenname、q,3个参数中,选择q:为关键字查询;选择coordinate+q:根据中心点坐标查询周边poi;选择cenname+q:根据中心点关键字查询周边poi
调用样例及调试工具
返回结果
JSON示例
{ "message": "ok", "bounds": "116.310034;39.984397;116.310034;39.984397", "total": "4908", "record": "2", "cache": "false", "count": "200", "poilist": [ { "gridcode": "5916728402", "typecode": "170206", "tel": "", "newtype": "170206", "xml": "", "code": "110108", "type": "公司企业;公司;网络科技", "imageid": "0a802008042600000673", "url": "", "citycode": "010", "timestamp": "2012-09-10", "distance": "0", "buscode": "", "pguid": "B000A7JKB1", "address": "北四环西路58号理想国际大厦408", "name": "华旅信通(安游网)", "linkid": "", "match": "10", "drivedistance": "0", "srctype": "poi", "y": "39.984397", "x": "116.310034" }, { "gridcode": "5916728402", "typecode": "170206", "tel": "", "newtype": "170206", "xml": "", "code": "110108", "type": "公司企业;公司;网络科技", "imageid": "0a802008042600000673", "url": "", "citycode": "010", "timestamp": "2012-09-10", "distance": "0", "buscode": "", "pguid": "B000A7WGK6", "address": "北四环西路58号理想国际大厦705", "name": "分水(北京)科技有限公司", "linkid": "", "match": "10", "drivedistance": "0", "srctype": "poi", "y": "39.984397", "x": "116.310034" } ], "searchtime": "64", "cenpoi": { "gridcode": "5916728402", "typecode": "120201", "tel": "", "newtype": "120201", "xml": "", "code": "110108", "type": "商务住宅;楼宇;商务写字楼", "imageid": "0a802008042600000673", "url": "", "citycode": "010", "timestamp": "2012-02-14", "distance": "0", "buscode": "", "pguid": "B000A843BB", "address": "北四环西路58", "name": "理想国际大厦", "linkid": "", "match": "10", "drivedistance": "0", "srctype": "poi", "y": "39.984392", "x": "116.310026" }, "cplist": "", "pinyin": { "list": "" }, "adlist": "" }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
到 帮助中心 查看更多问题或提问