Photo

Markdown

A photo with its metadata and owner.

Fields

  • mediaIdstring · photo idrequired

    The photo's id.

  • urlstringrequired

    The stored photo (at most 2048 px on the long side).

  • thumbUrlstring or nullrequired

    The ~640 px variant, or null until it is made.

  • ownerTypestringrequired

    What the photo belongs to.

    spotproductcollectionlisting
  • ownerIdstringrequired

    The owner row's id.

  • captionstring or nullrequired

    Caption.

  • altstring or nullrequired

    Alt text.

  • creditstring or nullrequired

    Photographer credit.

  • widthnumber or nullrequired

    Width in pixels.

  • heightnumber or nullrequired

    Height in pixels.

  • ordernumberrequired

    Position in the owner's gallery (ascending, fractional).

  • focalXnumber or nullrequired

    Focal point from 0 (left) to 1 (right).

  • focalYnumber or nullrequired

    Focal point from 0 (top) to 1 (bottom).

  • sourcePageUrlstring or nullrequired

    The page the photo was licensed from.

  • licencestring or nullrequired

    Licence name.

  • creditUrlstring or nullrequired

    The photographer's profile page.

  • showsPhotoShows or nullrequired

    What the photo shows.

    Show 2 fieldsof PhotoShows
    • kindstringrequired

      spot (the place itself), view_from_spot (the view from it), nearby (a sight near the spot; readiness then skips its distance check), approach (the way there), detail or other.

      spotview_from_spotnearbyapproachdetailother
    • labelstringoptional

      What exactly it shows, at most 80 characters (the north face from the lake).

  • takenAtPhotoTakenAt or nullrequired

    Where it was taken.

    Show 3 fieldsof PhotoTakenAt
    • latnumberrequired

      Latitude in decimal degrees (-90 to 90).

    • lonnumberrequired

      Longitude in decimal degrees (-180 to 180).

    • precisionstringrequired

      gps (a camera or phone fix), geocode (looked up from a place name, often coarse on stock sites) or none (an estimate; readiness lists it as resting on judgement).

      gpsgeocodenone
  • locationVerifiedBystring or nullrequired

    How the location was confirmed.

    geotaglandmarkphotographer_captioncreatorother
  • capturedOnstring or nullrequired

    Capture date (YYYY-MM-DD).

  • reviewNotesstring or nullrequired

    Notes for the creator's review, never shown to buyers.

Used by