ARCHETYPE Address (openEHR-EHR-CLUSTER.address.v1)

ARCHETYPE IDopenEHR-EHR-CLUSTER.address.v1
ConceptAddress
DescriptionDetails about the location of a person, physical building or landmark.
UseUse to record details about the location of a person, physical building or landmark as they are known or understood in the course of clinical documentation, often ad hoc or when it is not appropriate or possible to use an address lookup service. Examples include: - the business address of an organisation providing home care to an individual; or - the postal address of the copyholder of an advanced care record, within the EVALUATION.advance_care_directive archetype; or - the physical location of a fall or accident. The scope of this archetype has been constrained to carry only the commonest structured components for identifying a specific physical building or landmark. In this context a complete address may be described using: - One or more free text 'Address line' data elements to represent the huge variety of ways that ‘street-level' details may need to be recorded; and - 'Town' to represent a suburb, town, city, village, or community; - 'District/County' to represent a local government district; - 'State/Territory/Province’ to represent a major government district; - ‘Postcode’, and - ‘Country'. This CLUSTER.address could also be used as a proxy for an address in formal demographic address data when reviewing a template with domain experts - for example, an assessment where reviewers would expect to see the individual's full contact details at the top of the assessment form.
MisuseNot to be used to record a fully structured address, such as described in ISO standards or as part of maintaining an official demographic register or index. Use an address lookup service, a formal Master Patient Index or a Health Provider Index for this purpose, or archetypes based on the openEHR Demographic Information Model. Not to be used to represent digital addresses for use in electronic communication. Use CLUSTER.electronic_communication for this purpose. Not to be used to record details about housing or homelessness. Use the EVALUATION.housing_summary for this purpose.
PurposeTo record details about the location of a person, physical building or landmark as they are known or understood in the course of clinical documentation.
ReferencesHealth Care Client Identification - AS 5017-2006. New South Wales (AU): Standards Australia; 2006.

Health Care Provider Identification - AS 4846-2006. New South Wales (AU): Standards Australia; 2006.

Health informatics — Identification of subjects of health care - ISO/TS 22220:2007. Geneva: International Organization for Standardization; 2007.

HL7 FHIR Resource - Person v4.0.1: R4 [Internet]. Health Level Seven International; [accessed 2021 05 04]. Available from: http://hl7.org/fhir/2021May/person.html.

