foursquare/api/v2/photos/add

写真を追加

PhotoIDを指定して、写真の詳細情報を取得します。

パラメータのすべてはオプションですが、checkinId, tipId, venueIdのいずれか１つは必須です。

TipsIDまたはVenuIDを指定した場合は、誰もが見られる公開状態となります。
CheckinIDを指定した場合は、Checkinの公開状態に従います。（twitterやfacebookを利用してcheckinした場合はこの限りではありません）

※私の理解が乏しいのかもしれませんが、アップする写真を指定するフィールドが本家ドキュメントに見当たりません。
Contenttypeをimage/jpegで送信するようにとはあるが、どうやって？ このApiの使い方をご存知の方は教えてください。(2010/12/27)

※ foursquareのPOST系はjsonpしても、ステータスコード200が返るとは限らないのでjavascriptからは厳しい？(2010/12/26)

api URL

api url
https://api.foursquare.com/v2/photos/add
format
json
method
POST
認証
OAuth
実行制限
なし
公式ドキュメント
http://developer.foursquare.com/docs/photos/add.html

parameter set

parameter value 省略 説明
checkinId 可 チェックインID。
tipId 可 TipsID。
venueId 可 VenueID。
broadcast 可 公開する範囲。同時投稿という意味？
ll 可 緯度、経度を世界測地系でカンマ区切り。
llAcc 可 緯度と経度の精度をメートル単位で指定。
alt 可 指定地の高度をメートル単位で指定。
altAcc 可 高度情報の精度をメートル単位で指定。

取得形式 :

call results

[call update]ボタンを押してください。ここに結果が表示されます。

  • このデータは、jsonpで取得しjabascriptオブジェクトに変換されたものを再度json形式に変換した結果です。
  • 受信されるデータと厳密に同じでないことをご理解ください。

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

開発メンバー間でパラメータの指定例をメールで送信したり、ブログやホームページでApiの説明を書く際にお使いください。
※パラメータにApiキーなどが含まれる場合はご注意ください。

  • javascriptでは桁数の大きな数値で値がズレることがあります。
  • 例えば、twitterの id_str と id です。
  • id_str は文字列型ですので正しい値が表示されます。
  • id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
  • id_str と id が異なる場合は、id_str を信用してください。
  • 試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか？
  • javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
  • 本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。