===================== 写真 ===================== .. _photos-photo: ------------------------- 写真の詳細 ------------------------- http://developer.foursquare.com/docs/photos/photos.html `https://api.foursquare.com/v2/photos/PHOTO_ID` 写真の詳細を得ます。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - GET * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - PHOTO_ID - IHR8THISVNU - 追加の情報を得たい写真のID ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - photo - :ref:`完全なphotoレスポンス` `試す: `_ .. _photos-add: ------------------------- 写真を追加する ------------------------- http://developer.foursquare.com/docs/photos/add.html `https://api.foursquare.com/v2/photos/add` .. Allows users to add a new photo to a checkin, tip, or a venue in general. ユーザが新しい写真をcheck-in、tip、venueに追加します(一般的にはvenueに 追加するでしょう)。 .. All fields are optional, but exactly one of the id fields (checkinId, tipId, venueId) must be passed in. 全てのフィールドはオプションですが、IDフィールド(checkinId, tipId, venueId)のうちのどれか一つが必要です。 .. In addition, the image file data must be posted. The photo should be uploaded as a jpeg and the Content-Type should be set to "image/jpeg". さらに、画像ファイルのデータは必ずPOSTする必要があります。写真はJPEG画 像で、かつ、Content-Typeが"image/jpeg"に設定されている必要があります。 .. Attaching a photo to a tip or a venue makes it visible to anybody, while attaching a photo to a checkin makes it visible only to the people who can see the checkin (the user's friends, unless the checkin has been sent to Twitter or Facebook.). Tipかvenueに写真を追加すると、その写真は全員に公開されます。一方、 checkinに写真を追加すると、その写真はcheckinを見ることができる人々 (checkinがTwitterかFacebookに送られない限り、そのユーザのfriendです)だ けが見ることができます。 .. Multiple photos can be attached to a checkin or venue, but there can only be one photo per tip. checkinとvenueに対しては複数の写真を追加することができます。しかし、 tipには一つの写真誌か追加することができません。 .. To avoid double-tweeting, if you are sending a checkin that will be immediately followed by a photo, do not set broadcast=twitter on the checkin, and just set it on the photo. checkinのすぐ後に写真を送る場合、二重にtweetすることを避けるため、 `broadcast=twitter` をcheckinには設定しないで、photoだけに設定してくだ さい。 .. list-table:: :stub-columns: 1 * - HTTP メソッド - POST * - 認証が必要か - YES ~~~~~~~~~~ パラメータ ~~~~~~~~~~ 特別に記載されていない限り、全てのパラメータはオプショナルです。 .. list-table:: :stub-columns: 1 :widths: 10 10 80 * - 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 - ユーザの高度情報の精度をメートルで示したもの ~~~~~~~~~~ レスポンス ~~~~~~~~~~ .. list-table:: :widths: 10 90 :stub-columns: 1 * - photo - たった今作成された :ref:`photo レスポンス`