This page is part of the Situational Awareness for Novel Epidemic Response (v1.0.0: STU 1) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions
This page lists ValueSets, CodeSystems and ConceptMaps used in this guide to illustrate the creation of Measure resources. These terminology resources are illustrative, but not required for use of this guide.
These Value Sets have been defined to illustrate creation of measures using this implementation guide.
These Code Systems have been included to illustrate creation of measures using this implementation guide.
The following Code Systems are defined elsewhere and are used in this guide.
This Concept Map provides a mapping from Location codes identified in the HAvBED2 specification to codes found in HL7 FHIR.
This implementation guide requires the Location resource reference by MeasureReport.subject to have both a name and an identifier. This raises the question of the identifier and identifier system to use for geographic. While facility locations often have identifiers, larger geopolitical boundaries are identified using codes from a coding system, such as ISO 3166, or GIS Information standards from INCITS.
When using a Coding system value in a FHIR Identifier, the value that would normally appear in Coding.code appears in Identifier.value. The value that would normally appear in Coding.system appears in Identifier.system.
The sections below provides a partial list of identifier systems that can be used to identify locations, with a brief description of each one. Measure implementers will need to select the appropriate identifier systems.
The purpose of ISO 3166 is to define internationally recognized codes of letters and/or numbers that we can use when we refer to countries and their subdivisions. Its use is described in Using ISO 3166 Country Codes with FHIR in the FHIR specification.
ISO 3166-1 provides codes for countries. When this code system is used for Location.identifier, the value of Location.identifier.system must be set to urn:iso:std:iso:3166.
ISO 3166-2 provides codes for subdivisions of countries (i.e., states, provinces, territories or similar regions). When this code system is used for Location.identifier, the value of Location.identifier.system must be set to urn:iso:std:iso:3166:-2.
ISO 3166-1 provides three different codes for a country, a two letter code, a three letter code, and a numeric code. The two letter code for the US is ‘US’, the three letter code is USA, and the numeric code is 840. At most one of these codes should be used to identify locations at a country level. The FHIR standard identifies three different value sets for this use:
Most developers are familiar with the use of ISO 3166 as it is used in RFC 5646 Tags for Identifying Languages which prefers use of the ISO 3166 Part 1: 2 letter codes. Measures should use the two letter codes when using ISO-3166 Part 1.
Establishes a structure for the assignment of identifying data codes to counties and county equivalents of the United States and its insular and associated areas, for the purpose of information interchange among data processing systems.
This standard establishes a structure for the assignment of identifying codes to states and state equivalents of the United States and its insular areas.
This standard provides a set of two-digit numeric codes and a set of two-letter alphabetic codes for representing the 50 states, the District of Columbia and the outlying areas of the United States, and associated areas. The standard covers all land areas under the sovereignty of the United States, the freely associated states of Federated States of Micronesia and Marshall Islands, and the trust territory of Palau. This revision supersedes FIPS PUB 5-1 in its entirety.
Note: FIPS 5-2 was withdrawn as a US Information Processing standard in 2008 to be replaced by INCITS 31-2009, but was still used for the US 2010 census. Some Geographic Information Systems used in the US still report the FIPS 5-2 code for a region.
This standard provides the names and codes that represent the counties and other entities treated as the equivalents of counties for legal and/or statistical purposes in the 50 States, the District of Columbia, and the possessions (American Samoa, Guam, Northern Mariana Islands, Palau, Puerto Rico, and Virgin Islands of the United States) and freely associated areas (Federated States of Micronesia and Marshall Islands) of the United States. Palau is the last remaining component of the Trust Territory of the Pacific Islands (TTPI); for presentation purposes, Palau, rather than the TTPI, is treated as the State-equivalent entity.
Note: FIPS 6-4 was withdrawn as a US Information Processing standard in 2008 to be replaced by INCITS 38-2009, but was still used for the US 2010 census. Some Geographic Information Systems used in the US still report the FIPS 6-4 code for a region.
The Dartmouth Atlas defines three different kinds of Geographic regions in the US. These regions describe service areas and referral regions with common characteristics based on geography and population, and are used for some forms of statistical health research. These identifiers are often found in data sets provided by geographic information systems. Cross walks and geographic boundary files for each of these areas can be found at the link above.
An HSA is a collection of ZIP codes whose residents receive most of their hospitalizations from the hospitals in that area. The identifier system for HSA is http://terminology.hl7.org/codesystem/dartmouthatlas/HSA.
HRRs were defined by assigning HSAs to the region where the greatest proportion of major cardiovascular procedures were performed, with minor modifications to achieve geographic contiguity, a minimum population size of 120,000, and a high localization index. The identifier system for HRR is http://terminology.hl7.org/codesystem/dartmouthatlas/HRR
A PCSA is the smallest geographic area (identified by ZIP code) that can be considered a discrete service area for primary care. The identifier system for PCSA is http://terminology.hl7.org/codesystem/dartmouthatlas/PCSA
National codes used with postal systems also define geographic areas. These code systems are generally managed by national postal services. A list of known values to use for the postal code system is provided below:
For measure reporting used within a single country, systems should use nationally recognized standard coding systems for Location.identifier, or if there is no such standard, ISO 3166. For measure reporting that supports reporting from multiple countries, systems should use ISO 3166.