HL7 FHIR Resource - Organization v4.0.1: R4 [Internet]. Health Level Seven International; [accessed 2021 05 04]. Available from: http://hl7.org/fhir/2021May/organization.html
AuthorsAuthor name: Heather Leslie
Organisation: Atomica Informatics
Email: heather.leslie@atomicainformatics.com
Date originally authored: 2021-04-14
Other Details LanguageAuthor name: Heather Leslie
Organisation: Atomica Informatics
Email: heather.leslie@atomicainformatics.com
Date originally authored: 2021-04-14
OtherDetails Language Independent{licence=This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/., custodian_organisation=openEHR Foundation, references=Health Care Client Identification - AS 5017-2006. New South Wales (AU): Standards Australia; 2006. Health Care Provider Identification - AS 4846-2006. New South Wales (AU): Standards Australia; 2006. Health informatics — Identification of subjects of health care - ISO/TS 22220:2007. Geneva: International Organization for Standardization; 2007. HL7 FHIR Resource - Person v4.0.1: R4 [Internet]. Health Level Seven International; [accessed 2021 05 04]. Available from: http://hl7.org/fhir/2021May/person.html. HL7 FHIR Resource - Organization v4.0.1: R4 [Internet]. Health Level Seven International; [accessed 2021 05 04]. Available from: http://hl7.org/fhir/2021May/organization.html, original_namespace=org.openehr, original_publisher=openEHR Foundation, custodian_namespace=org.openehr, MD5-CAM-1.0.1=2133C3C9ED943180AF0FD5076B412AD5, build_uid=5858eb68-b337-41fb-b80f-5c74cdeabfe1, revision=1.0.3}
Keywordsaddress, postal, mailing, home, business, physical, landmark
Lifecyclepublished
UID9d44ce81-a4e4-4edc-a828-20f5e4b88af5
Language useden
Citeable Identifier1246.145.816
Revision Number1.0.3
AllArchetype [runtimeNameConstraintForConceptName=null, archetypeConceptBinding=null, archetypeConceptDescription=Details about the location of a person, physical building or landmark., archetypeConceptComment=null, otherContributors=Dag Aarhus, Vestre Viken HF, Norway
Vebjørn Arntzen, Oslo University Hospital, Norway (openEHR Editor)
Astrid Askeland, Dips AS, Norway
Silje Ljosland Bakke, Helse Vest IKT AS, Norway (openEHR Editor)
Keisha Barwise, MOHW/IDB HSSP Project, Jamaica
SB Bhattacharyya, Bhattacharyyas Clinical Records Research & Informatics LLP, India
Yexuan Cheng, 浙江大学, China
Candice de Lisser, Ministry of Health and Wellness, Jamaica
Ludvig Eek Hofmann, Cambio Healthcare Systems AB, Sweden
Valborg Ellingsen, Haraldsplass Diakonale sykehus, Norway
Heather Grain, Llewelyn Grain Informatics, Australia
Martin Grundberg, Cambio Healthcare Systems, Sweden
Mikkel Johan Gaup Grønmo, Regional forvaltning EPJ, Helse Nord, Norway (openEHR Editor)
Rebecka Hansson, Cambio Healthcare Systems AB, Sweden
Anca Heyd, DIPS ASA, Norway
Joost Holslag, Nedap, Netherlands
Evelyn Hovenga, EJSH Consulting, Australia
Gunnar Jårvik, Helse Vest IKT AS, Norway
Gunn-Lisbeth Kleiven, Oslo universitetssykehus HF, Norway
Shinji Kobayashi, National Institute of Public Health, Japan
Kanika Kuwelker, Helse Vest IKT, Norway
Jörgen Kuylenstierna, eWeave AB, Sweden
Liv Laugen, ​Oslo University Hospital, Norway, Norway (openEHR Editor)
Heather Leslie, Atomica Informatics, Australia (openEHR Editor)
Lars Morgan Karlsen, Nordlandssykehuset Bodø, Norway
Mikael Nyström, Cambio Healthcare Systems AB, Sweden
Jayashree Panickar, Karolinska Institute, Sweden
Erik Skjemstad, Helse Nord RHF, Norway
Natalia Strauch, Medizinische Hochschule Hannover, Germany
Norwegian Review Summary, Norwegian Public Hospitals, Norway
Nyree Taylor, Ocean Health Systems, Australia
Anders Thurin, VGR, Sweden
John Tore Valand, Helse Bergen, Norway (openEHR Editor)
Marit Alice Venheim, Helse Vest IKT, Norway (openEHR Editor)
Ina Wille, Helse-Vest RHF, Norway, originalLanguage=en, translators=German: Natalia Strauch, Medizinische Hochschule Hannover, Strauch.Natalia@mh-hannover.de
Norwegian Bokmål: Liv Laugen, John Tore Valand, Vebjørn Arntzen, Kanika Kuwelker, ​Oslo University Hospital, Norway, Helse Bergen, Helse Vest IKT, liv.laugen@ous-hf.no, john.tore.valand@helse-bergen.no, john.tore.valand@helse-vest-ikt.no, varntzen@ous-hf.no, kanika.kuwelker@helse-vest-ikt.no
, subjectOfData=unconstrained, archetypeTranslationTree=null, topLevelToAshis={source=[], identities=[], events=[], relationships=[], target=[], data=[], protocol=[], capabilities=[], contacts=[], description=[], activities=[], content=[], other_participations=[], items=[ResourceSimplifiedHierarchyItem [path=/items[at0001], code=at0001, itemType=ELEMENT, level=1, text=Address line, description=An unstructured address line representing all relevant street-level or post-box details that would support the identification of a location., comment=Occurrences for this data element is set to 0..* to allow one or more free text 'Address line' data elements to represent the huge variety of ways that ‘street-level' details may need to be recorded within the context of a specified 'Town'. Multiple address lines can be represented in a template, renamed as 'Address line 1', 'Address line 2,' etc. For example: '7A/52 Davis Street' or 'Apartment 7A' as Address line 1 with '52 Davis Street' as Address line 2; a roadside mail box location, such as 'RMB 725, Princes Highway'; or using a descriptive landmark, such as or 'Corner of Smith & Brown Streets' or 'Second house north of the general store with the red door'., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0002], code=at0002, itemType=ELEMENT, level=1, text=Town, description=The name of the suburb, town, city, village, community or lowest level locality that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'Fitzroy'; 'Manchester'; 'Kingston' or 'Bergen'., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0003], code=at0003, itemType=ELEMENT, level=1, text=District/County, description=The name of a local government district or geographical area that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'Surf Coast' and 'Yarra' local government councils in Victoria, Australia; and the Counties of 'Cornwall', 'Middlesex' & 'Surrey' in Jamaica., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0004], code=at0004, itemType=ELEMENT, level=1, text=State/Territory/Province, description=The name of a major government district or geographical area that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'New South Wales' and 'Queensland' in Australia; 'British Columbia' and 'Nova Scotia' in Canada; and the Parishes of 'St. Andrew' and 'Kingston' in Jamaica., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0005], code=at0005, itemType=ELEMENT, level=1, text=Postal code, description=The code for a postal delivery area containing the address, as defined by the relevant postal delivery service., comment=Also known as a postcode or ZIP code. , uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0006], code=at0006, itemType=ELEMENT, level=1, text=Country, description=The name of the country containing the address., comment=For example: Australia; Canada; Jamaica; or Norway. Coding with an external terminology, such as EN ISO 3166–1 Alpha 2 country code, is recommended., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0007], code=at0007, itemType=ELEMENT, level=1, text=Latitude, description=Horizontal (y) coordinate of a geolocation for the address., comment=Latitude is represented by positive values north of the equator and negative values south of the equator. For example the latitude of the Eiffel Tower is 48.858093., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Angle, plane
Units: -90.0..90.0 deg
Limit decimal places: 6, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0008], code=at0008, itemType=ELEMENT, level=1, text=Longitude, description=Horizontal (x) coordinate of a geolocation for the address., comment=Longitude is represented by negative values west of Prime Meridian and positive values east of Prime Meridian. For example the longitude of the Eiffel Tower is 2.294694., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Angle, plane
Units: -180.0..180.0 deg
Limit decimal places: 6, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0009], code=at0009, itemType=ELEMENT, level=1, text=Altitude, description=The vertical coordinate of a geolocation representing height or depth of the address., comment=For example, the altitude of the top of the Eiffel Tower is +324m., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Length
Units: m
Limit decimal places: 2, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0019], code=at0019, itemType=ELEMENT, level=1, text=Map URL, description=Link to a location on an online map., comment=For example: a location on a Google or iOS map., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0010], code=at0010, itemType=ELEMENT, level=1, text=Type, description=The type of address., comment=For example: physical or postal., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Coded Text
    • Physical [A physical location that can be visited.]
    • Postal [Address used as a destination for mailing letters or parcels.]
    • Both [Address of a physical location, also used as a destination for mail.]
  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0014], code=at0014, itemType=ELEMENT, level=1, text=Use, description=The primary purpose or use for the address., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Coded Text
    • Business [Address of the physical location of a business or office.]
    • Residential [Address of where a person is living on a regular basis.]
    • Temporary accommodation [Address of where a person is living on a temporary basis.]
  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0018], code=at0018, itemType=ELEMENT, level=1, text=Comment, description=Additional narrative about the address not captured in other fields., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null]], details=[], ism_transition=[], credentials=[], state=[], context=[], provider=[]}, topLevelItems={items=ResourceSimplifiedHierarchyItem [path=ROOT_/, code=at0000, itemType=CLUSTER, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=1..*, cardinalityText=, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=null, extendedValues=null]}, addHierarchyItemsTo=items, currentHierarchyItemsForAdding=[ResourceSimplifiedHierarchyItem [path=/items[at0001], code=at0001, itemType=ELEMENT, level=1, text=Address line, description=An unstructured address line representing all relevant street-level or post-box details that would support the identification of a location., comment=Occurrences for this data element is set to 0..* to allow one or more free text 'Address line' data elements to represent the huge variety of ways that ‘street-level' details may need to be recorded within the context of a specified 'Town'. Multiple address lines can be represented in a template, renamed as 'Address line 1', 'Address line 2,' etc. For example: '7A/52 Davis Street' or 'Apartment 7A' as Address line 1 with '52 Davis Street' as Address line 2; a roadside mail box location, such as 'RMB 725, Princes Highway'; or using a descriptive landmark, such as or 'Corner of Smith & Brown Streets' or 'Second house north of the general store with the red door'., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0002], code=at0002, itemType=ELEMENT, level=1, text=Town, description=The name of the suburb, town, city, village, community or lowest level locality that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'Fitzroy'; 'Manchester'; 'Kingston' or 'Bergen'., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0003], code=at0003, itemType=ELEMENT, level=1, text=District/County, description=The name of a local government district or geographical area that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'Surf Coast' and 'Yarra' local government councils in Victoria, Australia; and the Counties of 'Cornwall', 'Middlesex' & 'Surrey' in Jamaica., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0004], code=at0004, itemType=ELEMENT, level=1, text=State/Territory/Province, description=The name of a major government district or geographical area that contains the address., comment=Coding with an external terminology is preferred, where possible. For example: 'New South Wales' and 'Queensland' in Australia; 'British Columbia' and 'Nova Scotia' in Canada; and the Parishes of 'St. Andrew' and 'Kingston' in Jamaica., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0005], code=at0005, itemType=ELEMENT, level=1, text=Postal code, description=The code for a postal delivery area containing the address, as defined by the relevant postal delivery service., comment=Also known as a postcode or ZIP code. , uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0006], code=at0006, itemType=ELEMENT, level=1, text=Country, description=The name of the country containing the address., comment=For example: Australia; Canada; Jamaica; or Norway. Coding with an external terminology, such as EN ISO 3166–1 Alpha 2 country code, is recommended., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0007], code=at0007, itemType=ELEMENT, level=1, text=Latitude, description=Horizontal (y) coordinate of a geolocation for the address., comment=Latitude is represented by positive values north of the equator and negative values south of the equator. For example the latitude of the Eiffel Tower is 48.858093., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Angle, plane
Units: -90.0..90.0 deg
Limit decimal places: 6, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0008], code=at0008, itemType=ELEMENT, level=1, text=Longitude, description=Horizontal (x) coordinate of a geolocation for the address., comment=Longitude is represented by negative values west of Prime Meridian and positive values east of Prime Meridian. For example the longitude of the Eiffel Tower is 2.294694., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Angle, plane
Units: -180.0..180.0 deg
Limit decimal places: 6, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0009], code=at0009, itemType=ELEMENT, level=1, text=Altitude, description=The vertical coordinate of a geolocation representing height or depth of the address., comment=For example, the altitude of the top of the Eiffel Tower is +324m., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Length
Units: m
Limit decimal places: 2, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0019], code=at0019, itemType=ELEMENT, level=1, text=Map URL, description=Link to a location on an online map., comment=For example: a location on a Google or iOS map., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0010], code=at0010, itemType=ELEMENT, level=1, text=Type, description=The type of address., comment=For example: physical or postal., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Coded Text
    • Physical [A physical location that can be visited.]
    • Postal [Address used as a destination for mailing letters or parcels.]
    • Both [Address of a physical location, also used as a destination for mail.]
  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0014], code=at0014, itemType=ELEMENT, level=1, text=Use, description=The primary purpose or use for the address., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Coded Text
    • Business [Address of the physical location of a business or office.]
    • Residential [Address of where a person is living on a regular basis.]
    • Temporary accommodation [Address of where a person is living on a temporary basis.]
  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0018], code=at0018, itemType=ELEMENT, level=1, text=Comment, description=Additional narrative about the address not captured in other fields., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null]], minIndents={}, termBindingRetrievalErrorMessage=null]