View source for Core/Draft

Note: the information in this document has been collected, sorted, tweaked assembled and reformatted into [http://www.w3.org/2010/POI/documents/Core/latest an editor's draft].

== Status of the Document ==
== Table of Contents ==
__TOC__

== Intro ==

This is an editor's draft of the data model for a point of interest as discussed at the first POI WG face to face.

A Point of Interest, for the purposes of this document, is defined as an aggregate of a place, its spatial location, and its descriptive metadata attributes, each of which is detailed below.

== Core POI @@doodads@@ ==

A POI is described by the following list of elements:

# Location
# Label
# Relationships
# Identifier
# Category
# Temporal Information
# Meta-data
# Extensibility


Requirements:
# must have 1/a location primitives (is at)
# can have "contained within", "contains" 1-to-many relationships
# can have "adjacent-to" 1-to-many relationships (may help w/ routes and discoverability)
# must have a "label" primitive (human description, HIGHLY recommended) [http://www.w3.org/2010/POI/track/issues/10 see ISSUE-10]
# must have an "id" primitive [http://www.w3.org/2010/POI/track/issues/9 see ISSUE-9]
# can have a "categorization" primitive
# can have a "meta data" primitive (creation time, authorship, visibility rights, etc)
# can have a "time" primitive
# must be extensible (method of payment, opening closing hours, 3D content, images, multimedia...)

==  Location primitive ==

'''Goal:'''
Provide a rich and flexible description of a location

De-couple or isolate the description of a Place of Interest from its geospatial location, since many Places can be at the same location, and Places of Interest can change locations.

A Place of Interest can be a parent to other Places Of Interest each with its own location to allow for the representation of complex places that are the aggregate of a collection of Places (campuses, business with multiple entrances, large constructs like parks, etc.).

It should not be inferred that each of the elements within the location primitive are not spatially synonymous, but do refer to the same place. 

Restrictions:
*A Place Of Interest must have a location 
*A Place of Interest must have one location.

High Level Attribution:
:Place Of Interest
::…other descriptive primitives
:Location : required
:Identification : required
:Geo-Reference : required

Supported by : 
:Change-Reference primitive : optional
::<to be defined later, for reuse across other primitives and attributes to describe ownership and change data>
::<for example below>
::Last Updated On : Date/Time  (optional)
::Updated By : owner / author (optional)
::For Use By : public, private, restrictions (optional)
::Current Status : Active, blocked, deleted (optional)
::Trustworthiness : degree of certainty the author has in the accuracy of the information in the associated primitive, based on a 5 star (high) to 1 star (low) simple rating

====Location Attribution Details====

'''Location''' : required
:'''Identification''' : required
::'''ID''' :  required : +Change-Reference : number or string
::'''Name''' : optional : +Change-Reference : reference or name 
::'''Path to ID''' : optional : +Change-Reference : URL path to the Identification System or Service : Change-Reference
::'''Associations''' : optional : +Change-Reference : list of other replacement, old or depreciated IDs that belong to this ID  : Change-Reference

:'''Geo-Reference''' : required
::<must include at least one of the location types below>               
::'''Center''' : optional : +Change-Reference : center of the parcel, building area, largely for display
:::'''Coordinates''' : required 
::::'''System''' : optional : assumes WGS 84 (optional)
::::'''Longitude''' : required
::::'''Latitude''' : required
::::'''Altitude''' : optional : defines the height in meters above or below sea level
::'''Navigation-Point''' : optional : +Change-Reference : point that is the logical destination for routing
:::'''Coordinates''' : required : <see above for details> 
::'''Address''' : optional : +Change-Reference : any civil address
:::'''Country''' : required : ISO country code (ISO 3166-1 alpha-3 country code)
:::'''Language''' : required : ISO Language Code (3-alpha MARC language)
:::'''Street''' : optional : can contain a variable mix of house number prefix, suffix, street base name and or street type
:::'''Floor''' : optional : +/- number
:::'''Suite''' : optional
:::'''Region''' : optional : repeating : can contain a variable mix of administrative regions,: neighborhood, city, state, etc.
:::'''Postal-code''' : optional
::'''Route''' : optional : +Change-Reference : for representing routes and traces
:::'''Point''' : required : repeating for a directed linked list of points
::::'''Type''' : required : one of : Start/End/way point
::::'''Coordinates''' : required : <see above for details>               
::'''Area''' : optional : +Change-Reference : for representing a line-bounded area
:::'''Point''' : required : repeating for a directed linked list of points
::::'''Type''' : required : one of : Start/End/way point
::::'''Coordinates''' : required : <see above for details>               
::'''Object''' : optional : +Change-Reference : for representing a 3D object, building, etc.
:::TBD
::'''Undetermined''' : optional : +Change-Reference : for representing a location as yet undetermined, such that a Place and its description can exist prior to the final location being resolved
::'''Map''' : optional: +Change-Reference : for associations to digital, navigable maps 
:::'''Supplier''' : required : NAVTEQ, TeleAtlas, Google, OSM, etc.
:::'''Version''' : required : Q1 2011, OSM v3.16, etc.
:::'''Map-Object-ID''' : required
:::'''Side''' : optional : side of street, left / right / end
:::'''Spot''' : % distance from the Map object’s reference end-point
::'''Relative''' : optional : +Change-Reference : repeating : for representing a relative reference as opposed to an absolute geo-spatial location
:::'''Reference-type''' : required : one of : Center, Navigation-Point, Address, Route, Area, Object, Relative, Map
:::'''Relative-Location-Object''' : required : ID or location object (ID) this relative reference refers to
:::'''Distance-From''' : required
:::'''Bearing-To''': required
:::'''Relative height''' : optional




===  Relationship primitive ===
====Requirements =====
====Details ====
A POI can have 1-to-many relationships with other POIs of the types "contained-within", "contains", "adjacent-to" and ??...

====Notes====

@@ TBD: enforcing bi-directionality of relationships?  @@


<syntaxhighlight lang="xml">

<pois>
  <poi id="A">
     ...
  </>
  <poi id="B">
  </poi>
  <poirelation type="foobarrelationship" id1="#A" id2="#B"/>

</pois>
</syntaxhighlight>

Refer to POI A:
http://example.com/POIs#A

A second document could have:
URI: http://example.com/POIC:
<syntaxhighlight lang="xml">

  <poi id="C">
     ...<contained by="http://example.com/POIs#A"/>
  </>
</syntaxhighlight>

=== string primitive ===
The string primitive is used when any attribute can contain text.

The string primitive is made up of a unicode string and a language identifier.

=== name primitive ===
This has been replaced by the label primitive.

=== label primitive ===
==== Requirements ====
* Different labels for different languages (either the whole document can support multiple languages for everything, or we can have a label-only mechanism, TBD)
* There must be a way to determine which label is the "primary" label

==== Other Requirements ====
* Do we want to specify what the different alt labels are?  Legal names?  Other modifiers?

==== Details ====
POI may have zero or more label primitives that are human labels of the POI. 

==== Notes====
We talked about having labels, alternative labels, and labels in different languages.
See [http://www.w3.org/2011/03/31-poiwg-minutes.html#item03 F2F #2 Day 3].

Some examples we spoke about:

<syntaxhighlight lang="xml">

<poi xml:lang="en-US">
  <preferredlabel>California Pizza Kitchen</preferredlabel>
  <preferredlabel xml:lang="it">California Pizza Cucina</preferredlabel>
  <preferredlablel xml:lang="ko">캘리포니아 피자 키친</>
  <altlabel>CPK</altlabel>
  <altlabel xml:lang="it">CPC</altlabel>
</poi>

<poi xml:lang="en-US">
  <preferredlabel>California Pizza Kitchen</preferredlabel>
  <preferredlabel xml:lang="it">California Pizza Cucina</preferredlabel>
  <altlabel type="abbr">CPK</altlabel>
  <altlabel xml:lang="it" type="abbr">CPC</altlabel>
</poi>

<poi xml:lang="en-US">
  <preferredlabel>California Pizza Kitchen</preferredlabel>
  <preferredlabel xml:lang="it">California Pizza Cucina</preferredlabel>
  <altlabel foobar:labeltype="http://...">CPK</altlabel>
  <altlabel xml:lang="it" foobar:labeltype="http://...">CPC</altlabel>
</poi>

<?xml version="1.0" lang="en-US" encoding="UTF-8">
<poi>
  <label primary="true">California Pizza Kitchen</label>
  <label primary="true" xml:lang="it">California Pizza Cucina</label>
  <label primary="true" xml:lang="ko">캘리포니아 피자 키친</label>
  <label>CPK</label>
  <label xml:lang="it">CPC</label>
</poi>


</syntaxhighlight>

=== id primitive===
====Requirements====
POI must have an "id" primitive.  It unambiguously identifies a POI within a particular implementation.

====Notes====
More on this [http://lists.w3.org/Archives/Public/public-poiwg/2011Feb/0028.html thread].

Discussed at [http://www.w3.org/2011/03/31-poiwg-minutes.html#item09 F2F #2]

====Notes====
Single Document example:
http://example.com/POIs:
<syntaxhighlight lang="xml">

<pois>
  <poi id="A">
     ...
  </>
  <poi id="B">
     ...<contained by="#A"/>
  </>
</pois>
</syntaxhighlight>

Refer to POI A:
http://example.com/POIs#A

A second document could have:
URI: http://example.com/POIC:
<syntaxhighlight lang="xml">

  <poi id="C">
     ...<contained by="http://example.com/POIs#A"/>
  </>
</syntaxhighlight>

=== categorization primitive ===
==== Requirements ====
@@

==== Other Requirements ====
POI can have a "categorization" primitive, with one or more category identifiers.

==== Notes====

See this [http://lists.w3.org/Archives/Member/member-poiwg/2011Mar/0013.html thread] for more discussion
[http://www.w3.org/2010/POI/wiki/images/4/4e/Category_Primative_POIWG.pdf Karl's document] on categories.

@@ TBD: required or not? @@

=== meta data primitive ===
POI can have a "meta data" primitive (creation time, authorship, visibility rights, etc)

@@ TBD @@

===  time primitive===

==== Requirements ====
* Data type for universally representing an individual point in time
* Data type for representing spans between points in time
* Names for these attributes

==== Possible requirements ====
* Recurring times
* Recurring time spans

==== Details ====

POI can have one or more "time" primitives

==== Notes ====
We will attempt to reuse other standards such as GML, KML, OSM, etc.

We will be tracking this as [http://www.w3.org/2010/POI/track/issues/7 ISSUE-7].

16:21 danbri: proposal re temporal aspects: POI spec should allow for temporal characteristics of the description/record (publication date, 'coverage' / when it's true dates); and also of the payload, including domain specific extensions such as shop opening hours, movie show times, or historical periods for sites of touristic interest. http://www.w3.org/2011/03/29-poiwg-irc#T14-23-21

===  Extensibility ===
POI must be extensible (method of payment, opening closing hours, 3D content, images, multimedia...)
@@ TBD @@

== Appendix: use cases ==
== Appendix: Examples ==

@@ Non-normative examples used while creating this document @@
<syntaxhighlight lang="xml">
<poi>
	<name id='foobar'>
		<lang>en/us</lang>
		<value>The Foo Bar</value>
	</name>
	<location>
		<coords id="coords" x="23.234234" y="34234"/>
		<address>1234 Mockingbird Lane</address>
		<mbr x1="23.234234" y1="92.2349" x2="6" y2="-3.1459"/>
	</location>
</poi>
</syntaxhighlight>


<syntaxhighlight lang="xml">
<poi>
	<name id='foobar'>
		<lang>en/us</lang>
		<value>The Foo Bar</value>
	</name>
	<location>

	</location>
</poi>
</syntaxhighlight>

== References ==