HOW TO: Retrieve high resolution photos

The flexmls RETS server makes high resolution photos (when uploaded by the listing agent) available for retrieval; however, some specific requirements exist in order to get access to those.

When retrieving photos from the flexmls RETS server, 2 modes exist:

Location=0 (the RETS specification-defined default) This parameter value tells the RETS server to directly give you back the photo so that you can store it within your system.

Location=1 (considered best practice) This parameter value tells the RETS server that you'd rather get back the URL to our copy of the photo rather than getting the photo directly.

The following 4 photo types can be retrieved through a GetObject request:

  • Thumbnail
  • Photo
  • 640x480
  • HiRes

The flexmls RETS server enforces a restriction on GetObject responses that prevents you from retrieving the larger sizes as a direct download as shown by the following table:

Size Location=0 (Download photo) Location=1 (Retrieve URL to photo)
Thumbnail 65x42 size given URL of 65x42 size given
Photo 300x225 size given URL of 300x225 size given
640x480 300x225 size given URL of 640x480 size given
HiRes 300x225 size given URL of 1024x768 size given

If you're interested in getting photo sizes larger than 300x225, you'll need to request the URL to the 640x480 or HiRes type and use that (either to serve directly to your users or to then initiate a download of the photo).