HL7® FHIR® New Zealand Base Implementation Guide
3.0.1 - Draft

HL7® FHIR® New Zealand Base Implementation Guide - Local Development build (v3.0.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Extension: NZ Geocode

Official URL: http://hl7.org.nz/fhir/StructureDefinition/nz-geocode | Version: 0.1.0
Active as of 2020-07-20 | Computable Name: Nz_geocode
Copyright/Legal: HL7 New Zealand© 2020+; Licensed Under Creative Commons No Rights Reserved.

New Zealand Geocode. This uses a different datum from that defined in the HL7 FHIR specification for a Geocode.

Context of Use

This extension may be used on the following element(s):

- Element ID Address

Example of extension

    <extension url = http://hl7.org.nz/fhir/StructureDefinition/nz-geocode>
         <extension url= "latitude">
          <valueDecimal value="-35.99">
        </extension>
        <extension url= "longitude">
          <valueDecimal value="174.47">
        </extension>
        <extension url="datumCode">
          <valueCodeableConcept>
            <coding>
              <system value="https://standards.digital.health.nz/ns/nz-datum-code"/>
              <code value="NZGD2000"/>
              <display value="Nz official datum, used by MoH address service"/>
            </coding>
          </valueCodeableConcept>
        </extension>
    </extension>

Example instances

Patient with geocoded address

Usage info

Usage:

- Use this Extension: Common NZ Address datatype
- Examples for this Extension: Patient/patient-nz-geocode

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Text Summary
- Differential Table
- Snapshot Table
- All

This structure is derived from Extension

Summary

Complex Extension: New Zealand Geocode. This uses a different datum from that defined in the HL7 FHIR specification for a Geocode.

- latitude: decimal: The latitude of the geocode
- longitude: decimal: The longitude of the geocode
- datumCode: CodeableConcept: The datum used for the lat/long

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | NZ Geocode
extension |  | 2..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:latitude |  | 1..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "latitude"
value[x] |  | 0..1 | decimal | Value of extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:longitude |  | 1..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "longitude"
value[x] |  | 0..1 | decimal | Value of extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:datumCode |  | 0..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "datumCode"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: Datum code (preferred)
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/nz-geocode"
value[x] |  | 0..0 |  |
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | NZ Geocode
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:latitude |  | 1..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "latitude"
value[x] |  | 0..1 | decimal | Value of extension
extension:longitude |  | 1..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "longitude"
value[x] |  | 0..1 | decimal | Value of extension
extension:datumCode |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "datumCode"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: Datum code (preferred)
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/nz-geocode"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: New Zealand Geocode. This uses a different datum from that defined in the HL7 FHIR specification for a Geocode.

- latitude: decimal: The latitude of the geocode
- longitude: decimal: The longitude of the geocode
- datumCode: CodeableConcept: The datum used for the lat/long

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | NZ Geocode
extension |  | 2..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:latitude |  | 1..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "latitude"
value[x] |  | 0..1 | decimal | Value of extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:longitude |  | 1..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "longitude"
value[x] |  | 0..1 | decimal | Value of extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:datumCode |  | 0..1 | Extension | Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "datumCode"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: Datum code (preferred)
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/nz-geocode"
value[x] |  | 0..0 |  |
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | NZ Geocode
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:latitude |  | 1..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "latitude"
value[x] |  | 0..1 | decimal | Value of extension
extension:longitude |  | 1..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "longitude"
value[x] |  | 0..1 | decimal | Value of extension
extension:datumCode |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "datumCode"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: Datum code (preferred)
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/nz-geocode"
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Extension.extension:datumCode.value[x] | preferred | DatumCode (a valid code from Datum codes) `https://nzhts.digital.health.nz/fhir/ValueSet/nz-datum-code` from this IG