Allows users to add a new photo to a checkin, tip, venue, or page update in general. All fields are optional, but exactly one of the id fields (
pageId) must be passed in.
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”. Images may not exceed 5MB in size.
Attaching a photo to a tip or a venue makes it visible to anybody. By default, 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); this can be overridden by specifying
public=1 in the request. Attaching a photo to a page is visible to anybody and is intended for use only in an update.
Multiple photos can be attached to a checkin, venue, or page, but there can only be one photo per 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.
When adding a photo to a checkin, specify the post parameters to connect the photo back to the corresponding content inside your app.
|checkinId||IHR8THISVNU||the ID of a checkin owned by the user.|
|tipId||IHR8THISVNU||the ID of a tip owned by the user.|
|venueId||IHR8THISVNU||the ID of a venue, provided only when adding a public photo of the venue in general, rather than a photo for a private checkin, tip, or page update.|
|pageId||2345||the ID of a page, provided only when adding a photo that will be in an update for that page (no other ids should be specified).|
|broadcast||Whether to broadcast this photo. Send
|ll||33.7,44.2||Latitude and longitude of the user’s location.|
|llAcc||1||Accuracy of the user’s latitude and longitude, in meters.|
|alt||0||Altitude of the user’s location, in meters.|
|altAcc||1||Vertical accuracy of the user’s location, in meters.|
|postUrl||http://your.site.com/path||A link for more details about the photo. This page will be opened in an embedded web view in the foursquare application, unless
|postContentId||3ER4GN93AFWE||Identifier for the photo post to be used in a native link handler, up to 50 characters. A
|postText||Awesome!||Text for the photo post, up to 200 characters. A