Media and RETS 

 

 

 

RETS accesses the media servers on the NTREIS MLS System.  Media added to the MLS system is immediately available to RETS users. 

10.a) Media Look Up Tool

NTREIS provides a tool for verifying the media exists on the Media Servers.  Use this link:

http://ntreis.net/documents/MediaLookup.asp

 

and enter the MLS Number.  The results will display all the media as it exists on both NTREIS servers that store media. 

 

10.b)  Working with MEDIA

Every listing has a MLS Number and UID in the Property Class.  The UID in each Property Class links to the TableUID in the Media class.  In addition, there is a UID in the Media class. 

 

 

 

You can download media from the media servers using “GetObject” and the MLS Number or you can link to the media on the NTREIS MLS media servers.  Currently, the media is 300GB (and growing) in size.  By linking to the media as opposed to downloading the actual files, you will minimize the amount of space you need for storage and not have to manage the media files.  Linking to the media also decreases the amount of bandwidth needed, allowing for better performance by all.  Linking to the media on the NTREIS Media Servers may be the optimal way to access the media.

 

 Although the Media Class on the NTREIS RETS Server does not contain the URL’s, you can create a URL by either:

 

  1. Use the RETS “Location” parameter to download the media URL’s or
  2. Generate your own URL by using the TABLEUID and MEDIASOURCE from the Media class. 

You would then use this URL as a link that will access the images on the media server. 

 

To download the URL’s use “Location=1” in your RETS client, or if you are using the MarketLinx RETS Connector client, Under the MEDIA tab, check “Add Locations to Data File”.

If you wish to generate your own URL’s, follow the instructions below:

To start with an example, these are the URL’s for the low and high resolution images for MLS Number 9143317:

 

http://ntreispictures.marketlinx.com/MediaDisplay/86/HR769086-1.jpg

http://ntreispictures.marketlinx.com/MediaDisplay/86/LR769086-1.jpg

 

Pasting these into your browser will display the images for this property.  The URL consists of:

1)  “http://ntreispictures.marketlinx.com/MediaDisplay/”

2)  the last two digits of the TableUID,

3)  “/HR/” for high resolution media or “/LR/” for low resolution media; and

4)  the MEDIASOURCE

Below is an example SQL Script you can use to generate the media URL’s.  You would modify this as necessary to insert the URL into your media table. 

select

'http://ntreispictures.marketlinx.com/MediaDisplay/' + RIGHT(TableUID, 2)

+ '/HR' + MEDIASOURCE,

'http://ntreispictures.marketlinx.com/MediaDisplay/' + RIGHT(TableUID, 2)

+ '/LR' + MEDIASOURCE

 

For reference, a similar script was run on the MLS Data that returned the MLSNUM, TableUID, MEDIASOURCE, and the generated High Res URL.  The results are below

MLSNum

TableUID

Media Source

High Res URL

10442368

2019637

2019637-9.jpg

http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-9.jpg

10442368

2019637

2019637-8.jpg

http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-8.jpg

10442368

2019637

2019637-1.jpg

http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-1.jpg

                                      

10.b) Deleting Media Files

The MarketLinx Tempo MLS System changes the PHOTODATE whenever any media is modified, added, or deleted.  The PHOTODATE does not update if display order is changed.  A more descriptive name may have been "MediaDate" and not "PhotoDate".

10.c) Media Types

There are seven MEDIATYPES in the Media Class:

Pic

Indicates the media is a picture

Vt

Indicates the media is a virtual tour

Url

Indicates the media is a URL

Rtf

Indicates the media is a .rtf

Txt

Indicates the media is a .txt

Pdf

Indicates the media is a .pdf

Fax

Indicates the media is a fax

Ppvt

Indicates the media is a Property Panorama Virtual Tour

Ppss

Indicates the media is a Property Panorama Slideshow

 

 

Per NTREIS Rules and Regulations, the media type, “URL” should never be displayed on an Internet website that faces the public.  NTREIS monitors the media type, “vt”, to ensure no contact information is present anywhere on the information displayed by the media type “vt”. 

 

The media type, “URL” is not monitored.  You may not wish to use the media type, “URL”, as it often contains the contact information for the listing agent and or office.  NTREIS suggests you give careful thought to using the media type ”URL”. 

 

10.d) Media Fields Definitions

Below is a list of the fields associated with media.

SystemName

RETS Class

Definition

MLSNUM

RES, MUL, LND, COM, LSE

MLS Number

UID

RES, MUL, LND, COM, LSE

Ties to the Table UID in the MEDIA Class.

MODIFIED

RES, MUL, LND, COM, LSE

Updates when Listing Data is added or modified and when any Media is modified/added/deleted.  Will not update if display order is changed

PHOTODATE

RES, MUL, LND, COM, LSE

Updates whenever any media is modified/added/deleted.  PHOTODATE will not update if display order is changed.  Better name may have been "MediaDate" and not "PhotoDate".

PHOTOCOUNT

RES, MUL, LND, COM, LSE

Number of images currently associated with the listing.

DISPLAYORDER

Media

System generated. Numbers may not be consecutive.

INPUTDATE

Media

Date media record is created.  INPUTDATE is populated when a media record is created (any type).

MEDIADESCR

Media

Media Description

MEDIANAME

Media

Media Name

MEDIASOURCE

Media

For virtual tour, MediaSource is the virtual tour URL; for pics it is the <tableuid>.<displayorder>.jpg.  When the MLS user changes the order of the images in MLS, the DisplayOrder changes, but the MediaSource does not change.

MEDIATYPE

Media

Media Types –

Pic (jpg Image),

Vt (virtual tour),

Url,

Rtf (rich text format),

Txt,

Pdf,

Fax,

ppvt (Property Panorama Virtual Tour),

ppss (Property Panorama Slideshow)

MODIFIED

Media

Media modified date Is populated when a record (photo, url, attachment etc) is entered, then updated if any changes (display order, description added) to that particular record are made, or any media is added (does not update if a record is deleted)

PICCOUNT

Media

PicCount is the number of images that have historically been associated with the listing.

PRIMARYPIC

Media

Media primary picture.   The PrimaryPic is not always the lowest number for DisplayOrder.

TABLEUID

Media

Ties to the UID in the Property Classes.

UID

Media

Unique ID for each record in the MEDIA Class

 RTF, TXT, PDF, and FAX MEDIATYPEs are not available for users who download data for a public facing website. 

 

The “NTREIS Media Examples” on the RETS Technical Support page, http://www.ntreis.net/documents/NTREISRETS_9122009112539.xls

contains actual data from the MLS System showing the relationship of the fields listed above.

Updated: 6/3/2011