読者です 読者をやめる 読者になる 読者になる

lxyuma BLOG

開発関係のメモ

foursquare api その1:概要

foursquareapiについて、何回かに分けて書きます。(某解説用の下書き)

foursquareとは?

言うまでもなく、位置情報のSNSアプリの王道。

チェックインする事で、バッジを手に入れたり、写真を共有できたりします。

数値

2012/9月現在で

全世界ユーザー数は2,500万人。

チェックイン数は25億回。

国内のuser数は非公開。


但し、Foursquareチェックイン数世界ランキング(ネットの個人の書き込みより)
1位 ニューヨーク、
2位 渋谷、
3位 新宿との事なので、
おそらく、上記のユーザー数の内、日本人の占める割合は低くはないハズ。

※参考値:2012年7月現在で、類似アプリのロケタッチが15万人userとの事。


公式
https://foursquare.com/

wikipedia
http://ja.wikipedia.org/wiki/Foursquare




foursquareAPIとは?

よく見る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


使いどころ

使い方それぞれあると思いますが、

ありがちな使い道としては、以下のようなイメージでしょうか。


  • 既存のサービスのおまけ機能として場所情報を提示するパターン

(映画見たら、近くの飲食店勝手に探してくれる等・・・)

  • 場所に関するサービスで、スポット登録時のDBとして使うパターン

(飲食店の口コミアプリの元になるお店情報等)



特に最後のパターンが多いかもしれません。

例えば、rettyでお店を検索した際に出てくる店舗は

どうやら、foursquareのもののようです。



http://www.oreilly.co.jp/community/blog/2012/02/using-api-on-web-service-part1.html




制約


主な制約事項をピックアップすると、


1)基本的に、データを保管、編集は出来ません。

但し、キャッシュデータは30日で更新するのであれば、OKなのだそうです。

※この辺りも、rettyの例が参考になるかもしれません。
http://www.oreilly.co.jp/community/blog/2012/02/using-api-on-web-service-part1.html


2)また、1時間辺りのリクエスト数に制限があります。

  • リクエストにuser情報有り:500リクエストまで
  • リクエストにuser情報無し:5000リクエストまで

※これらの上限は、foursquareに相談すると、増やせる?かもしれません。どこかに書いてありました。


他にも細かな制約がありますので、必ず利用規約を読みましょう。


参考


https://developer.foursquare.com/overview/community
https://developer.foursquare.com/overview/auth#userless





次に、使い方を書いて行きます。

http://lxyuma.hatenablog.com/entry/20121222/1356180834