Search/geo/users
目录 |
search/geo/users
获取指定地点周边的用户列表。
URL
http://api.t.sina.com.cn/search/geo/users.(json)
支持格式
json
HTTP请求方式
GET
是否需要登录
是
关于授权机制,参见授权机制声明
请求数限制
是
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
longitude | true | float | 经度。有效范围:-180.0到+180.0,+表示东经。 |
latitude | true | float | 纬度。有效范围:-90.0到+90.0,+表示北纬。 |
range | false | int | 搜索范围,单位米,默认500米,最大11132米 |
time | false | int | 返回结果所在的时间段。单位为分钟;指从现在开始之前的时间段 |
sort_type | false | int | 排序方式。默认为0,按时间排序;为1时按与中心点距离进行排序 |
page | false | int | 返回结果页码。默认为1. |
count | false | int | 每页结果数。默认10.最大50 |
base_app | false | int | 是否根据当前应用返回接口。默认0:全部应用;1:仅限当前应用 |
调用示例
- json
- curl -u "username:password" "http://api.t.sina.com.cn/search/geo/users.json?source=appkeylongitude=&latitude="
注意事项
返回结果
JSON示例
//成功返回 { "users":[ { "id": 1790421285, "screen_name": "api重构", "name": "api重构", "province": "11", "city": "7", "location": "北京 石景山区", "description": "mtime", "url": "http://www.sohu.com", "profile_image_url": "http://tp2.sinaimg.cn/1790421285/50/1294124301/1", "domain": "cityhaha", "gender": "m", "followers_count": 122, "friends_count": 22, "statuses_count": 401, "favourites_count": 11, "created_at": "Mon Aug 09 00:00:00 +0800 2010", "following": false, "allow_all_act_msg": true, "geo_enabled": true, "verified": false, "status": { "created_at": "Mon Mar 14 17:16:14 +0800 2011", "id": 7499821111, "text": "最熟悉的陌生人:影视中的外星人造型进化史 http://sinaurl.cn/htDtTw", "source": "<a href=\"http://news.mtime.com\" rel=\"nofollow\">Mtime时光网</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "201110314107099305", "annotations": [ ] } }, { "id": 1790421285, "screen_name": "api重构", "name": "api重构", "province": "11", "city": "7", "location": "北京 石景山区", "description": "mtime", "url": "http://www.sohu.com", "profile_image_url": "http://tp2.sinaimg.cn/1790421285/50/1294124301/1", "domain": "cityhaha", "gender": "m", "followers_count": 122, "friends_count": 22, "statuses_count": 401, "favourites_count": 11, "created_at": "Mon Aug 09 00:00:00 +0800 2010", "following": false, "allow_all_act_msg": true, "geo_enabled": true, "verified": false, "status": { "created_at": "Mon Mar 14 17:16:14 +0800 2011", "id": 7499821111, "text": "最熟悉的陌生人:影视中的外星人造型进化史 http://sinaurl.cn/htDtTw", "source": "<a href=\"http://news.mtime.com\" rel=\"nofollow\">Mtime时光网</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "201110314107099305", "annotations": [ ] } } ], "total_number":100 } //失败返回: JSON:(失败) { "request":"" //调用地址 "error_code":"400", //错误代码 "error":"", //错误信息 }
其他
无