V9.Common:ListingsChannelLineup

Jump to: navigation, search

ChannelLineup

Contains information about a television service and its channel lineup, the list of channels provided by the service.

Elements

NameTypeDescription
Channels ListingsChannel [ ] List of channels.
City String Name of the city served in less than 20 characters.
MSO String Name of the television service provider in less than 40 characters.

MSO stands for multiservice operator, and although the term applies only to cable and satellite providers, national and broadcast services are also reported here.

MSOID String ID of the television service provider in less than 10 characters.
Name String Name of the service.
ServiceClass String Type of service and channel lineup offered.
ValueDescription
CATVCable TV.
DBSDirect broadcast satellite, such as DIRECTV and Dish Network.
HospitalsHospitals and nursing homes. See Note 2 below.
Hotels, CondosHotels and condos. See Note 2 below.
IPTV ProvidersIPTV provider. See Note 2 below.
MATVMATV (apartment complexes). See Note 2 below.
Mult Dis SystemsMultidistribution systems. See Note 2 below.
Non Cable CustomerNon-cable customer. Used for Rovi US national channel lineups and Rovi test lineups.
Other SMATVOther type of SMATV system (colleges/prisons). See Note 2 below.
Over the Air Broadcast   Over-the-air broadcast.
Reference AccountReference account.
TelcoTelco, such as Verizon FiOS and AT&T U-Verse.

Note 1: The most common types in use are CATV, DBS, and Over the Air Broadcast.

Note 2: SMATV (Single Master Antenna Television) systems receive a single satellite feed and distribute content throughout a property via cable, L-Band, or LAN (IPTV).

ServiceId Integer Database ID of a television service.
TimeZones TimeZoneInfo [ ] UTC offset applicable to a television service and when the offset begins and ends. Television broadcast times are returned in UTC time, and you need to apply the offset to calculate the local time. UTC offsets change with daylight savings time.
Type ServiceType Type of television service.

XML Response Example

The following response has been edited to reduce the length.
<ChannelLineup>
  <ServiceId>20494</ServiceId>
  <Name>Los Angeles Area Channels - Los Angeles Area Broadcast</Name>
  <City>Los Angeles</City>
  <Type>Broadcast</Type>
  <MSO>Data Services Product</MSO>
  <MSOID>301530</MSOID>
  <TimeZones>
    <TimeZoneInfo>
      <StartDateTime>2011-03-13T10:00:00Z</StartDateTime>
      <EndDateTime>2011-11-06T09:00:00Z</EndDateTime>
      <Offset>-420</Offset>
    </TimeZoneInfo>
  </TimeZones>
  <ServiceClass>Over the Air Broadcast</ServiceClass>
  <Channels>
    <ListingsChannel SourceId="11110" Channel="2.1" CallLetters="KCBSHD" DisplayName="KCBSHD" SourceType="Broadcast" Type="24-Hours" Order="1" TiVoSupported="true" ParentNetworkId="2" IconAvailable="true" FullName="KCBS HDTV" VirtualChannelNumber="2.1" Affiliation="2165" ServiceType="Digital" SourceAttributes="1">
      <ChannelSchedules/>
      <SourceAttributeTypes>
        <SourceAttributeType>HD</SourceAttributeType>
      </SourceAttributeTypes>
      <ChannelImages>
        <Image>
          <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
          <ImageUseType xsi:nil="true"/>
          <ImageId>28785</ImageId>
          <ImageTitle>CBS</ImageTitle>
          <ImageCaption>Source Logo</ImageCaption>
          <ObjectId>11110</ObjectId>
          <ObjectType>Source</ObjectType>
          <ObjectName>CBS; CBS</ObjectName>
          <Relevancy>true</Relevancy>
          <ImageCredit>CBS</ImageCredit>
          <ImageCreditDisplay xsi:nil="true"/>
          <ImageCastWeight xsi:nil="true"/>
          <ImageZoomLevel>1</ImageZoomLevel>
          <ImageHeadcount xsi:nil="true"/>
          <ImageType>Station Logo</ImageType>
          <ImageFormat xsi:nil="true"/>
          <ImageHorizontalResolution>248</ImageHorizontalResolution>
          <ImageVerticalResolution>251</ImageVerticalResolution>
          <ImageMaintainAspectFlag xsi:nil="true"/>
          <ImageExpiryDateTime xsi:nil="true"/>
          <LastUpdate>2009-02-05T10:13:15.79Z</LastUpdate>
          <ImageFormatId xsi:nil="true"/>
          <Orientation>Portrait</Orientation>
          <AspectRatio>1:1</AspectRatio>
          <ImageOwner>CBS</ImageOwner>
          <ParentImageId>16786820</ParentImageId>
        </Image>
      </ChannelImages>
      <ChannelLocation/>
      <DvbTriplets/>
    </ListingsChannel>
    <ListingsChannel SourceId="11287" Channel="4.1" CallLetters="KNBCHD" DisplayName="KNBCHD" SourceType="Broadcast" Type="24-Hours" Order="2" TiVoSupported="true" ParentNetworkId="5" IconAvailable="true" FullName="KNBC HDTV" VirtualChannelNumber="4.1" Affiliation="1209" ServiceType="Digital" SourceAttributes="1">
      <ChannelSchedules/>
      <SourceAttributeTypes>
        <SourceAttributeType>HD</SourceAttributeType>
      </SourceAttributeTypes>
      <ChannelImages>
        <Image>
          <ImageUrl>http://actual-url-concealed.jpg</ImageUrl>
          <ImageUseType xsi:nil="true"/>
          <ImageId>219</ImageId>
          <ImageTitle>NBC</ImageTitle>
          <ImageCaption>Source logo</ImageCaption>
          <ObjectId>11287</ObjectId>
          <ObjectType>Source</ObjectType>
          <ObjectName>NBC; National Broadcast Company</ObjectName>
          <Relevancy>true</Relevancy>
          <ImageCredit>NBC</ImageCredit>
          <ImageCreditDisplay xsi:nil="true"/>
          <ImageCastWeight xsi:nil="true"/>
          <ImageZoomLevel>1</ImageZoomLevel>
          <ImageHeadcount xsi:nil="true"/>
          <ImageType>Station Logo</ImageType>
          <ImageFormat xsi:nil="true"/>
          <ImageHorizontalResolution>2000</ImageHorizontalResolution>
          <ImageVerticalResolution>1907</ImageVerticalResolution>
          <ImageMaintainAspectFlag xsi:nil="true"/>
          <ImageExpiryDateTime xsi:nil="true"/>
          <LastUpdate>2008-08-18T15:00:28.81Z</LastUpdate>
          <ImageFormatId xsi:nil="true"/>
          <Orientation>Landscape</Orientation>
          <AspectRatio>1:1</AspectRatio>
          <ImageOwner>NBC</ImageOwner>
          <ParentImageId>16777425</ParentImageId>
        </Image>
      </ChannelImages>
      <ChannelLocation/>
      <DvbTriplets/>
    </ListingsChannel>
  </Channels>
