Package org.gbif.api.model.checklistbank
Class Distribution
java.lang.Object
org.gbif.api.model.checklistbank.Distribution
- All Implemented Interfaces:
NameUsageExtension
Distribution Model Object represents a species distribution.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
The CITES (Convention on International Trade in Endangered Species of Wild Fauna and Flora) Appendix number under which the taxon is listed.@Min(1L) @Max(366L) Integer
Seasonal temporal subcontext within the eventDate context.Term describing whether the organism occurs natively, is introduced or cultivated.The distribution information pertains solely to a specific life stage of the taxon.The verbatim name of the area this distribution record is about.A code for the named area this distributon record is about.Additional notes on the distribution.Source reference for this distribution record.If the source is another name usage this is the taxonKey of that usage.@Min(1L) @Max(366L) Integer
Seasonal temporal subcontext within the eventDate context.Term describing the occurrence status of the organism in the given area based on how frequent the species occurs.The name usage "taxon" key this description belongs to.Relevant temporal context for this entire distribution record including all properties preferably given as a year range or single year on which the distribution record is valid.Threat status of a species as defined by IUCN (http://www.iucnredlist.org/static/categories_criteria_3_1#categories).int
hashCode()
void
setAppendixCites
(CitesAppendix appendixCites) void
setCountry
(Country country) void
setEndDayOfYear
(Integer endDayOfYear) void
setEstablishmentMeans
(EstablishmentMeans establishmentMeans) void
setLifeStage
(LifeStage lifeStage) void
setLocality
(String locality) void
setLocationId
(String locationId) void
setRemarks
(String remarks) void
void
setSourceTaxonKey
(Integer sourceTaxonKey) void
setStartDayOfYear
(Integer startDayOfYear) void
setStatus
(DistributionStatus status) void
setTaxonKey
(Integer taxonKey) void
setTemporal
(String temporal) void
setThreatStatus
(ThreatStatus threatStatus) toString()
-
Constructor Details
-
Distribution
public Distribution()
-
-
Method Details
-
getTaxonKey
The name usage "taxon" key this description belongs to.- Specified by:
getTaxonKey
in interfaceNameUsageExtension
-
setTaxonKey
- Specified by:
setTaxonKey
in interfaceNameUsageExtension
-
getAppendixCites
The CITES (Convention on International Trade in Endangered Species of Wild Fauna and Flora) Appendix number under which the taxon is listed. It is possible to have different appendix numbers for different areas, but "global" as an area is also valid if it's the same worldwide see also http://www.cites.org/eng/app/index.shtmlExample: II
- Returns:
- the appendixCites.
-
setAppendixCites
- Parameters:
appendixCites
- the appendixCites to set
-
getCountry
- Returns:
- the country
-
setCountry
- Parameters:
country
- the country to set
-
getEndDayOfYear
Seasonal temporal subcontext within the eventDate context. The latest ordinal day of the year on which the distribution record is valid.Example: 120
- Returns:
- the endDayOfYear.
-
setEndDayOfYear
- Parameters:
endDayOfYear
- the endDayOfYear to set
-
getEstablishmentMeans
Term describing whether the organism occurs natively, is introduced or cultivated.Example: introduced
- Returns:
- the establishmentMeans
-
setEstablishmentMeans
- Parameters:
establishmentMeans
- the establishmentMeans to set
-
getLifeStage
The distribution information pertains solely to a specific life stage of the taxon.Example: adult
- Returns:
- the lifeStage
- See Also:
-
setLifeStage
- Parameters:
lifeStage
- the lifeStage to set
-
getLocality
The verbatim name of the area this distribution record is about.Example: Patagonia
- Returns:
- the locality
-
setLocality
- Parameters:
locality
- the locality to set
-
getLocationId
A code for the named area this distributon record is about. See http://en.wikipedia.org/wiki/ISO_3166-2 for state codes within a country, otherwise use a prefix for each code to indicate the source of the code.Example: TDWG:AGS-TF Example: ISO3166:AR Example: WOEID:564721
- Returns:
- the location id
-
setLocationId
- Parameters:
locationId
- the locationId to set
-
getRemarks
Additional notes on the distribution.- Returns:
- the notes
-
setRemarks
-
getSource
Source reference for this distribution record. Can be proper publication citation, a webpage URL, etc.Example: "Euro+Med Plantbase - the information resource for Euro-Mediterranean plant diversity (2006-). Published on the Internet http://ww2.bgbm.org/EuroPlusMed/ July, 2009"
- Specified by:
getSource
in interfaceNameUsageExtension
- Returns:
- the source
-
setSource
- Specified by:
setSource
in interfaceNameUsageExtension
- Parameters:
source
- the source to set
-
getSourceTaxonKey
Description copied from interface:NameUsageExtension
If the source is another name usage this is the taxonKey of that usage. Only useful for the backbone dataset.- Specified by:
getSourceTaxonKey
in interfaceNameUsageExtension
- Returns:
- The key of the name usage this instance is derived from.
-
setSourceTaxonKey
- Specified by:
setSourceTaxonKey
in interfaceNameUsageExtension
-
getStartDayOfYear
Seasonal temporal subcontext within the eventDate context. Useful for migratory species. The earliest ordinal day of the year on which the distribution record is valid. Numbering starts with 1 for 1 January and ends with 365 or 366 for 31 December.Example: 90
- Returns:
- the startDayOfYear.
-
setStartDayOfYear
- Parameters:
startDayOfYear
- the startDayOfYear to set
-
getStatus
Term describing the occurrence status of the organism in the given area based on how frequent the species occurs.Example: absent
- Returns:
- the status.
- See Also:
-
- occurrence status vocabulary for recommended values
-
setStatus
- Parameters:
status
- the status to set
-
getTemporal
Relevant temporal context for this entire distribution record including all properties preferably given as a year range or single year on which the distribution record is valid. For the same area and taxon there could therefore be several records with different temporal context, e.g. in 5-year intervals for invasive species.Example: "1930"; "1939-1945"
- Returns:
- the temporal
-
setTemporal
- Parameters:
temporal
- the temporal to set
-
getThreatStatus
Threat status of a species as defined by IUCN (http://www.iucnredlist.org/static/categories_criteria_3_1#categories).Examples: "EX" - "EW" - "CR"
- Returns:
- the threatStatus.
- See Also:
-
setThreatStatus
- Parameters:
threatStatus
- the threatStatus to set
-
equals
-
hashCode
-
toString
-