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":"", //错误信息
}
其他
无
文档更新时间: 2011-05-26
