| Copyright | (c) 2023 Finley McIlwaine |
|---|---|
| License | MIT (see LICENSE) |
| Maintainer | Finley McIlwaine <finleymcilwaine@gmail.com> |
| Safe Haskell | Safe-Inferred |
| Language | Haskell2010 |
Data.EBird.API.Taxonomy
Description
Types related to eBird taxonomy-related API values.
Synopsis
- data Taxon = Taxon {
- _taxonScientificName :: Text
- _taxonCommonName :: Text
- _taxonSpeciesCode :: SpeciesCode
- _taxonCategory :: TaxonomyCategory
- _taxonTaxonOrder :: Double
- _taxonBandingCodes :: [Text]
- _taxonCommonNameCodes :: [Text]
- _taxonScientificNameCodes :: [Text]
- _taxonOrder :: Text
- _taxonFamilyCode :: Maybe Text
- _taxonFamilyCommonName :: Maybe Text
- _taxonFamilyScientificName :: Maybe Text
- newtype SpeciesCode = SpeciesCode {
- speciesCode :: Text
- newtype SpeciesCodes = SpeciesCodes {
- speciesCodes :: [SpeciesCode]
- data TaxonomyCategory
- newtype TaxonomyCategories = TaxonomyCategories {}
- taxonTaxonOrder :: Lens' Taxon Double
- taxonSpeciesCode :: Lens' Taxon SpeciesCode
- taxonScientificNameCodes :: Lens' Taxon [Text]
- taxonScientificName :: Lens' Taxon Text
- taxonOrder :: Lens' Taxon Text
- taxonFamilyScientificName :: Lens' Taxon (Maybe Text)
- taxonFamilyCommonName :: Lens' Taxon (Maybe Text)
- taxonFamilyCode :: Lens' Taxon (Maybe Text)
- taxonCommonNameCodes :: Lens' Taxon [Text]
- taxonCommonName :: Lens' Taxon Text
- taxonCategory :: Lens' Taxon TaxonomyCategory
- taxonBandingCodes :: Lens' Taxon [Text]
- data SPPLocale
- = Af
- | Sq
- | Ar
- | Hy
- | As
- | Ast
- | Az
- | Eu
- | Bn
- | Bg
- | Ca
- | Zh
- | Zh_SIM
- | Ht_HT
- | Hr
- | Cs
- | Da
- | Nl
- | En
- | En_AU
- | En_BD
- | En_HAW
- | En_HBW
- | En_IN
- | En_IOC
- | En_KE
- | En_MY
- | En_NZ
- | En_PH
- | En_ZA
- | En_AE
- | En_UK
- | En_US
- | Fo
- | Fi
- | Fr
- | Fr_AOU
- | Fr_FR
- | Fr_CA
- | Fr_GF
- | Fr_GP
- | Fr_HT
- | Gl
- | De
- | El
- | Gu
- | He
- | Hi
- | Hu
- | Is
- | In
- | It
- | Ja
- | Ko
- | Lv
- | Lt
- | Ml
- | Mr
- | Mn
- | No
- | Or
- | Fa
- | Pl
- | Pt_AO
- | Pt_RAA
- | Pt_Br
- | Pt_RAM
- | Pt_PT
- | Ro
- | Ru
- | Sr
- | Sk
- | Sl
- | Es
- | Es_AR
- | Es_CL
- | Es_CR
- | Es_CU
- | Es_DO
- | Es_EC
- | Es_HN
- | Es_MX
- | Es_PA
- | Es_PY
- | Es_PE
- | Es_PR
- | Es_ES
- | Es_UY
- | Es_VE
- | Sv
- | Te
- | Th
- | Tr
- | Uk
- data SPPLocaleListEntry = SPPLocaleListEntry {}
- data SPPGrouping
- data TaxonomicGroupListEntry = TaxonomicGroupListEntry {}
- data TaxonomyVersionListEntry = TaxonomyVersionListEntry {}
- sppLocaleListEntryName :: Lens' SPPLocaleListEntry Text
- sppLocaleListEntryLastUpdate :: Lens' SPPLocaleListEntry Text
- sppLocaleListEntryCode :: Lens' SPPLocaleListEntry SPPLocale
- taxonomicGroupListEntryOrderBounds :: Lens' TaxonomicGroupListEntry [(Integer, Integer)]
- taxonomicGroupListEntryOrder :: Lens' TaxonomicGroupListEntry Integer
- taxonomicGroupListEntryName :: Lens' TaxonomicGroupListEntry Text
- taxonomyVersionLatest :: Lens' TaxonomyVersionListEntry Bool
- taxonomyVersionAuthorityVersion :: Lens' TaxonomyVersionListEntry Double
- parseSpeciesCode :: Parser SpeciesCode
- parseSpeciesCodes :: Parser SpeciesCodes
- parseTaxonomyCategory :: Parser TaxonomyCategory
- parseTaxonomyCategories :: Parser TaxonomyCategories
- parseSPPLocale :: Parser SPPLocale
- parseSPPGrouping :: Parser SPPGrouping
Taxonomy types
Taxa in the eBird taxonomy.
Constructors
| Taxon | |
Fields
| |
Instances
newtype SpeciesCode Source #
eBird species codes, simply Text; e.g. Gray Vireo is "gryvir", Field
Sparrow is "fiespa".
Constructors
| SpeciesCode | |
Fields
| |
Instances
newtype SpeciesCodes Source #
A list of eBird SpeciesCodes.
Constructors
| SpeciesCodes | |
Fields
| |
Instances
data TaxonomyCategory Source #
The taxonomy categories are explained in the eBird documentation. Their examples are echoed in the documentation of the constructors of this type.
Constructors
| Species | The |
| Spuh | Genus or broad identification, e.g. "swan sp. Cygnus sp." |
| ISSF | Identifiable subspecies or group of subspecies, e.g. "Tundra Swan (Bewick’s) Cygnus columbianus bewickii" or "Tundra Swan (Whistling) Cygnus columbianus columbianus" |
| Slash | Identification to species pair, e.g. "Tundra/Trumpeter Swan Cygnus columbianus/buccinator" |
| Hybrid | Hybrid between two species, e.g. "Tundra x Trumpeter Swan (hybrid)" |
| Intergrade | Hybrid between two ISSF (subspecies or subspecies groups), e.g. "Tundra Swan (Whistling x Bewick’s) Cygnus columbianus columbianus x bewickii" |
| Domestic | Distinctly-plumaged domesticated varieties that may be free-flying (these do not count on personal lists), e.g. "Mallard (Domestic type)" |
| Form | Miscellaneous other taxa, including recently-described species yet to be accepted or distinctive forms that are not universally accepted, e.g. Red-tailed Hawk (abieticola), Upland Goose (Bar-breasted). |
Instances
newtype TaxonomyCategories Source #
TaxonomyCategories values contain a NonEmpty list of
TaxonomyCategorys.
Constructors
| TaxonomyCategories | |
Instances
Optics for taxonomy types
Auxiliary eBird taxonomy-related API types
eBird maintains many common name translations. See their "Bird Names in eBird" documentation for a discussion of the languages they support.
This type is an enumeration of those languages, and is used to support the eBird API endpoints which allow a locale to be specified.
Constructors
| Af | Afrikaans |
| Sq | Albanians |
| Ar | Arabic |
| Hy | Armenian |
| As | Assamese |
| Ast | Asturian |
| Az | Azerbaijani |
| Eu | Basque |
| Bn | Bengali |
| Bg | Bulgarian |
| Ca | Catalan |
| Zh | Chinese, Mandarin (traditional) |
| Zh_SIM | Chinese, Simple |
| Ht_HT | Creole, Haiti |
| Hr | Croatian |
| Cs | Czech |
| Da | Danish |
| Nl | Dutch |
| En | English |
| En_AU | English, Australia |
| En_BD | English, Bangladesh |
| En_HAW | English, Hawaii |
| En_HBW | English, HBW |
| En_IN | English, India |
| En_IOC | English, IOC |
| En_KE | English, Kenya |
| En_MY | English, Malaysia |
| En_NZ | English, New Zealand |
| En_PH | English, Philippines |
| En_ZA | English, South Africa |
| En_AE | English, UAE |
| En_UK | English, United Kingdon |
| En_US | English, United States |
| Fo | Faroese |
| Fi | Finnish |
| Fr | French |
| Fr_AOU | French, AOU |
| Fr_FR | French, France |
| Fr_CA | French, Canada |
| Fr_GF | French, Guiana |
| Fr_GP | French, Guadeloupe |
| Fr_HT | French, Haiti |
| Gl | Gallegan |
| De | German |
| El | Greek |
| Gu | Gujarati |
| He | Hebrew |
| Hi | Hindi |
| Hu | Hungarian |
| Is | Icelandic |
| In | Indonesian |
| It | Italian |
| Ja | Japanese |
| Ko | Korean |
| Lv | Latvian |
| Lt | Lithuanian |
| Ml | Malayalam |
| Mr | Marathi |
| Mn | Mongolian |
| No | Norwegian |
| Or | Odia |
| Fa | Persian |
| Pl | Polish |
| Pt_AO | Portuguese, Angola |
| Pt_RAA | Portuguese, Azores |
| Pt_Br | Portuguese, Brazil |
| Pt_RAM | Portuguese, Madeira |
| Pt_PT | Portuguese, Portugal |
| Ro | Romanian |
| Ru | Russian |
| Sr | Serbian |
| Sk | Slovak |
| Sl | Slovenian |
| Es | Spanish |
| Es_AR | Spanish, Argentina |
| Es_CL | Spanish, Chile |
| Es_CR | Spanish, Costa Rica |
| Es_CU | Spanish, Cuba |
| Es_DO | Spanish, Dominican Republic |
| Es_EC | Spanish, Ecuador |
| Es_HN | Spanish, Honduras |
| Es_MX | Spanish, Mexico |
| Es_PA | Spanish, Panama |
| Es_PY | Spanish, Paraguay |
| Es_PE | Spanish, Peru |
| Es_PR | Spanish, Puerto Rico |
| Es_ES | Spanish, Spain |
| Es_UY | Spanish, Uruguay |
| Es_VE | Spanish, Venezuela |
| Sv | Swedish |
| Te | Telugu |
| Th | Thai |
| Tr | Turkish |
| Uk | Ukrainian |
Instances
| IsString SPPLocale Source # | Use this instance carefully! It throws runtime exceptions if the string is malformatted. |
Defined in Data.EBird.API.Taxonomy Methods fromString :: String -> SPPLocale # | |
| Read SPPLocale Source # | |
| Show SPPLocale Source # | |
| EBirdString SPPLocale Source # | The eBird strings of the species locales are simply the lowercase constructor names. |
Defined in Data.EBird.API.Taxonomy | |
| Eq SPPLocale Source # | |
| ToHttpApiData SPPLocale Source # | |
Defined in Data.EBird.API.Taxonomy Methods toUrlPiece :: SPPLocale -> Text # toEncodedUrlPiece :: SPPLocale -> Builder # toHeader :: SPPLocale -> ByteString # toQueryParam :: SPPLocale -> Text # toEncodedQueryParam :: SPPLocale -> Builder # | |
| FromJSON SPPLocale Source # | |
| ToJSON SPPLocale Source # | |
Defined in Data.EBird.API.Taxonomy | |
data SPPLocaleListEntry Source #
Values returned from the TaxaLocaleCodesAPI.
Constructors
| SPPLocaleListEntry | |
Fields
| |
Instances
data SPPGrouping Source #
Values represent the different ways that taxonomic groups may be grouped.
MerlinGrouping puts like birds together, with falcons next to hawks.
EBirdGrouping follows taxonomic order.
Constructors
| MerlinGrouping | |
| EBirdGrouping |
Instances
data TaxonomicGroupListEntry Source #
Values returned by the TaxonomicGroupsAPI.
Constructors
| TaxonomicGroupListEntry | |
Fields
| |
Instances
data TaxonomyVersionListEntry Source #
Values returned by the TaxonomyVersionsAPI.
Constructors
| TaxonomyVersionListEntry | |
Instances
Optics for taxonomy-related types
attoparsec parsers
parseSpeciesCode :: Parser SpeciesCode Source #
Parse an eBird species code, which we loosely assume is a string of one or more alphanumeric characters.
parseSpeciesCodes :: Parser SpeciesCodes Source #
Parse a comma separated list of zero or more SpeciesCodes
parseTaxonomyCategory :: Parser TaxonomyCategory Source #
Parse an eBird TaxonomyCategory.
parseSPPGrouping :: Parser SPPGrouping Source #
Parse an eBird SPPGrouping.