http://developer.foursquare.com/docs/photos/photos.html
https://api.foursquare.com/v2/photos/PHOTO_ID
写真の詳細を得ます。
HTTP メソッド | GET |
---|---|
認証が必要か | YES |
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を、Facebookに公開したい場合はfacebookを、その両方に公開したい場合はtwitter,facebookを設定します | |
ll | 44.3,37.2 | ユーザの場所の緯度経度。レスポンスには距離も含まれる場合があります |
llAcc | 10000.0 | ユーザの緯度経度情報の精度をメートルで示したもの |
alt | 0 | ユーザの高度をメートルで示したもの |
altAcc | 10000.0 | ユーザの高度情報の精度をメートルで示したもの |
photo | たった今作成されたphoto レスポンス |
---|