写真

写真の詳細

http://developer.foursquare.com/docs/photos/photos.html

https://api.foursquare.com/v2/photos/PHOTO_ID

写真の詳細を得ます。

HTTP メソッド GET
認証が必要か YES

パラメータ

特別に記載されていない限り、全てのパラメータはオプショナルです。

PHOTO_ID IHR8THISVNU 追加の情報を得たい写真のID

写真を追加する

http://developer.foursquare.com/docs/photos/add.html

https://api.foursquare.com/v2/photos/add

ユーザが新しい写真をcheck-in、tip、venueに追加します(一般的にはvenueに追加するでしょう)。

全てのフィールドはオプションですが、IDフィールド(checkinId, tipId,venueId)のうちのどれか一つが必要です。

さらに、画像ファイルのデータは必ずPOSTする必要があります。写真はJPEG画像で、かつ、Content-Typeが”image/jpeg”に設定されている必要があります。

Tipかvenueに写真を追加すると、その写真は全員に公開されます。一方、checkinに写真を追加すると、その写真はcheckinを見ることができる人々(checkinがTwitterかFacebookに送られない限り、そのユーザのfriendです)だけが見ることができます。

checkinとvenueに対しては複数の写真を追加することができます。しかし、tipには一つの写真誌か追加することができません。

checkinのすぐ後に写真を送る場合、二重にtweetすることを避けるため、broadcast=twitterをcheckinには設定しないで、photoだけに設定してください。

HTTP メソッド POST
認証が必要か YES

パラメータ

特別に記載されていない限り、全てのパラメータはオプショナルです。

checkinId IHR8THISVNU このユーザが行ったcheckinのID
tipId IHR8THISVNU このユーザが作成したtipのID
venueId IHR8THISVNU venueのID。これは通常venueに公開写真を追加したときのみ使います。上記パラメータを使ってプライベートなcheckinやtipの写真を追加する場合は使いません
broadcast twitter 写真を公開する範囲を設定します。Twitterに公開したい場合はtwitterを、Facebookに公開したい場合はfacebookを、その両方に公開したい場合はtwitter,facebookを設定します
ll 44.3,37.2 ユーザの場所の緯度経度。レスポンスには距離も含まれる場合があります
llAcc 10000.0 ユーザの緯度経度情報の精度をメートルで示したもの
alt 0 ユーザの高度をメートルで示したもの
altAcc 10000.0 ユーザの高度情報の精度をメートルで示したもの

レスポンス

photo たった今作成されたphoto レスポンス

Table Of Contents

Previous topic

Checkin

Next topic

設定

This Page