日本語訳http://www.tdoc.info/foursquare-API/認証・制限などOAuth。1時間に2000リクエスト。OAuthユーザ単位かIPアドレス単位。位置情報マッピングサービス。ここはなに?foursquareの各種apiをコールしたときに、具体的にどんな値が返ってくるのか一瞬で分かります。キーの意味を知るよりも、実際にどんな値が入っているかを知るほうが理解しやすいと思います。目的の値を見つけて、あぁこの値を取り出すのはこのキーだな、とそんな使い方を想定しています。foursquareの使い方まずは、上のボタンからOAuth認証してください。(認証している場合は解除ボタンになります)次は、このページの下にあるapiの一覧から目的っぽいページに移動しましょう。update」と書かれたボタンを押します。百聞は一見にしかずです。update」を押してみてください。Usersユーザー情報ユーザーIDを指定して、詳細情報を取得します。ユーザー検索ユーザーのfriendを検索します。パラメータはどれか1つ以上必須。POSTだと、400エラーになる?(2010/12/25時点)friendの承認待ちfriendの承認をまだ行っていないユーザーの一覧を取得します。指定したユーザーのバッジの一覧を取得します。指定したユーザーチェックインの履歴を取得します。簡易ページング機能の実装についてlimitとoffsetを使います。offsetには、limitの倍数を指定します。limitを10とした場合、offsetには、1ページ目は0。3ページ目は20と指定します。ページ最大値は、レスポンスに含まれる「response.checkins.count」からlimitで割り算して求められます。閲覧の途中で新しいcheckinが入ったときはズレていく問題があります。多くの場合、無視すれば良いと思いますが、厳密なページングを実現するには、afterTimestampとbeforeTimestampを使います。指定したユーザーのfrinedの一覧を取得します。ユーザーのtips指定したユーザーのtipsの一覧を取得します。ユーザーのTODO指定したユーザーのTODOの一覧を取得します。以外を指定する場合は、llの指定が必要です。指定したユーザーが訪問したvenueの一覧を取得します。指定したユーザーにfriendの申請を送ります。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)friendから外す指定したユーザーのfriendを解除します。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)friendを承認する指定したユーザーのfriend申請を承認します。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)friend申請を拒否する指定したユーザーのfriend申請を拒否します。指定したユーザーがチェックインしたときに通知(ping)を受け取るかどうか指定します。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)VenuesVenueの詳細VenueIDを指定して、Venue(スポット・お店など)の詳細情報を取得します。Venueを追加Venue(スポット・お店など)を作成します。正しい住所か、緯度経度のいずれかは必須です。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)Venueのカテゴリ一覧カテゴリの一覧を取得します。最上位カテゴリは、venueに割り当てられないためIDはありません。このApiの取得は頻繁にコールしないようにします。アプリケーション利用の開始に1回だけダウンロードし、キャッシュに保持しておきます。カテゴリ一覧は更新されますので、1週間以上キャッシュしないようにする必要があります。指定した地点に近いvenueを検索します。OAuthで取得すると、ユーザーとfriendの情報を含むことができます。今VenueにいるユーザーVenueIDを指定して、今Venue(スポット・お店など)にチェックインしているユーザーの一覧を取得します。VenuesのTips指定したVenueIDのTipsを取得します。指定したVenueIDをTODOとして印をつけます。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)間違いフラグを付けるvenueに間違いがあるときに、フラグをつけます。「closed」フラグが承認された場合はそのvenueは検索結果に現れなくなります。「mislocated」、「duplicate」の時は、モデレータは修正を試みます。ユーザーが正しい住所を持っている(知っている)場合は、代わりに変更を提案を使ってください。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)変更を提案venueの情報を変更する提案を行います。提案したいvenueのVENUE_IDを指定し、提案したいパラメータをセットします。変更の必要のないパラメータは省略します。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)CheckinsCheckinの詳細CheckinIDを指定して、チェックインの詳細情報を取得します。Checkinするチェックインします。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)friendのCheckin一覧friendが最近チェックインした場所の一覧を取得。offset)についてCheckinの履歴を参考にしてください。TipsTipsの詳細TipIDを指定して、Tipの詳細情報を取得します。TODOとDoneを付けたtipsを含みます。Tipsを追加VenueIDを指定して、Tipsを追加します。近隣にあるTipsを検索します。TODOのフラグを付けるTipIDを指定して、TipにTODOのフラグをつけます。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)Done(完了)フラグを付けるTipIDを指定して、Tipに完了のフラグをつけます。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)フラグを外すTipIDを指定して、TODOリストとDONEリストからTipのフラグを外します。foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい?(2010/12/26)Photos写真の詳細PhotoIDを指定して、写真の詳細情報を取得します。写真を追加PhotoIDを指定して、写真の詳細情報を取得します。venueIdのいずれか1つは必須です。TipsIDまたはVenuIDを指定した場合は、誰もが見られる公開状態となります。CheckinIDを指定した場合は、Checkinの公開状態に従います。(twitterやfacebookを利用してcheckinした場合はこの限りではありません)※私の理解が乏しいのかもしれませんが、アップする写真を指定するフィールドが本家ドキュメントに見当たりません。このApiの使い方をご存知の方は教えてください。自身の設定情報を取得します。意味のないように思われます。(2010/12/27)設定を変更する自身の設定情報を変更します。※本家ドキュメントのSETTING_IDには、receiveCommentPingsが無いが抜けているものと思われます。複数のApiをまとめてリクエストできます。foursquareとの通信回数の削減に貢献します。※当サイト掲載情報は、公式ドキュメントを参考に正確を期すよう心がけておりますが、時間の経過、仕様の変更、誤解(特に翻訳)、タイプミスなどにより事実と異なる内容が含まれる可能性があります。apiを活用して開発される際は、公式サイトのドキュメント、利用規約をよくお読みになったうえでご利用ください。当サイトの記述のみを信用して開発されることは禁止させて頂きます。時間の経過に伴う情報の劣化に対処するため、本サイト各ページごとに記述内容を更新した日を記しています。viewerTweet。