ESS:Places

From ESS
Revision as of 17:17, 20 March 2012 by Admin ess (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Format ESS
Ess-feed-icon.png
.ess, .xml
application/ess+xml
version 0.9

Contents

"Places" definition

Though an event is comprised of several attributes, one of the most important is where it takes place. An event has to take place somewhere. Location of events are represented in ESS through four element "type" attributes:

ONE PLACE EVENT

AREA EVENT

MOVING EVENT

VIRTUAL EVENT

Museum, exposition, concert, sport match...

national event, commemoration...

sport race, motor race, religion walk...

Radio show, TV entertainment, web reunion...




ESS structure

ESS documents are composed by various main XML elements. ESS processors must consider each and every element's description as valid and applicable to each and every other XML element within the same ESS document. If it is not the case, it belong to an other feed to describe this event parameter.
Example: every items must be valid and applicable to every and items within the same feed.

XML element (ess:places) must be defined within ESS Documents, it is a mandatory ESS XML element.
This section describe the interaction between ESS events and the places where the event takes place. (ess:places) XML element must be composed by, at least, one (ess:item) XML element which may have four "type" attribute values : "fixed", "area", "moving" or "virtual"
If "type" attribute is not defined in (ess:item) constructor, ESS Processors should concider "fixed" as default attribute.
Several elements can defined within XML structure to describe events with various places at the same time.
But if various events happen on various dates, they belong to several feeds to describe them separately.




Places elements

Inside a common ESS file you can place a section.
Content of item (ess:item) XML elements depends on "type" attribute.

Name Description Type Required
Unique and universal location identifier in a specific indicated taxonomy. IRI RFC3987 FALSE
Language-sensitive location short name. Should not be longer then 64 characters String TRUE
Language-sensitive location description. Should not be longer then 512 chars. String FALSE
Define event's latitude. Float TRUE
Define event's longitude. Float TRUE
Define event's address location. Should not be longer then 512 chars. String FALSE
Define event's city location name. Should not be longer then 128 characters String FALSE
Define event's postal code value. Should not be longer then 16 chars. String FALSE
Define event's region, state or department name, this XML element scan have a "code" attribute that specify region's code in the country taxonomy (should be 2 chars). String FALSE
Define event's country name, this XML element can have a "code" attribute that specify country's code in the international taxonomy (should be 2 chars). String FALSE
XML structure that numerate an infinite number of elements with keywords String content. ESS processors should use these keywords to affiliate representation of event's places. XML FALSE
XML structure only present in element with type="moving" attribute. Define geographically where the event start, it can have XML child elements: , ,
, , , ,
XML FALSE
XML structure only present in element with type="moving" attribute. Define geographically where the event start, it can have XML child elements: , ,
, , , ,
XML FALSE
Only present in element with type="virtual" attribute. Define event's channel name. Should not be longer then 128 chars. this element must have a "unit" attribute that define the device that can play this virtual event in the current channel, unit attribute can take the values: "television", "radio" or "internet". String FALSE
XML element that define kml structure (the name space xmlns="http://www.opengis.net/kml/2.2" must be defined), more information about how to build KML structure in ESS external libraries XML FALSE



ESS places sample

DTD description [https://eventstandardsyndication.org/history/0.9 ]

 version="1.0" encoding="UTF-8"?>
 xmlns="https://eventstandardsyndication.org/history/0.9" 
     xmlns:k="http://www.opengis.net/kml/2.2"  
     version="0.9" 
     lang="en">
   ...
   >
 
      
       type="fix">
         >[email protected]>
         >Modern art, National museum> 
         >
            
               Here is the place description.
            ]]>
         >
         >
            >Art>
            >Museum>
         >
         >40.76930>
         >-73.96791>
         
>
5th avenue / 69E street> >New York> >10020> code="NY">New York> code="US">United States of America> >     type="area"> >[email protected]> >Boston tea-party celebration> > ="linecolour"> >>660000FF>>3>> > > >#linecolour> > > -71.053734,42.368691,0 -71.058197,42.36793,0 -71.060944,42.367042,0 -71.065063,42.368184,0 -71.06987,42.364886,0 -71.073303,42.362096,0 -71.073475,42.356134,0 -71.070728,42.352201,0 -71.06884,42.348522,0 -71.061459,42.347253,0 -71.055622,42.347507,0 -71.049099,42.357149,0 -71.047897,42.361335,0 -71.050301,42.368945,0 -71.05368,42.368675,0 > > > > >     type="moving"> >[email protected]> >Motor race> > >40.76930> >-73.96791>
>
5th avenue / 69E street> >New York> >10020> code="NY">New York> code="US">United States of America> > > >40.70969> >-74.00132>
>
Brooklyn bridge> >New York> >10005> code="NY">New York> code="US">United States of America> > >     type="virtual"> >[email protected]> >Radio show event> code="ES">Spain> unit="radio">My favorite radio name> >   > ... >



Search a geographic location

Drag and drop the ESS icon to get a specific longitude / latitude






External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft



Discussion


Leave your comment

Personal tools
Variants
Actions
Standard

 

Developers