Skip to content
This repository has been archived by the owner on Oct 19, 2023. It is now read-only.

Property:countryCode #140

Open
mtrekels opened this issue Nov 26, 2019 · 7 comments
Open

Property:countryCode #140

mtrekels opened this issue Nov 26, 2019 · 7 comments
Assignees
Labels
Class:GeographicContext data model issues related to data model subtasks done Reviewed and ready to go include in version 1 vocabulary:needed terms that needs controlled vocabularies

Comments

@mtrekels
Copy link
Contributor

mtrekels commented Nov 26, 2019

Label Country Code
Definition The standard code for the country in which the Location occurs.
Usage The standard code for the country in which the objects held in the collection were collected.
Existing property dwc:countryCode
Existing class Location
Existing property identifier http://rs.tdwg.org/dwc/terms/countryCode
Format Text
Required No
Repeatable No
Constraints
Examples AR SV CN
Notes This terms refers to the code of the country from which the collection originated. Recommended best practice is to use an ISO 3166-1-alpha-2 country code.
@mtrekels mtrekels added data model issues related to data model subtasks Class:GeographicContext labels Nov 26, 2019
@mtrekels mtrekels added this to To do in Data model - GeographicOrigin via automation Nov 26, 2019
@nielsraes
Copy link

nielsraes commented Mar 16, 2020

Format: List - A collection often covers multiple countries
http://rs.tdwg.org/dwc/terms/countryCode --> Recommended best practice is to use ISO 3166-1-alpha-2 country codes.
Should be linked to country

@pzermoglio
Copy link
Member

Updating definition to match dwc

Definition The standard code for the country in which the Location occurs.
Dimension
Existing property dwc:countryCode
Existing class Location
Existing property identifier http://rs.tdwg.org/dwc/terms/countryCode
Format controlled vocabulary
Required
Repeatable
Constraints
Examples AR, SV, CN
Notes This terms refers to the code of the country from which the collection originated. Recommended best practice is to use an ISO 3166-1-alpha-2 country code.

mtrekels added a commit that referenced this issue Mar 27, 2020
Implementing comments of issues:
#141, #143, #132, #133, #137, #138, #139, #135, #140
mswoodburn added a commit that referenced this issue Mar 27, 2020
Implementing comments of issues:
#141, #143, #132, #133, #137, #138, #139, #135, #140
mswoodburn added a commit that referenced this issue Mar 27, 2020
@debpaul debpaul added the vocabulary:needed terms that needs controlled vocabularies label Mar 27, 2020
@essvee essvee self-assigned this Apr 30, 2020
@essvee essvee moved this from To do to In progress in Data model - GeographicOrigin Apr 30, 2020
@essvee
Copy link
Contributor

essvee commented Jun 4, 2020

Format: List - A collection often covers multiple countries
http://rs.tdwg.org/dwc/terms/countryCode --> Recommended best practice is to use ISO 3166-1-alpha-2 country codes.
Should be linked to country

Outcome of subsequent discussion about this point within the group: Where multiple categorical values are relevant/required for a collection description object, we should avoid concatenating these values into a single string-y property, and instead encourage people to attach multiple GeographicOrigin classes to a single Collection Description.

So, I've set this property as not-repeatable, but as the parent GeoOrigin class is repeatable the capacity to affiliate multiple countries to one collection is preserved.

@essvee essvee moved this from In progress to Review in progress in Data model - GeographicOrigin Jun 4, 2020
@wouteraddink
Copy link
Contributor

wouteraddink commented Jun 4, 2020 via email

@fmjjones fmjjones added the done Reviewed and ready to go label Feb 17, 2022
@ben-norton
Copy link
Member

ben-norton commented Feb 19, 2022

See the following file for country codes. The two files are exactly the same apart from different file types.
http://data.naturalsciences.org/data/geography/countries.csv
http://data.naturalsciences.org/data/geography/countries.xlsx
The files contain the following:
ISO 3166 alpha-2 codes (2 Letter Country Codes)
ISO 3166 alpha-3 codes (3 Letter Country Codes
ISO 3166 Numeric Country Codes
US Board of Geographic Names - Short Form
US Board of Geographic Names - Long Form
ISO Country Short Name - English
ISO Country Short Name - French
ISO Country Short Name - Spanish
Source

Country codes are unambiguous. A country name can have more than a dozen variations. If you provide the country code, then the end-user can convert that to the form and language of their choosing (The file upload was simpler than the aforementioned API endpoint).

@tucotuco
Copy link
Member

tucotuco commented Feb 19, 2022 via email

@wouteraddink
Copy link
Contributor

As I said before, countries are political regions, not geographic regions, and iso country codes refer to the political region and do not change if the geograpic area of a country changes. Since in our data we usually want to indicate geograpic origin and not political region, if countries cannot be avoided then country codes should be used that are linked to a geographic shape and time period for which they are valid.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Class:GeographicContext data model issues related to data model subtasks done Reviewed and ready to go include in version 1 vocabulary:needed terms that needs controlled vocabularies
Projects
Data model - GeographicOrigin
  
Review in progress
Development

No branches or pull requests

9 participants