STU 3 Candidate

This page is part of the FHIR Specification (v1.4.0: STU 3 Ballot 3). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.17 Resource Location - Content

Patient Administration Work GroupMaturity Level: 1Compartments: Not linked to any defined compartments

Details and position information for a physical place where services are provided and resources and participants may be stored, found, contained or accommodated.

5.17.1 Scope and Usage

A Location includes both incidental locations (a place which is used for healthcare without prior designation or authorization) and dedicated, formally appointed locations. Locations may be private, public, mobile or fixed and scale from small freezers to full hospital buildings or parking garages.

Examples of Locations are:

  • Building, ward, corridor, room or bed
  • Mobile Clinic
  • Freezer, incubator
  • Vehicle or lift
  • Home, shed, or a garage
  • Road, parking place, a park
  • Ambulance (generic)
  • Ambulance (specific)
  • Patient's Home (generic)
  • Jurisdiction

These locations are not intended to cover locations on a patient where something occurred (i.e. a patient's broken leg), but can hapily cover the location where the patient broke the leg (the playground)

5.17.2 Boundaries and Relationships

Locations and Organizations are very closely related resources and can often be mixed/matched/confused.
The Location is intended to describe the more physical structures managed/operated by an organization, whereas the Organization is intended to represent the more conceptual hierarchies, such as a ward.

A Location is valid without an address in cases where it could be purely described by a geo-coded location in remote areas, or when recorded by a device. Locations with a mode = "kind" would also likely not have an address, as they are just a type of location, but could also have an address where they can be found at the address.

Another use of location could be for describing a Jurisdiction. This jurisdiction may be considered a classified boundary which could be a combination of a physical boundary, and some other discriminator(s):

  • Nation - Country wide community or Federal Government (Ministry of Health)
  • Province or State (community or Government)
  • Business (throughout an enterprise)
  • Business scope (CDC/FDA)
  • Business segment (UK Pharmacy)

This resource is referenced by Account, Appointment, AppointmentResponse, AuditEvent, CarePlan, Claim, Contract, Device, DiagnosticOrder, DiagnosticReport, EligibilityRequest, Encounter, ExplanationOfBenefit, Flag, HealthcareService, Immunization, List, MedicationDispense, Observation, Practitioner, PractitionerRole, Procedure, Protocol, Provenance, Schedule and SupplyDelivery

5.17.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Location DomainResourceDetails and position information for a physical place
... identifier Σ0..*IdentifierUnique code or number identifying the location to its users
... status ?! Σ0..1codeactive | suspended | inactive
LocationStatus (Required)
... name Σ0..1stringName of the location as used by humans
... description Σ0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name
... mode ?! Σ0..1codeinstance | kind
LocationMode (Required)
... type Σ0..1CodeableConceptType of function performed
ServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointContact details of the location
... address 0..1AddressPhysical location
... physicalType Σ0..1CodeableConceptPhysical form of the location
LocationType (Example)
... position 0..1BackboneElementThe absolute geographic location
.... longitude 1..1decimalLongitude with WGS84 datum
.... latitude 1..1decimalLatitude with WGS84 datum
.... altitude 0..1decimalAltitude with WGS84 datum
... managingOrganization Σ0..1Reference(Organization)Organization responsible for provisioning and upkeep
... partOf 0..1Reference(Location)Another Location this one is physically part of

doco Documentation for this format

UML Diagram

Location (DomainResource)Unique code or number identifying the location to its usersidentifier : Identifier [0..*]active | suspended | inactive (this element modifies the meaning of other elements)status : code [0..1] « Indicates whether the location is still in use. (Strength=Required)LocationStatus! »Name of the location as used by humans. Does not need to be uniquename : string [0..1]Description of the Location, which helps in finding or referencing the placedescription : string [0..1]Indicates whether a resource instance represents a specific location or a class of locations (this element modifies the meaning of other elements)mode : code [0..1] « Indicates whether a resource instance represents a specific location or a class of locations. (Strength=Required)LocationMode! »Indicates the type of function performed at the locationtype : CodeableConcept [0..1] « Indicates the type of function performed at the location. (Strength=Extensible)ServiceDeliveryLocationRoleTy...+ »The contact details of communication devices available at the location. This can include phone numbers, fax numbers, mobile numbers, email addresses and web sitestelecom : ContactPoint [0..*]Physical locationaddress : Address [0..1]Physical form of the location, e.g. building, room, vehicle, roadphysicalType : CodeableConcept [0..1] « Physical form of the location (Strength=Example)LocationType?? »The organization responsible for the provisioning and upkeep of the locationmanagingOrganization : Reference [0..1] « Organization »Another Location which this Location is physically part ofpartOf : Reference [0..1] « Location »PositionLongitude. The value domain and the interpretation are the same as for the text of the longitude element in KML (see notes below)longitude : decimal [1..1]Latitude. The value domain and the interpretation are the same as for the text of the latitude element in KML (see notes below)latitude : decimal [1..1]Altitude. The value domain and the interpretation are the same as for the text of the altitude element in KML (see notes below)altitude : decimal [0..1]The absolute geographic location of the Location, expressed using the WGS84 datum (This is the same co-ordinate system used in KML)position[0..1]

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Location DomainResourceDetails and position information for a physical place
... identifier Σ0..*IdentifierUnique code or number identifying the location to its users
... status ?! Σ0..1codeactive | suspended | inactive
LocationStatus (Required)
... name Σ0..1stringName of the location as used by humans
... description Σ0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name
... mode ?! Σ0..1codeinstance | kind
LocationMode (Required)
... type Σ0..1CodeableConceptType of function performed
ServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointContact details of the location
... address 0..1AddressPhysical location
... physicalType Σ0..1CodeableConceptPhysical form of the location
LocationType (Example)
... position 0..1BackboneElementThe absolute geographic location
.... longitude 1..1decimalLongitude with WGS84 datum
.... latitude 1..1decimalLatitude with WGS84 datum
.... altitude 0..1decimalAltitude with WGS84 datum
... managingOrganization Σ0..1Reference(Organization)Organization responsible for provisioning and upkeep
... partOf 0..1Reference(Location)Another Location this one is physically part of

doco Documentation for this format

UML Diagram

Location (DomainResource)Unique code or number identifying the location to its usersidentifier : Identifier [0..*]active | suspended | inactive (this element modifies the meaning of other elements)status : code [0..1] « Indicates whether the location is still in use. (Strength=Required)LocationStatus! »Name of the location as used by humans. Does not need to be uniquename : string [0..1]Description of the Location, which helps in finding or referencing the placedescription : string [0..1]Indicates whether a resource instance represents a specific location or a class of locations (this element modifies the meaning of other elements)mode : code [0..1] « Indicates whether a resource instance represents a specific location or a class of locations. (Strength=Required)LocationMode! »Indicates the type of function performed at the locationtype : CodeableConcept [0..1] « Indicates the type of function performed at the location. (Strength=Extensible)ServiceDeliveryLocationRoleTy...+ »The contact details of communication devices available at the location. This can include phone numbers, fax numbers, mobile numbers, email addresses and web sitestelecom : ContactPoint [0..*]Physical locationaddress : Address [0..1]Physical form of the location, e.g. building, room, vehicle, roadphysicalType : CodeableConcept [0..1] « Physical form of the location (Strength=Example)LocationType?? »The organization responsible for the provisioning and upkeep of the locationmanagingOrganization : Reference [0..1] « Organization »Another Location which this Location is physically part ofpartOf : Reference [0..1] « Location »PositionLongitude. The value domain and the interpretation are the same as for the text of the longitude element in KML (see notes below)longitude : decimal [1..1]Latitude. The value domain and the interpretation are the same as for the text of the latitude element in KML (see notes below)latitude : decimal [1..1]Altitude. The value domain and the interpretation are the same as for the text of the altitude element in KML (see notes below)altitude : decimal [0..1]The absolute geographic location of the Location, expressed using the WGS84 datum (This is the same co-ordinate system used in KML)position[0..1]

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

5.17.3.1 Terminology Bindings

PathDefinitionTypeReference
Location.status Indicates whether the location is still in use.RequiredLocationStatus
Location.mode Indicates whether a resource instance represents a specific location or a class of locations.RequiredLocationMode
Location.type Indicates the type of function performed at the location.ExtensibleServiceDeliveryLocationRoleType
Location.physicalType Physical form of the locationExampleLocationType

5.17.4 Notes

  • Multiple Organizations or Practitioners may provide services at a Location. These references are not kept in Location, but can be found in the models for Organization and Practitioner instead.
  • Locations may range from whole buildings to cabinets; it is possible to relate smaller Locations to their containing bigger Location using the Location.partOf element.
  • Location.position is expressed using the same syntax, datum and reference system as used in Google Earth's KML files, see Google/OGS's KML .

5.17.4.1 Location Mode

The Location.mode element can be used to indicate whether a Location resource represents a specific (potentially identifiable) Location ('instance'), or a class of Locations ('kind'). Especially Resources capturing orders, resource scheduling, plans and definitions may refer to Locations in 'kind' mode. For these domains, it is often not necessary to refer to a specific Location, but rather to a class of Locations. An example of this is found in planning, where we need to allocate an "isolation room" for a patient, or need to dispatch "an ambulance" at a certain time. In these cases it is not important exactly which isolation room or ambulance is allocated, and it is sufficient to just indicate a 'kind' of Location.

Note that 'kind' should not be used to represent Locations where an actual instance of a Location was involved, but identifying information is missing. E.g. when a patient arrived 'by ambulance', but it is not known by which ambulance, this should be represented using a Location in 'instance' mode with a missing identifier, not a Location of 'kind' ambulance.

Some of Location's data elements are only relevant when mode is 'instance' and should not be used when mode is 'kind':
(however this information could still be included if was relevant, such as when it is a generic item, but not globally generic, e.g. a Burgers MU ambulance)

  • Location.identifier
  • Location.telecom
  • Location.address
  • Location.position
  • Location.status
  • Location.managingOrganization

5.17.5 Example Location Hierarchy

An example location hierarchy should help give some guidance as to one example of how a location hierarchy could look within a fictitious Hospital.
(The nesting here would be the "part-of" structure of the location)

Hospital A Building C (instance)
    East Wing (instance)
        Level 1 (instance)
            Reception (instance)
            Nurses Station EM-ns1 (instance)
                Medication Cupboard A (instance)
            Room 1 (instance)
                Room 1a (instance) - space in room separatable via a curtain
                    Bed 1a (instance) - always in this room
                Room 1b (instance)
                    Trolley 43 (instance) - moves about
                Room 1d (instance)
                    Trolley 19 (instance) - moves about
                Room 2 (instance)
                    ...
            Theatre EM-TA (instance)
            Coridor (generic)
        Level 2 (instance)
            Reception (instance)
                ...
            Nurses Station EM-ns1 (instance)
                Medication Cupboard A (instance)
            Coridor (generic)
Mobile Services (kind)
    Ambulance (kind)
        Ambulance AMB1 (instance)
        Ambulance AMB2 (instance)
	

Note: Wards/departments are not part of this structure - these would form part of the Organizational Hierarchy.

5.17.6 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
addressstringA (part of the) address of the locationLocation.address
address-citystringA city specified in an addressLocation.address.city
address-countrystringA country specified in an addressLocation.address.country
address-postalcodestringA postal code specified in an addressLocation.address.postalCode
address-statestringA state specified in an addressLocation.address.state
address-usetokenA use code specified in an addressLocation.address.use
identifiertokenUnique code or number identifying the location to its usersLocation.identifier
namestringA (portion of the) name of the locationLocation.name
neartokenThe coordinates expressed as [lat],[long] (using the WGS84 datum, see notes) to find locations near to (servers may search using a square rather than a circle for efficiency)Location.position
near-distancetokenA distance quantity to limit the near search to locations within a specific distanceLocation.position
organizationreferenceSearches for locations that are managed by the provided organizationLocation.managingOrganization
(Organization)
partofreferenceThe location of which this location is a partLocation.partOf
(Location)
statustokenSearches for locations with a specific kind of statusLocation.status
typetokenA code for the type of locationLocation.type