TG2-VALIDATION_GEOGRAPHY_CONSISTENT

[iDigBioBot]

TestField	Value
GUID	78640f09-8353-411a-800e-9b6d498fb1c9
Label	VALIDATION_GEOGRAPHY_CONSISTENT
Description	Is the combination of the values of the terms dwc:continent, dwc:country, dwc:countryCode, dwc:stateProvince, dwc:county, dwc:municipality consistent with the bdq:sourceAuthority?
TestType	Validation
Darwin Core Class	Location
Information Elements ActedUpon	dwc:continent
	dwc:country
	dwc:countryCode
	dwc:stateProvince
	dwc:county
	dwc:municipality
Information Elements Consulted
Expected Response	EXTERNAL_PREREQUISITES_NOT_MET if the bdq:sourceAuthority is not available; INTERNAL_PREREQUISITES_NOT_MET if all of the terms dwc:continent, dwc:country, dwc:countryCode, dwc:stateProvince, dwc:county, dwc:municipality are bdq:Empty; COMPLIANT if the combination of values of dwc:continent, dwc:country, dwc:countryCode, dwc:stateProvince, dwc:county, dwc:municipality are consistent in the bdq:sourceAuthority; otherwise NOT_COMPLIANT
Data Quality Dimension	Conformance
Term-Actions	GEOGRAPHY_CONSISTENT
Parameter(s)	bdq:sourceAuthority
Source Authority	bdq:sourceAuthority default = "The Getty Thesaurus of Geographic Names (TGN)" [https://www.getty.edu/research/tools/vocabularies/tgn/index.html]
Specification Last Updated	2024-09-18
Examples	[dwc:continent="", dwc:country="Australia", dwc:countryCode="", dwc:stateProvince="WA", dwc:county="", dwc:municipality="": Response.status=RUN_HAS_RESULT, Response.result=COMPLIANT, Response.comment="dwc:stateProvince matches dwc:country"]
	[dwc:continent="", dwc:country="", dwc:countryCode="", dwc:stateProvince="WA", dwc:county="", dwc:municipality="": Response.status=RUN_HAS_RESULT, Response.result=NOT_COMPLIANT, Response.comment="dwc:stateProvince ambiguous as "WA" could be the state of Washington in the United States or Western Australia in Australia"]
Source	VertNet, Kurator
References	Chapman, AD and Wieczorek, JR (2020). Georeferencing Best Practices. Copenhagen: GBIF Secretariat (https://doi.org/10.15468/doc-gg7h-s853) VertNet (2019). DwCVocabs (https://github.com/VertNet/DwCVocabs/blob/master/vocabs/Geography.csv) Getty Reseach Institute (2017). Getty Thesaurus of Geographic Names Online (https://www.getty.edu/research/tools/vocabularies/tgn/index.html)
Example Implementations (Mechanisms)	Kurator
Link to Specification Source Code	https://github.com/kurator-org/kurator-validation/blob/master/packages/kurator_dwca/workflows/dwca_geography_assessor.yaml
Notes	A fail condition may arise from the content being internally inconsistent (not all of the information can be true at the same time), or from the vocabulary being incapable of resolving the combination of geography field values. Additional tests could be devised against a geographic authority to report the distinct failure conditions. This test specifically does not consider the content of dwc:higherGeography. Note: that for this test to work, the lowest ranking element must be present and the higher ranking elements be consistent with it. This test is not recommended be implemented because of one or more of the following criteria: Unavailable vocabularies; available vocabularies are ambiguous; too difficult to code; too complex to currently implement; implementation could lead to ambiguous or inaccurate results.

[iDigBioBot]

Comment by John Wieczorek (@tucotuco) migrated from spreadsheet:
This is a comprehensive geography comparison, not a field-by-field comparison. Example lookup table at https://github.com/VertNet/DwCVocabs/blob/master/vocabs/Geography.csv

[ArthurChapman]

This may not be the best example

[godfoder]