JSON

PlaceDescription (XML)

A PlaceDescription is used to describe the details of a place in terms of its name and possibly its type, time period, and/or a geospatial description -- a description of a place as a snapshot in time.

Namespace:http://gedcomx.org/v1/
URI:http://gedcomx.org/v1/PlaceDescription
Extends:Subject

Attributes

Name Type Description
type string An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.). FTU
Attributes inherited from Subject
extracted boolean Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source. FTU
Attributes inherited from Conclusion
confidence confidenceLevel The level of confidence the contributor has about the data.
sortKey string A sort key in relation to other facts for display purposes.
lang string The language of the conclusion. See http://www.w3.org/International/articles/language-tags/ FTR
Attributes inherited from ExtensibleData
id string A local, context-specific id for the data.

Elements

Name Type Occurs Description
name TextValue 0..* An ordered list of standardized (or normalized), fully-qualified (in terms of what is known of the applicable jurisdictional hierarchy) names for this place that are applicable to this description of this place. The list MUST include at least one value. It is RECOMMENDED that instances include a single name and any equivalents from other cultural contexts; name variants should more typically be described in separate PlaceDescription instances. The list is assumed to be given in order of preference, with the most preferred value in the first position in the list.
temporalDescription Date 0..1 A description of the time period to which this place description is relevant. FTU
latitude double 0..1 Degrees north or south of the Equator (0.0 degrees). Values range from −90.0 degrees (south) to 90.0 degrees (north).
longitude double 0..1 Angular distance in degrees, relative to the Prime Meridian. Values range from −180.0 degrees (west of the Meridian) to 180.0 degrees (east of the Meridian).
spatialDescription ResourceReference 0..1 A reference to a geospatial description of this place. It is RECOMMENDED that this description resolve to a KML document. FTU
place ResourceReference 0..1 A reference to the place being described.
jurisdiction ResourceReference 0..1 A reference to a description of the jurisdiction this place.
display PlaceDisplayProperties 0..1 Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
Elements inherited from Subject
evidence EvidenceReference 0..* References to the evidence being referenced for this subject.
media SourceReference 0..* References to multimedia resources associated with this subject.
identifier Identifier 0..* The list of identifiers for the subject.
Elements inherited from Conclusion
attribution Attribution 0..1 Attribution metadata for a conclusion.
source SourceReference 0..* The source references for a conclusion.
analysis ResourceReference 0..1 A reference to the analysis document explaining the analysis that went into this conclusion. FTU
note Note 0..* Notes about a person.
Elements inherited from HypermediaEnabledData
link Link 0..* The list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.

Example

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDescription xmlns="http://gedcomx.org/v1/" id="..." confidence="..." sortKey="..." xml:lang="..." extracted="..." type="...">
  <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
  <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
    <!--...-->
  </link>
  <!--...more "link" elements...-->
  <attribution id="...">
    <contributor resourceId="..." resource="..." />
    <modified>...</modified>
    <changeMessage>...</changeMessage>
    <creator resourceId="..." resource="..." />
    <created>...</created>
  </attribution>
  <source id="..." description="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <qualifier>...</qualifier>
    <qualifier>...</qualifier>
    <!--...more "qualifier" elements...-->
  </source>
  <source description="...">
    <!--...-->
  </source>
  <!--...more "source" elements...-->
  <analysis resourceId="..." resource="..." />
  <note id="..." xml:lang="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <subject>...</subject>
    <text>...</text>
    <attribution id="..." />
  </note>
  <note xml:lang="...">
    <!--...-->
  </note>
  <!--...more "note" elements...-->
  <evidence id="..." resourceId="..." resource="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
  </evidence>
  <evidence resourceId="..." resource="...">
    <!--...-->
  </evidence>
  <!--...more "evidence" elements...-->
  <media id="..." description="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <qualifier>...</qualifier>
    <qualifier>...</qualifier>
    <!--...more "qualifier" elements...-->
  </media>
  <media description="...">
    <!--...-->
  </media>
  <!--...more "media" elements...-->
  <identifier type="...">...</identifier>
  <identifier type="...">...</identifier>
  <!--...more "identifier" elements...-->
  <name xml:lang="...">...</name>
  <name xml:lang="...">...</name>
  <!--...more "name" elements...-->
  <temporalDescription id="...">
    <original>...</original>
    <formal>...</formal>
    <normalized xml:lang="...">...</normalized>
    <normalized xml:lang="...">...</normalized>
    <!--...more "normalized" elements...-->
    <field id="..." type="..." />
    <field type="...">
      <!--...-->
    </field>
    <!--...more "field" elements...-->
  </temporalDescription>
  <latitude>...</latitude>
  <longitude>...</longitude>
  <spatialDescription resourceId="..." resource="..." />
  <place resourceId="..." resource="..." />
  <jurisdiction resourceId="..." resource="..." />
  <display id="...">
    <fullName>...</fullName>
    <name>...</name>
    <type>...</type>
  </display>
</PlaceDescription>