Package org.opengis.metadata.identification

Interface Usage

@UML(identifier="MD_Usage",
     specification=ISO_19115)
public interface Usage

Brief description of ways in which the resource(s) is/are currently or has been used.

Since:

2.0

Method Summary

Modifier and Type	Method	Description
default Collection<? extends Citation>	getAdditionalDocumentation()	Publications that describe usage of data.
default Collection<? extends Citation>	getIdentifiedIssues()	Citations of a description of known issues associated with the resource along with proposed solutions if available.
default Collection<? extends InternationalString>	getResponses()	Responses to the user-determined limitations.
InternationalString	getSpecificUsage()	Brief description of the resource and/or resource series usage.
default Date	getUsageDate()	Date and time of the first use or range of uses of the resource and/or resource series.
default Collection<? extends ResponsibleParty>	getUserContactInfo()	Identification of and means of communicating with person(s) and organization(s) using the resource(s).
default InternationalString	getUserDeterminedLimitations()	Applications, determined by the user for which the resource and/or resource series is not suitable.

Method Detail

getSpecificUsage

@UML(identifier="specificUsage",
     obligation=MANDATORY,
     specification=ISO_19115)
InternationalString getSpecificUsage()

Brief description of the resource and/or resource series usage.

Returns:

description of the resource usage.

getUsageDate

@UML(identifier="usageDateTime",
     obligation=OPTIONAL,
     specification=ISO_19115)
default Date getUsageDate()

Date and time of the first use or range of uses of the resource and/or resource series.

Upcoming API change — temporal schema
The return type of this method may change in GeoAPI 4.0 release. It may be replaced by a type matching more closely either ISO 19108 (Temporal Schema) or ISO 19103.

Returns:

date of the first use of the resource, or null.

TODO:

This become a collection in ISO 19115:2014.

getUserDeterminedLimitations

@UML(identifier="userDeterminedLimitations",
     obligation=OPTIONAL,
     specification=ISO_19115)
default InternationalString getUserDeterminedLimitations()

Applications, determined by the user for which the resource and/or resource series is not suitable.

Returns:

applications for which the resource and/or resource series is not suitable, or null.

getUserContactInfo

@UML(identifier="userContactInfo",
     obligation=OPTIONAL,
     specification=ISO_19115)
default Collection<? extends ResponsibleParty> getUserContactInfo()

Identification of and means of communicating with person(s) and organization(s) using the resource(s). Returns an empty collection if none.

Upcoming API change — generalization
As of ISO 19115:2014, ResponsibleParty is replaced by the Responsibility parent interface. This change may be applied in GeoAPI 4.0.

Returns:

means of communicating with person(s) and organization(s) using the resource(s).

getResponses

@UML(identifier="response",
     obligation=OPTIONAL,
     specification=ISO_19115)
default Collection<? extends InternationalString> getResponses()

Responses to the user-determined limitations.

Example: This has been fixed in version x.

Returns:

responses to the user-determined limitations.

Since:

3.1

getAdditionalDocumentation

@UML(identifier="additionalDocumentation",
     obligation=OPTIONAL,
     specification=ISO_19115)
default Collection<? extends Citation> getAdditionalDocumentation()

Publications that describe usage of data.

Returns:

publications that describe usage of data.

Since:

3.1

getIdentifiedIssues

@UML(identifier="identifiedIssues",
     obligation=OPTIONAL,
     specification=ISO_19115)
default Collection<? extends Citation> getIdentifiedIssues()

Citations of a description of known issues associated with the resource along with proposed solutions if available.

Returns:

citations of a description of known issues associated with the resource.

Since:

3.1