位置服务
(以“<div style="width:100%;display:table;"> 为更好的规范第三方应用的开发质量,提高用户的应用使用体验,新浪微博推出站内应用框架...”为内容创建页面) |
|||
(未显示1个用户的11个中间版本) | |||
第1行: | 第1行: | ||
− | + | ==位置服务概述== | |
− | + | 新浪微博“位置服务接口”正式上线。为第三方提供基于“位置服务”与“兴趣图谱”的多维度位置服务。新浪微博“位置服务平台”共提供六大类接口,其中普通接口21个,高级接口7个。第三方开发者现在可以通过新浪微博开放平台直接调用以上接口,完成位置应用的基础开发。 | |
− | + | ||
− | + | ||
− | + | ||
+ | ==接口详解== | ||
− | {{center| | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
− | == | + | !colspan="3" scope="col"|<span id="位置服务接口列表">位置服务接口列表</span> |
− | + | |- | |
− | + | |rowspan="6" style="text-align:center;"|动态读取接口 | |
− | + | |[[2/place/public_timeline|place/public_timeline]] | |
− | + | |获取公共的位置动态 {{Icon_adv}} | |
− | + | |- | |
− | + | |[[2/place/friends_timeline|place/friends_timeline]] | |
+ | |获取用户好友的位置动态 | ||
+ | |- | ||
+ | |[[2/place/user_timeline|place/user_timeline]] | ||
+ | |获取某个用户的位置动态 | ||
+ | |- | ||
+ | |[[2/place/poi_timeline|place/poi_timeline]] | ||
+ | |获取某个位置地点的动态 | ||
+ | |- | ||
+ | |[[2/place/nearby_timeline|place/nearby_timeline]] | ||
+ | |获取某个位置周边的动态 | ||
+ | |- | ||
+ | |[[2/place/statuses/show|place/statuses/show]] | ||
+ | |获取动态的详情 | ||
+ | |- | ||
+ | |rowspan="5" style="text-align:center;"|用户读取接口 | ||
+ | |[[2/place/users/show|place/users/show]] | ||
+ | |获取LBS位置服务内的用户信息 | ||
+ | |- | ||
+ | |[[2/place/users/checkins|place/users/checkins]] | ||
+ | |获取用户签到过的地点列表 | ||
+ | |- | ||
+ | |[[2/place/users/photos|place/users/photos]] | ||
+ | |获取用户的照片列表 | ||
+ | |- | ||
+ | |[[2/place/users/tips|place/users/tips]] | ||
+ | |获取用户的点评列表 | ||
+ | |- | ||
+ | |[[2/place/users/todos|place/users/todos]] | ||
+ | |获取用户的todo列表 {{Icon_adv}} | ||
+ | |- | ||
+ | |rowspan="6" style="text-align:center;"|地点读取接口 | ||
+ | |[[2/place/pois/show|place/pois/show]] | ||
+ | |获取地点详情 | ||
+ | |- | ||
+ | |[[2/place/pois/users|place/pois/users]] | ||
+ | |获取在某个地点签到的人的列表 | ||
+ | |- | ||
+ | |[[2/place/pois/tips|place/pois/tips]] | ||
+ | |获取地点点评列表 | ||
+ | |- | ||
+ | |[[2/place/pois/photos|place/pois/photos]] | ||
+ | |获取地点照片列表 | ||
+ | |- | ||
+ | |[[2/place/pois/search|place/pois/search]] | ||
+ | |按省市查询地点 | ||
+ | |- | ||
+ | |[[2/place/pois/category|place/pois/category]] | ||
+ | |获取地点分类 | ||
+ | |- | ||
+ | |rowspan="4" style="text-align:center;"|附近读取接口 | ||
+ | |[[2/place/nearby/pois|place/nearby/pois]] | ||
+ | |获取附近地点 | ||
+ | |- | ||
+ | |[[2/place/nearby/users|place/nearby/users]] | ||
+ | |获取附近发位置微博的人 | ||
+ | |- | ||
+ | |[[2/place/nearby/photos|place/nearby/photos]] | ||
+ | |获取附近照片 | ||
+ | |- | ||
+ | |[[2/place/nearby_users/list|place/nearby_users/list]] | ||
+ | |获取附近的人 {{Icon_adv}} | ||
+ | |- | ||
+ | |rowspan="5" style="text-align:center;"|地点写入接口 | ||
+ | |[[2/place/pois/create|place/pois/create]] | ||
+ | |添加地点 {{Icon_adv}} | ||
+ | |- | ||
+ | |[[2/place/pois/add_checkin|place/pois/add_checkin]] | ||
+ | |签到 | ||
+ | |- | ||
+ | |[[2/place/pois/add_photo|place/pois/add_photo]] | ||
+ | |添加照片 | ||
+ | |- | ||
+ | |[[2/place/pois/add_tip|place/pois/add_tip]] | ||
+ | |添加点评 | ||
+ | |- | ||
+ | |[[2/place/pois/add_todo|place/pois/add_todo]] | ||
+ | |添加todo {{Icon_adv}} | ||
+ | |- | ||
+ | |rowspan="2" style="text-align:center;"|附近写入接口 | ||
+ | |[[2/place/nearby_users/create|place/nearby_users/create]] | ||
+ | |用户添加自己的位置 {{Icon_adv}} | ||
+ | |- | ||
+ | |[[2/place/nearby_users/destroy|place/nearby_users/destroy]] | ||
+ | |用户删除自己的位置 {{Icon_adv}} | ||
+ | |} | ||
− | + | ==应用举例== | |
− | + | ===内容合作:订餐小秘书=== | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 【订餐小秘书】是一款以位置为基础向周边用户推荐美食并支持网上订餐和电话订餐的移动应用,与微博位置服务平台主要是内容合作,为微博位置服务平台(http://place.weibo.com )的位置详情页提供了大量扩展字段信息。 | |
− | + | 订餐小秘书在新浪微博位置服务平台推广展现位置及形式: | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | *1、应用推荐 | |
+ | **在新浪微博Place平台应用推荐,以焦点图、logo的形式展现,链接到订餐小秘书的官方网站,为其带来了更大的用户量。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi01.jpg}} | ||
+ | |||
+ | |||
+ | *2、位置详情页推广 | ||
+ | **将小秘书的订餐功能直接置入位置详情页,用户可直接由位置页通过小秘书订餐。所有小秘书支持订餐的餐厅,“编辑人”都替换成“订餐小秘书”。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi02.jpg}} | ||
+ | |||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi03.jpg}} | ||
+ | |||
+ | |||
+ | |||
+ | ===接口合作1:淘身边=== | ||
+ | |||
+ | 【淘身边】手机发布出售信息,淘宝网站、新浪微博同步展示。发现身边超值二手,10秒处理个人闲置。淘宝推出的基于位置功能的小区域线下交易应用。淘身边与微博位置服务平台主要是接口合作。 | ||
+ | |||
+ | |||
+ | |||
+ | *1、调用接口:获取附近地点接口http://open.weibo.com/wiki/2/place/nearby/pois | ||
+ | |||
+ | |||
+ | *2、实现功能: | ||
+ | **a)通过接口获取:用户当前位置,周边的POI信息。 | ||
+ | **b)发布宝贝同步微博,会发布到对应的POI点上。 | ||
+ | |||
+ | |||
+ | *3、据此为用户提供: | ||
+ | **a) 卖家销售商品同步微博并形成位置信息。 | ||
+ | **b)买家可以基于位置搜索并买卖周围的商品。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi04_2.jpg}} | ||
+ | |||
+ | |||
+ | *4、基于接口,优化了用户体验: | ||
+ | **a)买家可以在附近寻找自己心意的产品,并就近进行线下交易。 | ||
+ | **b)卖家以地理位置为纬度销售商品。 | ||
+ | |||
+ | |||
+ | |||
+ | ===接口合作2:掌城路况通=== | ||
+ | |||
+ | 【掌城路况通】与新浪微博“位置服务接口”合作,共同缔造LBS应用功能服务的新风向标。“路况通”首次融入了“众包”商业模式概念,号召用户共同参与实时路况分享和交通信息发布,为产品体验注入了更加强大的互动性和趣味性。用户可通过这款应用实时了解周边交通状况并随时获取行车建议。 | ||
+ | |||
+ | |||
+ | *1、调用接口: | ||
+ | **a) 签到:http://open.weibo.com/wiki/2/place/pois/add_checkin | ||
+ | **b) 获取某个位置周边的动态http://open.weibo.com/wiki/2/place/nearby_timeline | ||
+ | |||
+ | |||
+ | *2、实现功能: | ||
+ | **a) 通过接口获取:用户的当前位置,周边的路况微博。 | ||
+ | **b) 发布路况微博,会同步到地图的位置坐标上,支持以多种形式查看。 | ||
+ | |||
+ | |||
+ | *3、据此为用户提供: | ||
+ | **a)用户通过绑定微博,可发送基于位置的路况微博。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi05.png}} | ||
+ | |||
+ | **b)用户可获取到周边的动态路况微博信息,通过多种分类方式查看并评论不同类别微博。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi06.jpg}} | ||
+ | |||
+ | |||
+ | *4、基于接口,优化了用户体验: | ||
+ | **a)用户可以用文字、图示、拍照等多种方式分享途经路段的道路路况、天气状况、交通事故、交通管制等实时交通信息,还可以抒发驾车心情、路见趣闻、吃喝玩乐等各种兴致雅情,这些信息还将以各种可爱的气泡图标形式呈现在实时路况地图页面上。 | ||
+ | **b)用户也可以通过GPS定位,实时查看周边其他用户发布的各种交通出行信息,为自己的出行提供便利参考。 | ||
+ | **c)用户还将在互动体验的过程中,体会到积极报告路况、彼此分享路况,齐心协力共同绘制实时路况地图的乐趣,增加用户使用的愉悦指数。 | ||
+ | |||
+ | |||
+ | *5、微博位置服务平台对【掌城路况通】的线上推广 | ||
+ | |||
+ | **在微博位置服务平台,应用首页,以焦点大图的方式推广【路况通】,并链接至其官网,为其提供专业入口,带来更多用户。 | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi07.jpg}} | ||
+ | |||
+ | |||
+ | ==接入方法== | ||
+ | |||
+ | |||
+ | *1、普通接口调用条件: | ||
+ | **开发者Appkey须先通过微博开放平台审核,然后才能调用所有普通接口。 | ||
+ | **(微博开放平台申请方法:http://open.weibo.com/development ) | ||
+ | |||
+ | |||
+ | *2、高级接口申请方法: | ||
+ | **通过“高级接口申请流程” ,申请方式请见[[高级接口申请]] | ||
+ | **如有疑问请联系@微博位置服务平台 http://weibo.com/u/2196734667 | ||
+ | |||
+ | |||
+ | ==目前已接入应用== | ||
+ | {{center|http://www.sinaimg.cn/blog/developer/wiki/lbsapi08.jpg}} |
2012年7月17日 (二) 11:35的最后版本
目录 |
位置服务概述
新浪微博“位置服务接口”正式上线。为第三方提供基于“位置服务”与“兴趣图谱”的多维度位置服务。新浪微博“位置服务平台”共提供六大类接口,其中普通接口21个,高级接口7个。第三方开发者现在可以通过新浪微博开放平台直接调用以上接口,完成位置应用的基础开发。
接口详解
位置服务接口列表 | ||
---|---|---|
动态读取接口 | place/public_timeline | 获取公共的位置动态 |
place/friends_timeline | 获取用户好友的位置动态 | |
place/user_timeline | 获取某个用户的位置动态 | |
place/poi_timeline | 获取某个位置地点的动态 | |
place/nearby_timeline | 获取某个位置周边的动态 | |
place/statuses/show | 获取动态的详情 | |
用户读取接口 | place/users/show | 获取LBS位置服务内的用户信息 |
place/users/checkins | 获取用户签到过的地点列表 | |
place/users/photos | 获取用户的照片列表 | |
place/users/tips | 获取用户的点评列表 | |
place/users/todos | 获取用户的todo列表 | |
地点读取接口 | place/pois/show | 获取地点详情 |
place/pois/users | 获取在某个地点签到的人的列表 | |
place/pois/tips | 获取地点点评列表 | |
place/pois/photos | 获取地点照片列表 | |
place/pois/search | 按省市查询地点 | |
place/pois/category | 获取地点分类 | |
附近读取接口 | place/nearby/pois | 获取附近地点 |
place/nearby/users | 获取附近发位置微博的人 | |
place/nearby/photos | 获取附近照片 | |
place/nearby_users/list | 获取附近的人 | |
地点写入接口 | place/pois/create | 添加地点 |
place/pois/add_checkin | 签到 | |
place/pois/add_photo | 添加照片 | |
place/pois/add_tip | 添加点评 | |
place/pois/add_todo | 添加todo | |
附近写入接口 | place/nearby_users/create | 用户添加自己的位置 |
place/nearby_users/destroy | 用户删除自己的位置 |
应用举例
内容合作:订餐小秘书
【订餐小秘书】是一款以位置为基础向周边用户推荐美食并支持网上订餐和电话订餐的移动应用,与微博位置服务平台主要是内容合作,为微博位置服务平台(http://place.weibo.com )的位置详情页提供了大量扩展字段信息。 订餐小秘书在新浪微博位置服务平台推广展现位置及形式:
- 1、应用推荐
- 在新浪微博Place平台应用推荐,以焦点图、logo的形式展现,链接到订餐小秘书的官方网站,为其带来了更大的用户量。
- 2、位置详情页推广
- 将小秘书的订餐功能直接置入位置详情页,用户可直接由位置页通过小秘书订餐。所有小秘书支持订餐的餐厅,“编辑人”都替换成“订餐小秘书”。
接口合作1:淘身边
【淘身边】手机发布出售信息,淘宝网站、新浪微博同步展示。发现身边超值二手,10秒处理个人闲置。淘宝推出的基于位置功能的小区域线下交易应用。淘身边与微博位置服务平台主要是接口合作。
- 1、调用接口:获取附近地点接口http://open.weibo.com/wiki/2/place/nearby/pois
- 2、实现功能:
- a)通过接口获取:用户当前位置,周边的POI信息。
- b)发布宝贝同步微博,会发布到对应的POI点上。
- 3、据此为用户提供:
- a) 卖家销售商品同步微博并形成位置信息。
- b)买家可以基于位置搜索并买卖周围的商品。
- 4、基于接口,优化了用户体验:
- a)买家可以在附近寻找自己心意的产品,并就近进行线下交易。
- b)卖家以地理位置为纬度销售商品。
接口合作2:掌城路况通
【掌城路况通】与新浪微博“位置服务接口”合作,共同缔造LBS应用功能服务的新风向标。“路况通”首次融入了“众包”商业模式概念,号召用户共同参与实时路况分享和交通信息发布,为产品体验注入了更加强大的互动性和趣味性。用户可通过这款应用实时了解周边交通状况并随时获取行车建议。
- 1、调用接口:
- 2、实现功能:
- a) 通过接口获取:用户的当前位置,周边的路况微博。
- b) 发布路况微博,会同步到地图的位置坐标上,支持以多种形式查看。
- 3、据此为用户提供:
- a)用户通过绑定微博,可发送基于位置的路况微博。
- b)用户可获取到周边的动态路况微博信息,通过多种分类方式查看并评论不同类别微博。
- 4、基于接口,优化了用户体验:
- a)用户可以用文字、图示、拍照等多种方式分享途经路段的道路路况、天气状况、交通事故、交通管制等实时交通信息,还可以抒发驾车心情、路见趣闻、吃喝玩乐等各种兴致雅情,这些信息还将以各种可爱的气泡图标形式呈现在实时路况地图页面上。
- b)用户也可以通过GPS定位,实时查看周边其他用户发布的各种交通出行信息,为自己的出行提供便利参考。
- c)用户还将在互动体验的过程中,体会到积极报告路况、彼此分享路况,齐心协力共同绘制实时路况地图的乐趣,增加用户使用的愉悦指数。
- 5、微博位置服务平台对【掌城路况通】的线上推广
- 在微博位置服务平台,应用首页,以焦点大图的方式推广【路况通】,并链接至其官网,为其提供专业入口,带来更多用户。
接入方法
- 1、普通接口调用条件:
- 开发者Appkey须先通过微博开放平台审核,然后才能调用所有普通接口。
- (微博开放平台申请方法:http://open.weibo.com/development )
- 2、高级接口申请方法:
- 通过“高级接口申请流程” ,申请方式请见高级接口申请
- 如有疑问请联系@微博位置服务平台 http://weibo.com/u/2196734667
目前已接入应用
文档更新时间: 2012-07-17