XML

PlaceDescription (JSON)

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

Properties

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
names array of TextValue 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 A description of the time period to which this place description is relevant. FTU
latitude double Degrees north or south of the Equator (0.0 degrees). Values range from −90.0 degrees (south) to 90.0 degrees (north).
longitude double 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 A reference to a geospatial description of this place. It is RECOMMENDED that this description resolve to a KML document. FTU
place ResourceReference A reference to the place being described.
jurisdiction ResourceReference A reference to a description of the jurisdiction this place.
display PlaceDisplayProperties Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
Properties inherited from Subject
extracted boolean Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source. FTU
evidence array of EvidenceReference References to the evidence being referenced for this subject.
media array of SourceReference References to multimedia resources associated with this subject.
identifiers array of Identifier The list of identifiers for the subject.
Properties 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
attribution Attribution Attribution metadata for a conclusion.
sources array of SourceReference The source references for a conclusion.
analysis ResourceReference A reference to the analysis document explaining the analysis that went into this conclusion. FTU
notes array of Note Notes about a person.
Properties inherited from HypermediaEnabledData
links array of Link The list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
Properties inherited from ExtensibleData
id ID A local, context-specific id for the data.

Example

{
  "type" : "...",
  "names" : [ {
    "lang" : "...",
    "value" : "..."
  }, ... ],
  "temporalDescription" : {
    "original" : "...",
    "formal" : "...",
    "normalized" : [ {
    }, ... ],
    "fields" : [ {
      "links" : {
        "type1" : [ {
        }, ... ],
        "type2" : [ {
        }, ... ],
        "..." : ...
      }
    }, ... ],
    "id" : "..."
  },
  "latitude" : ...,
  "longitude" : ...,
  "spatialDescription" : {
    "resourceId" : "...",
    "resource" : ...
  },
  "place" : {
    "resourceId" : "...",
    "resource" : ...
  },
  "jurisdiction" : {
    "resourceId" : "...",
    "resource" : ...
  },
  "display" : {
    "fullName" : "...",
    "name" : "...",
    "type" : "...",
    "id" : "..."
  },
  "extracted" : false,
  "evidence" : [ {
    "resourceId" : "...",
    "resource" : ...,
    "attribution" : {
    },
    "links" : {
      "type1" : [ {
      }, ... ],
      "type2" : [ {
      }, ... ],
      "..." : ...
    },
    "id" : "..."
  }, ... ],
  "media" : [ {
    "description" : "...",
    "attribution" : {
    },
    "qualifiers" : [ {
    }, ... ],
    "links" : {
      "type1" : [ {
      }, ... ],
      "type2" : [ {
      }, ... ],
      "..." : ...
    },
    "id" : "..."
  }, ... ],
  "identifiers" : {
    "type1" : [ {
      "type" : "...",
      "value" : "..."
    }, ... ],
    "type2" : [ {
      "type" : "...",
      "value" : "..."
    }, ... ],
    "..." : ...
  },
  "confidence" : "...",
  "sortKey" : "...",
  "lang" : "...",
  "attribution" : {
    "contributor" : {
    },
    "modified" : "...",
    "changeMessage" : "...",
    "id" : "..."
  },
  "sources" : [ {
    "description" : "...",
    "attribution" : {
    },
    "qualifiers" : [ {
    }, ... ],
    "links" : {
      "type1" : [ {
      }, ... ],
      "type2" : [ {
      }, ... ],
      "..." : ...
    },
    "id" : "..."
  }, ... ],
  "analysis" : {
    "resourceId" : "...",
    "resource" : ...
  },
  "notes" : [ {
    "lang" : "...",
    "subject" : "...",
    "text" : "...",
    "attribution" : {
    },
    "links" : {
      "type1" : [ {
      }, ... ],
      "type2" : [ {
      }, ... ],
      "..." : ...
    },
    "id" : "..."
  }, ... ],
  "links" : {
    "type1" : [ {
      "template" : "...",
      "allow" : "...",
      "count" : ...,
      "accept" : "...",
      "type" : "...",
      "hreflang" : "...",
      "title" : "...",
      "results" : ...,
      "rel" : "...",
      "offset" : ...,
      "href" : ...
    }, ... ],
    "type2" : [ {
      "template" : "...",
      "allow" : "...",
      "count" : ...,
      "accept" : "...",
      "type" : "...",
      "hreflang" : "...",
      "title" : "...",
      "results" : ...,
      "rel" : "...",
      "offset" : ...,
      "href" : ...
    }, ... ],
    "..." : ...
  },
  "id" : "..."
}