foursquare api その１：概要
foursquareのapiについて、何回かに分けて書きます。（某解説用の下書き）
foursquareとは？
言うまでもなく、位置情報のSNSアプリの王道。
チェックインする事で、バッジを手に入れたり、写真を共有できたりします。
数値
2012/9月現在で
全世界ユーザー数は2,500万人。
チェックイン数は25億回。
国内のuser数は非公開。
但し、Foursquareチェックイン数世界ランキング（ネットの個人の書き込みより）
1位 ニューヨーク、
2位 渋谷、
3位 新宿との事なので、
おそらく、上記のユーザー数の内、日本人の占める割合は低くはないハズ。
※参考値：2012年7月現在で、類似アプリのロケタッチが15万人userとの事。
wikipedia
http://ja.wikipedia.org/wiki/Foursquare
foursquareのAPIとは？
よく見るAPIと同じように、
API用のホストに、パスとパラメータを指定してアクセスして、Jsonを取得して、
値を取得・変更するというシンプルな仕組みです。
APIを使うと、foursquare上で出来る事が一通りできます。
例えば、チェックインの取得や実行。
ユーザー情報取得、友達リスト取得。
スポット情報、写真の取得等。
参考
公式
https://developer.foursquare.com/
個人の和訳
http://tdoc.info/foursquare-API/
IBMの入門記事
（文中の中央付近の表を見ると何ができるかパッと分かります。）
http://www.ibm.com/developerworks/jp/opensource/library/os-foursquare/?cmp=dw&cpb=dwope&ct=dwrss&cr=dwrss&ccy=jp&csr=121010
foursquare apiの作例
https://ja.foursquare.com/apps/
http://techwave.jp/archives/51489953.html
使いどころ
使い方それぞれあると思いますが、
ありがちな使い道としては、以下のようなイメージでしょうか。
- foursquare自体を作り直すパターン
- 既存のサービスのおまけ機能として場所情報を提示するパターン
（映画見たら、近くの飲食店勝手に探してくれる等・・・）
- 場所に関するサービスで、スポット登録時のDBとして使うパターン
（飲食店の口コミアプリの元になるお店情報等）
特に最後のパターンが多いかもしれません。
例えば、rettyでお店を検索した際に出てくる店舗は
どうやら、foursquareのもののようです。
http://www.oreilly.co.jp/community/blog/2012/02/using-api-on-web-service-part1.html
制約
主な制約事項をピックアップすると、
１）基本的に、データを保管、編集は出来ません。
但し、キャッシュデータは３０日で更新するのであれば、OKなのだそうです。
※この辺りも、rettyの例が参考になるかもしれません。
http://www.oreilly.co.jp/community/blog/2012/02/using-api-on-web-service-part1.html
２）また、１時間辺りのリクエスト数に制限があります。
- リクエストにuser情報有り：500リクエストまで
- リクエストにuser情報無し：5000リクエストまで
※これらの上限は、foursquareに相談すると、増やせる？かもしれません。どこかに書いてありました。
他にも細かな制約がありますので、必ず利用規約を読みましょう。
参考
https://developer.foursquare.com/overview/community
https://developer.foursquare.com/overview/auth#userless
次に、使い方を書いて行きます。
