「foursquare」をダウンロード

foursquare
foursquareとは
foursquare(フォースクエア)とは、Twitter、Facebook、mixi
に代表されるようなソーシャルネットワークサービスの一つで、特
に自分が居る場所(位置情報)が重要な要素になるサービスです
foursquareとは
foursquare は現実に出かけて、たとえば喫茶店、駅などのスポ
ットで iPhone、Android携帯 などで、その場所に「チェックイン(
ここに居る宣言)」するというサービスです。チェックインをするたび
に点数が加算されたり、同じ場所に誰よりもチェックインするとそ
の場所の「メイヤー(スポットのリーダーのような存在)」に任命さ
れたりとお出かけが楽しくなるサービスです。
FoursquareのAPI
foursquareのAPIは下記のURLで公開されています。
foursquare API v2 ドキュメント
https://developer.foursquare.com/docs/
FoursquareのAPI
foursquareが提供しているAPIの種類を大きく分けると下記
のように分類できます。
API
概要
認証
OAuth2.0によるユーザ認証を行い、アクセストークンを取得する。
ユーザ
ユーザ情報の取得、ユーザの検索、フレンド申請・承認などを行う。
Venue
スポットの検索、取得、追加などを行う。
Tips
ユーザが作成したTipsやTODOの一覧を取得する。
Checkin
指定されたスポットへのチェックインを行う。
写真
写真の詳細情報の取得や、写真の追加を行う。
設定
現在の設定の取得や、設定の変更を行う。
Multi
複数のAPIをまとめてリクエストする。
OAuth2.0 による認証
•
foursquareのAPIを使用するには、OAuth2.0による認
証が必要です。
•
OAuthとは
OAuthは近年公開されているウェブサービス(TwitterやFacebookなど)が
取り入れている認証方式です。
パスワードをサードパーティのアプリに渡すことなくAPIを利用でき、どのリ
ソースにアクセス可能かを細かくユーザーに認可させることができるため、
「サービスプロバイダも、サービスを利用するサードパーティのアプリ開発
者も、エンドユーザーも安全・安心なサービス利用が可能になる」 という
利点があります。
OAuth2.0 による認証
•
OAuth2.0とは
OAuth2.0ではOAuth 1.0で不評だった署名とトークン交換の複雑な仕組
みが改善されています。OAuth2.0の大きな特徴は以下の3つです。
1.
2.
3.
HTTPSを必須にし、署名をなくし、トークン取得も簡略化
アクセストークンのみでリソース取得が可能に
Webアプリも含め、4つのクライアントプロファイル(Webサーバ、ユーザエ
イジェント、ネイティブアプリ、自立クライアント)を仕様化
OAuth2.0 による認証
•
foursquareにOAuth2.0で認証する
1.
アプリの登録
アプリからfoursquareを利用するには、foursquareの開発者サイト
(https://ja.foursquare.com/oauth/)からアプリを登録して、OAuth認証用に必要な
情報を取得します。
OAuth2.0 による認証
•
foursquareにOAuth2.0で認証する
2.
アクセストークンの取得
アプリから認証ページへリダイレクトします。
https://foursquare.com/oauth2/authenticate
?client_id=YOUR_CLIENT_ID &response_type=code
&redirect_uri=YOUR_REGISTERED_REDIRECT_URI
もしユーザが了承したら、以下のURLにリダイレクトされるので、このリダイレクト
URLをアプリ側で拾います。
https://YOUR_REGISTERED_REDIRECT_URI/?code=CODE
OAuth2.0 による認証
•
foursquareにOAuth2.0で認証する
2.
アクセストークンの取得
アプリは以下のリクエストを生成しアクセストークンを要求します。
https://foursquare.com/oauth2/access_token
?client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&grant_type=authorization_code
&redirect_uri=YOUR_REGISTERED_REDIRECT_URI
&code=CODE
上記、APIの戻り値でアクセストークンを取得します。
※以降、取得したアクセストークンを用いてfoursquareのAPIを使用します。