</ChannelLineup>

JSON Response Example

The following response has been edited to reduce the length. JSON responses are available from our REST TV Listings service.
"ChannelLineup":{
   "ServiceId":20494,
   "Name":"Los Angeles Area Channels - Los Angeles Area Broadcast",
   "City":"Los Angeles",
   "Type":"Broadcast",
   "MSO":"Data Services Product",
   "MSOID":"301530",
   "TimeZones":[
      {
         "StartDateTime":"2011-03-13T10:00:00Z",
         "EndDateTime":"2011-11-06T09:00:00Z",
         "Offset":-420
      }
   ],
   "ServiceClass":"Over the Air Broadcast",
   "Channels":[
      {
         "SourceId":11110,
         "Channel":"2.1",
         "CallLetters":"KCBSHD",
         "DisplayName":"KCBSHD",
         "SourceType":"Broadcast",
         "Type":"24-Hours",
         "Order":1,
         "TiVoSupported":true,
         "ParentNetworkId":2,
         "IconAvailable":true,
         "FullName":"KCBS HDTV",
         "VirtualChannelNumber":"2.1",
         "Affiliation":2165,
         "ServiceType":"Digital",
         "SourceAttributes":"1",
         "ChannelSchedules":null,
         "SourceAttributeTypes":[
            "HD"
         ],
         "ChannelImages":[
            {
               "ImageUrl":"http:\/\/actual-url-concealed.jpg",
               "ImageUseType":null,
               "ImageId":28785,
               "ImageTitle":"CBS",
               "ImageCaption":"Source Logo",
               "ObjectId":"11110",
               "ObjectType":"Source",
               "ObjectName":"CBS; CBS",
               "Relevancy":true,
               "ImageCredit":"CBS",
               "ImageCreditDisplay":null,
               "ImageCastWeight":null,
               "ImageZoomLevel":"1",
               "ImageHeadcount":null,
               "ImageType":"Station Logo",
               "ImageFormat":null,
               "ImageHorizontalResolution":248,
               "ImageVerticalResolution":251,
               "ImageMaintainAspectFlag":null,
               "ImageExpiryDateTime":null,
               "LastUpdate":"2009-02-05T10:13:15.79Z",
               "ImageFormatId":null,
               "Orientation":"Portrait",
               "AspectRatio":"1:1",
               "ImageOwner":"CBS",
               "ParentImageId":16786820
            }
         ],
         "ChannelLocation":"",
         "DvbTriplets":null,
      },
      {
         "SourceId":11287,
         "Channel":"4.1",
         "CallLetters":"KNBCHD",
         "DisplayName":"KNBCHD",
         "SourceType":"Broadcast",
         "Type":"24-Hours",
         "Order":2,
         "TiVoSupported":true,
         "ParentNetworkId":5,
         "IconAvailable":true,
         "FullName":"KNBC HDTV",
         "VirtualChannelNumber":"4.1",
         "Affiliation":1209,
         "ServiceType":"Digital",
         "SourceAttributes":"1",
         "ChannelSchedules":null,
         "SourceAttributeTypes":[
            "HD"
         ],
         "ChannelImages":[
            {
               "ImageUrl":"http:\/\/actual-url-concealed.jpg",
               "ImageUseType":null,
               "ImageId":219,
               "ImageTitle":"NBC",
               "ImageCaption":"Source logo",
               "ObjectId":"11287",
               "ObjectType":"Source",
               "ObjectName":"NBC; National Broadcast Company",
               "Relevancy":true,
               "ImageCredit":"NBC",
               "ImageCreditDisplay":null,
               "ImageCastWeight":null,
               "ImageZoomLevel":"1",
               "ImageHeadcount":null,
               "ImageType":"Station Logo",
               "ImageFormat":null,
               "ImageHorizontalResolution":2000,
               "ImageVerticalResolution":1907,
               "ImageMaintainAspectFlag":null,
               "ImageExpiryDateTime":null,
               "LastUpdate":"2008-08-18T15:00:28.81Z",
               "ImageFormatId":null,
               "Orientation":"Landscape",
               "AspectRatio":"1:1",
               "ImageOwner":"NBC",
               "ParentImageId":16777425
            }
         ],
         "ChannelLocation":"",
         "DvbTriplets":null
      }
   ]
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/V9.Common:ListingsChannelLineup"
Personal tools