Package org.gedcomx.conclusion
Class PlaceDescription
- java.lang.Object
-
- org.gedcomx.common.ExtensibleData
-
- org.gedcomx.links.HypermediaEnabledData
-
- org.gedcomx.conclusion.Conclusion
-
- org.gedcomx.conclusion.Subject
-
- org.gedcomx.conclusion.PlaceDescription
-
- All Implemented Interfaces:
Attributable,HasNotes,HasTransientProperties,SupportsLinks,SupportsExtensionElements,ReferencesSources
public class PlaceDescription extends Subject
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.
-
-
Field Summary
-
Fields inherited from class org.gedcomx.common.ExtensibleData
extensionElements, transientProperties
-
-
Constructor Summary
Constructors Constructor Description PlaceDescription()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaccept(GedcomxModelVisitor visitor)Accept a visitor.voidaddName(TextValue name)Add a name to the list of standardized names.PlaceDescriptionanalysis(ResourceReference analysis)Add a reference to the analysis for this conclusion.PlaceDescriptionanalysis(URI analysis)Add a reference to the analysis for this conclusion.PlaceDescriptionanalysis(Document analysis)Add a reference to the analysis for this conclusion.PlaceDescriptionattribution(Attribution attribution)Build up this conclusion with attribution.PlaceDescriptionconfidence(URI confidence)Build up this conclusion with a confidence level.PlaceDescriptionconfidence(ConfidenceLevel confidence)Build up this conclusion with a confidence level.PlaceDescriptiondisplayExtension(PlaceDisplayProperties display)Build out this place with a display exension.voidembed(PlaceDescription place)Embed another place.booleanequals(Object o)PlaceDescriptionevidence(EvidenceReference evidence)Build up this subject with an evidence reference.PlaceDescriptionevidence(PlaceDescription evidence)PlaceDescriptionextensionElement(Object element)PlaceDescriptionextracted(Boolean extracted)Build up this subject with an extracted flag.PlaceDisplayPropertiesgetDisplayExtension()Display properties for the place.ResourceReferencegetJurisdiction()A reference to a description of the jurisdiction this place.DoublegetLatitude()Degrees north or south of the Equator (0.0 degrees).DoublegetLongitude()Angular distance in degrees, relative to the Prime Meridian.List<TextValue>getNames()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.ResourceReferencegetPlace()A reference to the place being described.ResourceReferencegetSpatialDescription()A reference to a geospatial description of this place.DategetTemporalDescription()A description of the time period to which this place description is relevant.URIgetType()An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).inthashCode()PlaceDescriptionid(String id)Build up this object with an id.PlaceDescriptionidentifier(Identifier identifier)Build up this subject with an identifier.PlaceDescriptionjurisdiction(ResourceReference jurisdiction)Build out this place description with a jurisdiction.PlaceDescriptionlang(String lang)Build up this conclusion with a lang.PlaceDescriptionlatitude(Double latitude)Build out this place description with a latitude.PlaceDescriptionlink(String rel, URI href)Build up this data with a link.PlaceDescriptionlink(Link link)Build up this data with a link.PlaceDescriptionlongitude(Double longitude)Build out this place description with a longitude.PlaceDescriptionmedia(SourceDescription media)Build up this subject with a media reference.PlaceDescriptionmedia(SourceReference media)Build up this subject with a media reference.PlaceDescriptionname(String name)Build out this description with a name.PlaceDescriptionname(TextValue name)Build out this description with a name.Stream<TextValue>names()Create a stream for the names.PlaceDescriptionnote(Note note)Build up this conclusion with a note.PlaceDescriptionplace(ResourceReference place)Build out this place description with a place.voidsetDisplayExtension(PlaceDisplayProperties display)Display properties for the place.voidsetJurisdiction(ResourceReference jurisdiction)A reference to a description of the jurisdiction this place.voidsetLatitude(Double latitude)Degrees north or south of the Equator (0.0 degrees).voidsetLongitude(Double longitude)Angular distance in degrees, relative to the Prime Meridian.voidsetNames(List<TextValue> names)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.voidsetPlace(ResourceReference place)A reference to the place being described.voidsetSpatialDescription(ResourceReference spatialDescription)A reference to a geospatial description of this place.voidsetTemporalDescription(Date temporalDescription)A description of the time period to which this place description is relevant.voidsetType(URI type)An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).PlaceDescriptionsortKey(String sortKey)Build up this fact with a sort key.PlaceDescriptionsource(SourceDescription source)Build up this conclusion with a source reference.PlaceDescriptionsource(SourceReference sourceReference)Build up this conclusion with a source reference.PlaceDescriptionspatialDescription(ResourceReference spatialDescription)Build out this place description with a spacial description.PlaceDescriptiontemporalDescription(Date temporalDescription)Build out this place description with a temporal description.PlaceDescriptiontype(URI type)Build out this place description with a type.-
Methods inherited from class org.gedcomx.conclusion.Subject
addEvidence, addIdentifier, addMedia, embed, evidence, getEvidence, getExtracted, getIdentifiers, getMedia, getPersistentId, identifiers, media, setEvidence, setExtracted, setIdentifiers, setMedia, setPersistentId
-
Methods inherited from class org.gedcomx.conclusion.Conclusion
addNote, addSource, embed, getAnalysis, getAttribution, getConfidence, getKnownConfidenceLevel, getLang, getNotes, getSortKey, getSources, notes, setAnalysis, setAttribution, setConfidence, setKnownConfidenceLevel, setLang, setNotes, setSortKey, setSources, sources, toString
-
Methods inherited from class org.gedcomx.links.HypermediaEnabledData
addLink, addLink, addTemplatedLink, embed, getLink, getLinks, getLinks, setLinks
-
Methods inherited from class org.gedcomx.common.ExtensibleData
addExtensionElement, embed, findExtensionOfType, findExtensionOfType, findExtensionsOfType, findExtensionsOfType, getExtensionElements, getId, getTransientProperties, getTransientProperty, removeExtensionElements, setExtensionElement, setExtensionElements, setId, setTransientProperty
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.gedcomx.common.Attributable
getAttribution, setAttribution
-
-
-
-
Method Detail
-
id
public PlaceDescription id(String id)
Description copied from class:ExtensibleDataBuild up this object with an id.
-
extensionElement
public PlaceDescription extensionElement(Object element)
- Overrides:
extensionElementin classSubject
-
link
public PlaceDescription link(String rel, URI href)
Description copied from class:HypermediaEnabledDataBuild up this data with a link.
-
link
public PlaceDescription link(Link link)
Description copied from class:HypermediaEnabledDataBuild up this data with a link.
-
lang
public PlaceDescription lang(String lang)
Description copied from class:ConclusionBuild up this conclusion with a lang.
-
confidence
public PlaceDescription confidence(URI confidence)
Description copied from class:ConclusionBuild up this conclusion with a confidence level.- Overrides:
confidencein classSubject- Parameters:
confidence- The confidence level.- Returns:
- this.
-
confidence
public PlaceDescription confidence(ConfidenceLevel confidence)
Description copied from class:ConclusionBuild up this conclusion with a confidence level.- Overrides:
confidencein classSubject- Parameters:
confidence- The confidence level.- Returns:
- this.
-
source
public PlaceDescription source(SourceReference sourceReference)
Description copied from class:ConclusionBuild up this conclusion with a source reference.
-
source
public PlaceDescription source(SourceDescription source)
Description copied from class:ConclusionBuild up this conclusion with a source reference.
-
note
public PlaceDescription note(Note note)
Description copied from class:ConclusionBuild up this conclusion with a note.
-
analysis
public PlaceDescription analysis(ResourceReference analysis)
Description copied from class:ConclusionAdd a reference to the analysis for this conclusion.
-
attribution
public PlaceDescription attribution(Attribution attribution)
Description copied from class:ConclusionBuild up this conclusion with attribution.- Overrides:
attributionin classSubject- Parameters:
attribution- The attribution.- Returns:
- this.
-
analysis
public PlaceDescription analysis(Document analysis)
Description copied from class:ConclusionAdd a reference to the analysis for this conclusion.
-
analysis
public PlaceDescription analysis(URI analysis)
Description copied from class:ConclusionAdd a reference to the analysis for this conclusion.
-
extracted
public PlaceDescription extracted(Boolean extracted)
Description copied from class:SubjectBuild up this subject with an extracted flag.
-
identifier
public PlaceDescription identifier(Identifier identifier)
Description copied from class:SubjectBuild up this subject with an identifier.- Overrides:
identifierin classSubject- Parameters:
identifier- The identifier.- Returns:
- this.
-
evidence
public PlaceDescription evidence(EvidenceReference evidence)
Description copied from class:SubjectBuild up this subject with an evidence reference.
-
evidence
public PlaceDescription evidence(PlaceDescription evidence)
-
media
public PlaceDescription media(SourceReference media)
Description copied from class:SubjectBuild up this subject with a media reference.
-
media
public PlaceDescription media(SourceDescription media)
Description copied from class:SubjectBuild up this subject with a media reference.
-
sortKey
public PlaceDescription sortKey(String sortKey)
Description copied from class:ConclusionBuild up this fact with a sort key.
-
names
public Stream<TextValue> names()
Create a stream for the names.- Returns:
- a stream for the names.
-
getNames
public List<TextValue> getNames()
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.- Returns:
- 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.
-
setNames
public void setNames(List<TextValue> names)
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.- Parameters:
names- 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.
-
name
public PlaceDescription name(TextValue name)
Build out this description with a name.- Parameters:
name- The name.- Returns:
- this.
-
name
public PlaceDescription name(String name)
Build out this description with a name.- Parameters:
name- The name.- Returns:
- this.
-
addName
public void addName(TextValue name)
Add a name to the list of standardized names.- Parameters:
name- The name to be added.
-
getType
public URI getType()
An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).- Returns:
- An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).
-
setType
public void setType(URI type)
An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).- Parameters:
type- An implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).
-
type
public PlaceDescription type(URI type)
Build out this place description with a type.- Parameters:
type- The type.- Returns:
- this.
-
getTemporalDescription
public Date getTemporalDescription()
A description of the time period to which this place description is relevant.- Returns:
- A description of the time period to which this place description is relevant.
-
setTemporalDescription
public void setTemporalDescription(Date temporalDescription)
A description of the time period to which this place description is relevant.- Parameters:
temporalDescription- A description of the time period to which this place description is relevant.
-
temporalDescription
public PlaceDescription temporalDescription(Date temporalDescription)
Build out this place description with a temporal description.- Parameters:
temporalDescription- the temporal description.- Returns:
- this.
-
getLatitude
public Double getLatitude()
Degrees north or south of the Equator (0.0 degrees). Values range from −90.0 degrees (south) to 90.0 degrees (north).- Returns:
- Degrees north or south of the Equator.
-
setLatitude
public void setLatitude(Double latitude)
Degrees north or south of the Equator (0.0 degrees). Values range from −90.0 degrees (south) to 90.0 degrees (north).- Parameters:
latitude- Degrees north or south of the Equator.
-
latitude
public PlaceDescription latitude(Double latitude)
Build out this place description with a latitude.- Parameters:
latitude- The latitude.- Returns:
- this.
-
getLongitude
public Double getLongitude()
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).- Returns:
- Angular distance in degrees, relative to the Prime Meridian.
-
setLongitude
public void setLongitude(Double longitude)
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).- Parameters:
longitude- Angular distance in degrees, relative to the Prime Meridian.
-
longitude
public PlaceDescription longitude(Double longitude)
Build out this place description with a longitude.- Parameters:
longitude- The longitude.- Returns:
- this.
-
getSpatialDescription
public ResourceReference getSpatialDescription()
A reference to a geospatial description of this place. It is RECOMMENDED that this description resolve to a KML document.- Returns:
- A reference to a geospatial description of this place.
-
setSpatialDescription
public void setSpatialDescription(ResourceReference spatialDescription)
A reference to a geospatial description of this place. It is RECOMMENDED that this description resolve to a KML document.- Parameters:
spatialDescription- A reference to a geospatial description of this place.
-
spatialDescription
public PlaceDescription spatialDescription(ResourceReference spatialDescription)
Build out this place description with a spacial description.- Parameters:
spatialDescription- The spatial description.- Returns:
- this
-
getJurisdiction
public ResourceReference getJurisdiction()
A reference to a description of the jurisdiction this place.- Returns:
- A reference to a description of the jurisdiction this place.
-
setJurisdiction
public void setJurisdiction(ResourceReference jurisdiction)
A reference to a description of the jurisdiction this place.- Parameters:
jurisdiction- A reference to a description of the jurisdiction this place.
-
jurisdiction
public PlaceDescription jurisdiction(ResourceReference jurisdiction)
Build out this place description with a jurisdiction.- Parameters:
jurisdiction- The reference to the jurisdiction.- Returns:
- this
-
getPlace
public ResourceReference getPlace()
A reference to the place being described.- Returns:
- A reference to the place being described.
-
setPlace
public void setPlace(ResourceReference place)
A reference to the place being described.- Parameters:
place- A reference to the place being described.
-
place
public PlaceDescription place(ResourceReference place)
Build out this place description with a place.- Parameters:
place- The reference to the place.- Returns:
- this
-
getDisplayExtension
public PlaceDisplayProperties getDisplayExtension()
Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.- Returns:
- Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
-
setDisplayExtension
public void setDisplayExtension(PlaceDisplayProperties display)
Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.- Parameters:
display- Display properties for the place. Display properties are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
-
displayExtension
public PlaceDescription displayExtension(PlaceDisplayProperties display)
Build out this place with a display exension.- Parameters:
display- the display.- Returns:
- this
-
accept
public void accept(GedcomxModelVisitor visitor)
Accept a visitor.- Parameters:
visitor- The visitor.
-
embed
public void embed(PlaceDescription place)
Embed another place.- Parameters:
place- The place to embed.
-
-