V9.Common:Service

Jump to: navigation, search

Service

Contains information about a television service.

Elements

NameTypeDescription
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.

Note: This property is now deprecated. Use SystemName as the source of the service provider name instead.

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 ID of the service.
SystemName String Name of the service provider.
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 String Type of service:
  • Cable
  • Satellite
  • National
  • Broadcast

Note: This property is now deprecated. The preferred field for type of service is ServiceClass.

XML Response Example

<Service ServiceClass="CATV">
   <ServiceId>360861</ServiceId>
   <Name>Beverly Hills - Time Warner Cable- Walnut/Diamond Bar</Name>
   <City>Beverly Hills</City>
   <Type>Cable</Type>
   <MSO>Time Warner Cable</MSO>
   <MSOID>25</MSOID>
   <SystemName>Time Warner Cable- Walnut/Diamond Bar</SystemName>
   <TimeZones>
      <TimeZoneInfo>
         <StartDateTime>2012-03-11T10:00:00Z</StartDateTime>
         <EndDateTime>2012-11-04T09:00:00Z</EndDateTime>
         <Offset>-420</Offset>
      </TimeZoneInfo>
   </TimeZones>
</Service>

JSON Response Example

JSON responses are available from our REST TV Listings service.
{
   "ServiceClass":"CATV",
   "ServiceId":"360861",
   "Name":"Beverly Hills - Time Warner Cable- Walnut/Diamond Bar",
   "City":"Beverly Hills",
   "Type":"Cable",
   "MSO":"Time Warner Cable",
   "MSOID":"25",
   "SystemName":"Time Warner Cable- Walnut/Diamond Bar",
   "TimeZones":[
      {
         "StartDateTime":"2012-03-11T10:00:00Z",
         "EndDateTime":"2012-11-04T09:00:00Z",
         "Offset":"-420"
      }
   ]
}
 
Personal tools