GET image

Owned by Ludovic Thomas (Unlicensed)
Last updated: Dec 04, 2017 by Mickaël Gagné (Unlicensed)
4 min read

Different images can be set on the gomanager tool for 3 types of schedule elements: events, artists, and venues.
If an image is not set, a default image is returned. This image can only be configured by Greencopper.

In order to fit all needs, each image is available in different formats and sizes.

Endpoint

All the image URLs follow the same pattern:

http://goevent-images.s3.amazonaws.com/<project_tag>/<image_token>/web/(<format{2}>_)?<object_type>_<object_id>_<datetime{10}>_<hash{8}>.jpg

With the following parameters

  • project tag: Unique tag per project
  • image token: Unique project image token (given by your Account Manager)
  • format: The format of the image. The value can be empty, or "xl_" or "th_", for respectively normal, large and thumbnail format image
  • object type: The type of schedule object. The value can be "event", "artist", or "venue"
  • object id: The identifier of the schedule object. It must be an integer
  • datetime: The datetime when the image have been changed on gomanager tools
  • hash: A unique hash generated each time the image is changed 

Sample

http://goevent-images.s3.amazonaws.com/master-v6full/05acd3a9/web/xl_artist_14_20140304020433_9d629801.jpg



Image formats

For each image, 3 different main formats can be retrieved:

  • large: used to display a big or very big picture in a detail view for example (500px to 1280px wide)
  • normal: used to display an image in a lineup for example (200px to 500px wide)
  • thumbnail: used to display an image in a list presentation or timeline (less than 200px wide).

Image display parameters

For each format, 2 parameters can be set to specify size and crop:

  • crop to fill:
    • if enabled, all images will have the exact same size, and if images are too large or tall, they will be cropped.
    • if disabled, all images will fit in the corresponding size (width/height)
  • size (width/height):
    • depending on the "crop to fill" parameter, defines either the max width/height of the image, or the exact width/height.
    • if the size is using square ratio (width=height), the square area selected in the gomanager tool is going to be used. Otherwise, the crop area will be centered by default. 

Both image display parameters ("crop to fill" and "size") are working together, and depending on the combination, the output image is going to be different.
In order to better understand the two parameters, two samples are displayed below for landscape and portrait images.

Landscape sample

  • Original image set in gomanager, with the red square indicating the "square" area selected on the gomanager tool 
  • Render without crop to fill, and size set to 625x400
    (the image is fitting size, and in the sample, the result is 625px width, and less than 400px height)
  • Render with crop to fill, and size set to 345x210
    (the image is centered cropped as the size ratio is not square)
  • Render with crop to fill, and size set 210x210
    (the image is cropped according to the gomanager square area selected - red in the first image - as the size ratio is square)

Portrait image

  • Original image set in gomanager, with the red square indicating the "square" area selected on the gomanager tool 
  • Render without crop to fill, and size set to 400x625
    (the image is fitting size, and in the sample, the result is 400px width, and less than 625px height)
  • Render with crop to fill, and size set to 345x210
    (the image is centered cropped as the size ratio is not square - as the image is portrait, but size is landscape, the result is not beautiful)


  • Render with crop to fill, and size set 210x210
    (the image is cropped according to the gomanager square area selected - red in the first image - as the size ratio is square)