RWML Working Group
RWML 0.71a


Road Web Markup Language (RWML)

Specification Ver.0.71a


RWML-WG Draft 1999-12-22



7. Regional Information


Figure 7.1: Regional info tree structure

Contents

7. Regional Information
7.1 Basic Information
7.2 Name
7.3 Schedule
7.4 Outline
7.5 Detail
7.6 Image
7.7 Map Image
7.8 Website
7.9 Keywords


7. Regional Information

Description:

Regional information includes things like regional events, sights, recreation, and store information. Sightseeing information that does not effect the route choice directly, but can serve as a reference for a comfortable drive, is described.

Notation Format:

<regional-info>Information that makes up regional-info. </regional-info>
or
<regional-info category="Class">Data that makes up regional information </regional-info>

Explanation :

Each element that makes up regional information is listed. Individual elements are listed below.

In the attribute category, the following characters is generally used to describe the regional information classification.

If an entry is omitted, it becomes "event".


event

sights

recreation

store

Attribute Name:
Attribute Name Attribute Value Value Upon Omission Explanation
category event, sights, recreation, store event Any element from the following list is indicated: events, sights, recreation, or store information.
Example:

<regional-info category="event">

  <name>The 50th Sapporo Snow Festival </name>

   : (omission) 

</regional-info>

or, 

<regional-info category="sights">

  <name>Old Hokkaido Government Building</name>

   : (omission) 

</regional-info>

7.1 Basic Information

Description:

This section indicates basic information pertaining to regional information.

Explanation:

This section lists the elements that make up basic information. Base individual elements on 3. Basic Information Structure.

7.2 Name

Description:

This section contains the regional information name.

Notation Format:

<name>Name</name>

Explanation:

This is described in characters.

Example:

<name>50th Sapporo Snow Festival</name>

7.3 Schedule

Description:

This section contains the schedule in which events are held and stores are open.

Notation Format:

<schedule>Schedule</schedule>

Explanation:

Description follows the notation rules regarding 2.2Time and period.

Also, by using the operators "AND"(logical product), "OR"(logical sum), and "NOT"(negation) as unique expanders of the regional information, it is possible to handle the time period logically.

Example:

<schedule>1999-02-05</schedule>

<!-- February 5, 1999 -->

or,

<schedule>1999-02-05/1999-02-11</schedule>

<!-- From February 5-11, 1999 -->

or,

<schedule>

  (1999-01-01/1999-03-31)AND((--W01)OR(--W02))

</schedule>

<!-- Mondays and Tuesdays from January 1 March 31, 1999 -->

or

<schedule>

  (1999-02-05/1999-02-11)AND(T09:00+09:00/T16:00+09:00)</schedule>

<!-- During 9:00 a.m. to 4:00 p.m. from February 5-11, 1999

During 9 a.m. to 4 p.m. from the 5th to the 11th of February 1999 -->

or,

<schedule>

  (T09:00+09:00/T16:00+09:00)AND(NOT(1998-12-30/1999-01-04))

</schedule>

<!-- 9 a.m. to 4 p.m. everyday except from December 30, 1998 to January 4, 1999-->

7.4 Outline

Description:

This section contains the outline of the regional-info.

Notation Format:

<outline>Outline</outline>

Explanation:

The outline is described in characters. The characters can include linefeed code. If the outline is in Japanese, the number of characters is approximately 50.

Example:

<outline>

The 50th Sapporo Snow Festival is held for one week starting February 5.

During the festival, various kinds of events are planed.  

</outline>

7.5 Detail

Description:

This section indicates the detailed explanation of regional-info.

Notation Format:

<detail>Details</detail>

Explanation:

This is described in characters. Characters can include linefeed code.
If the detail is in Japanese, the number of characters is approximately 300 to 400.

Example:

<detail>

The memorial event commemorating the 50th Sapporo Annual Snow Festival will be held for 1 week 

starting February 5. The venues are Odori, Makomanai and Susukino (as every year).

: (omission)

On the 6th (Saturday), the 7th (Sunday), and the 11th (Thursday), fireworks are also scheduled at the Makomanai venue. 
On the last day, the 11th, an event titled "Farewell Snow Festival" is planed in both the Odori and Makomanai venues </detail>

7.6 Image

Description:

This section indicates the URLs of images related to regional information. The image heading is expressed in characters.

Notation Format:

<image src="URL">Image Title</image>
or
<image src="URL" />

Explanation:

The URL which indicates an image is described in Attribute src.

In the contents of the elements, primary headings are described in characters.

Attribute:
Attribute Name Attribute Value Value Upon Omission Explanation
src CDATA #REQUIRED Specify the image URL.
Example:

<image src="event.jpg">Event Image</image>

or

<image src="http://www.server.domain/directory/event.jpg" />

7.7 Map Image

Description:

The map-image URL which indicates the location of regional-info is described. The image headings are described in characters.

Notation Format:

<map-image src="URL">Image Title</map-image>
or,
<map-image src="URL" />

Explanation:

The image URL is described in Attribute src.

The title is described in characters in the element content.

Attribute:
Attribute Name Attribute Value Value Upon Omission Explanation
src CDATA #REQUIRED Specify the image URL.
Example:

<map-image src="event-map.gif">Event Venue Location </map-image>

or,

<map-image src="http://www.server.domain/directory/event-map.gif" />

7.8 Website

Description:

The URL for a site introducing regional info is described. Supplemental explanations regarding the site is described in the characters.

Notation Format:

<website href="URL">Page Explanation </website>
or
<website href="URL" />

Explanation:

The URL for the page is indicated in Attribute href.

Supplemental explanation is described in characters in the element content.

Attribute:
Attribute Name Attribute Value Value Upon Omission Explanation
href CDATA #REQUIRED Specify the web site URL.
Example:

<website href="http://www.server.domain/indexa.html">

  Sapporo Snow Festival Official Web Site

</website>

7.9 Keywords

Description:

This section indicates regional information key words.

Notation Format:

<keywords>Keywords</keywords>
or
<keywords>Keywords,Keywords,...</keywords>

Explanation:

Keywords are listed. If the more than one keyword is listed, the individual keywords are divided by a comma[,].

Standard keywords are listed below.


agriculture, fishing industry, regional industries, free market, hot springs,

outdoor, sports, flower/tree, music, art, food culture, family, child, adults, male, female



Example:

<keywords>Outdoor</keywords>

or 

<keywords>Agriculture, Free Market, Sports, Art, Female</keywords>