"Photo" object

Contains attributes of a Photo posted on dive.io. A Photo object has the following attributes:

Id

Unique numeric identifier of the Photo

ClientFilename

Filename of the photo as given by the client when uploaded

Title

Title of the Photo, displayed above the photo as headline. 60 characters max.

Caption

Description (caption) of the photo, displayed below the photo. 800 characters max.

Taken

Timestamp when the photo was taken, extracted from EXIF data within the photo.

DiverId

Id of the Diver who posted that Photo

DiveId

Id of the Dive object during which the photo was taken. Note that the server tries to assign photos automatically on upload, based on the "Taken" timestamp included in th Photo.

Width

Width of the original Photo in pixels

Height

Height of the original Photo in pixels

Privacy

One of: "w" (world) - photo is visible to everyone, "d" (dive.io members) - photo is visible to logged in members only, "b" (buddies) - photo is visible to buddies only

Created

Timestamp of creation of the Photo (upload), in ISO 8601 format

Modified

Timestamp of last modification of Photo data, in ISO 8601 format

PhotoHash

A hash to be used as part of the URI of the users profile picture. The full URI of the photo is constructed from the hash as follows:

     http://dive.io/i/photos/<hash>-<size>.jpg

Where "hash" is the PhotoHash value (including the directory and slash part), and "size" is one of: 640, 240, 80, 48. The "640" keeps the original aspect ratio of the photo, while in other sizes the photo is cut to squares.

Examples

XML format

  </Photo>
    <Id>26</Id>
    <Title>Cave Diving - looking back.</Title>
    <Caption>What an interesting dive - this is 
      the view looking back to the entrance 
      of the cave.</Caption>
    <Taken>2010-09-09 14:30:15</Taken>
    <DiverId>1</DiverId>
    <Width>3648</Width>
    <Height>2432</Height>
    <Privacy>d</Privacy>
    <Created>2011-06-26 13:45:26.572828+02</Created>
    <Modified>2011-07-03 11:51:11.021224+02</Modified>
    <PhotoHash>97f/97fd330d3611</PhotoHash>
  </Photo>

JSON format

{"Photo": {
   "Id":"26",
   "Title":"Test-Photo!",
   "Caption":"some interesting caption to set!",
   "Taken":"2010-09-09 14:30:15",
   "DiverId":"1", 
   "Width":"3648",
   "Height":"2432",
   "Privacy":"d",
   "Created":"2011-06-26 13:45:26.572828+02",
   "Modified":"2011-07-03 11:51:11.021224+02",
   "PhotoHash":"97f/97fd330d3611"

  }
}