Current Build

Переводит команда Health Samurai . Приглашаем поучаствовать в русификации стандарта FHIR: GitHub , Email.

8.7 Ресурс Location - Назначение

Patient Administration Work GroupMaturity Level: 3 Trial UseSecurity Category: Business Compartments: Not linked to any defined compartments

Подробные сведения и информация о положении физического места, где оказываются услуги и могут храниться, находиться, содержаться или размещаться ресурсы и участники.

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 happily cover the location where the patient broke the leg (the playground)

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)

На этот ресурс ссылаются UsageContext, Account, ActivityDefinition, AdverseEvent, Appointment, AppointmentResponse, AuditEvent, CarePlan, Claim, ClaimResponse, Contract, CoverageEligibilityRequest, Device, DeviceRequest, DiagnosticReport, Encounter, ExplanationOfBenefit, Flag, HealthcareService, ImagingStudy, Immunization, InsurancePlan, ItemInstance, List, itself, MeasureReport, Media, MedicationDispense, Observation, OrganizationAffiliation, PractitionerRole, Procedure, Provenance, ResearchStudy, Schedule, ServiceRequest, Specimen, SupplyDelivery, SupplyRequest и Task

Структура

ИмяФлагиКард.ТипОписание и ограниченияdoco
.. Location TUDomainResourceПодробные сведения и информация о положении физического места
Элементы, определённые в прародителе: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierУникальный код или число, идентифицируется местонахождение для его пользователей
... status ?!Σ0..1codeactive | suspended | inactive
LocationStatus (Required)
... operationalStatus Σ0..1CodingThe Operational status of the location (typically only for a bed/room)
v2 BED STATUS (Preferred)
... name Σ0..1stringНазвание места, используемое людьми
... alias 0..*stringA list of alternate names that the location is known as or was known as in the past
... description Σ0..1stringДополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
... mode Σ0..1codeinstance | kind
LocationMode (Required)
... type Σ0..*CodeableConceptТип выполняемой функции
V3 Value SetServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointКонтактные сведения для местонахождения
... address 0..1AddressФизическое местонахождение
... physicalType Σ0..1CodeableConceptФизическая форма местонахождения
Location type (Example)
... position 0..1BackboneElementАбсолютное географическое расположение
.... longitude 1..1decimalДолгота в системе координат WGS84
.... latitude 1..1decimalШирота в системе координат WGS84
.... altitude 0..1decimalВысота над уровнем моря в системе координат WGS84
... managingOrganization Σ0..1Reference(Organization)Организация, которая несет ответственность за предоставление и содержание
... partOf 0..1Reference(Location)Другой ресурс Location, физической частью которого является данный
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun
DaysOfWeek (Required)
.... allDay 0..1booleanThe Location is open all day
.... openingTime 0..1timeTime that the Location opens
.... closingTime 0..1timeTime that the Location closes
... availabilityExceptions 0..1stringDescription of availability exceptions
... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to services operated for the location

doco Документация по этому формату

UML-диаграмма (Legend)

Location (DomainResource)Уникальный код или число, идентифицируется местонахождение для его пользователейidentifier : Identifier [0..*]The status property covers the general availability of the resource, not the current value which may be covered by the operationStatus, or by a schedule/slots if they are configured for the location (this element modifies the meaning of other elements)status : code [0..1] « Показывает, находится ли все еще это местонахождение в использовании. (Strength=Required)LocationStatus! »The Operational status covers operation values most relevant to beds (but can also apply to rooms/units/chair/etc. such as an isolation unit/dialysis chair). This typically covers concepts such as contamination, housekeeping and other activities like maintenanceoperationalStatus : Coding [0..1] « The operational status if the location (where typically a bed/room). (Strength=Preferred)v2.0116? »Название места, используемое людьми. Не требуется быть уникальнымname : string [0..1]A list of alternate names that the location is known as or was known as in the pastalias : string [0..*]Описание месторасположения, которое помогает при поиске этого места или для ссылок на негоdescription : string [0..1]Показывает, представляет ли экземпляр ресурса определенное местонахождение или класс местонахожденийmode : code [0..1] « Показывает, описывает ли экземпляр ресурса конкретное местонахождение или только его тип. (Strength=Required)LocationMode! »Обозначает тип функции, выполняемой в этом местеtype : CodeableConcept [0..*] « Описывает функцию этого места. (Strength=Extensible)v3.ServiceDeliveryLocationRol...+ »Контактные сведения коммуникационных устройств, доступных в этом месте. Сюда могут входить номера телефонов, факсов, мобильных, адреса электронной почты и веб-сайтыtelecom : ContactPoint [0..*]Физическое местонахождениеaddress : Address [0..1]Физическая форма местонахождения, например здание, комната, машина, дорогаphysicalType : CodeableConcept [0..1] « Физическая форма местонахождения. (Strength=Example)LocationType?? »Организация, которая несет ответственность за предоставление и содержание местаmanagingOrganization : Reference [0..1] « Organization »Другой ресурс Location, физической частью которого является данный LocationpartOf : Reference [0..1] « Location »A description of when the locations opening ours are different to normal, e.g. public holiday availability. Succinctly describing all possible exceptions to normal site availability as detailed in the opening hours TimesavailabilityExceptions : string [0..1]Technical endpoints providing access to services operated for the locationendpoint : Reference [0..*] « Endpoint »PositionДолгота. Область значений и интерпретация такие же, как для текста элемента "longitude" в KML (см. примечания ниже)longitude : decimal [1..1]Широта. Область значений и интерпретация такие же, как для текста элемента "latitude" в KML (см. примечания ниже)latitude : decimal [1..1]Высота над уровнем моря. Область значений и интерпретация такие же, как для текста элемента "altitude" в KML (см. примечания ниже)altitude : decimal [0..1]HoursOfOperationIndicates which days of the week are available between the start and end TimesdaysOfWeek : code [0..*] « The days of the week. (Strength=Required)DaysOfWeek! »The Location is open all dayallDay : boolean [0..1]Time that the Location opensopeningTime : time [0..1]Time that the Location closesclosingTime : time [0..1]Абсолютное географическое расположение места, выраженное в системе координат WGS84 (эта же система координат используется в KML)position[0..1]What days/times during a week is this location usually openhoursOfOperation[0..*]

XML-шаблон

<Location xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Уникальный код или число, идентифицируется местонахождение для его пользователей --></identifier>
 <status value="[code]"/><!-- 0..1 active | suspended | inactive -->
 <operationalStatus><!-- 0..1 Coding The Operational status of the location (typically only for a bed/room) --></operationalStatus>
 <name value="[string]"/><!-- 0..1 Название места, используемое людьми -->
 <alias value="[string]"/><!-- 0..* A list of alternate names that the location is known as or was known as in the past -->
 <description value="[string]"/><!-- 0..1 Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию -->
 <mode value="[code]"/><!-- 0..1 instance | kind -->
 <type><!-- 0..* CodeableConcept Тип выполняемой функции --></type>
 <telecom><!-- 0..* ContactPoint Контактные сведения для местонахождения --></telecom>
 <address><!-- 0..1 Address Физическое местонахождение --></address>
 <physicalType><!-- 0..1 CodeableConcept Физическая форма местонахождения --></physicalType>
 <position>  <!-- 0..1 Абсолютное географическое расположение -->
  <longitude value="[decimal]"/><!-- 1..1 Долгота в системе координат WGS84 -->
  <latitude value="[decimal]"/><!-- 1..1 Широта в системе координат WGS84 -->
  <altitude value="[decimal]"/><!-- 0..1 Высота над уровнем моря в системе координат WGS84 -->
 </position>
 <managingOrganization><!-- 0..1 Reference(Organization) Организация, которая несет ответственность за предоставление и содержание --></managingOrganization>
 <partOf><!-- 0..1 Reference(Location) Другой ресурс Location, физической частью которого является данный --></partOf>
 <hoursOfOperation>  <!-- 0..* What days/times during a week is this location usually open -->
  <daysOfWeek value="[code]"/><!-- 0..* mon | tue | wed | thu | fri | sat | sun -->
  <allDay value="[boolean]"/><!-- 0..1 The Location is open all day -->
  <openingTime value="[time]"/><!-- 0..1 Time that the Location opens -->
  <closingTime value="[time]"/><!-- 0..1 Time that the Location closes -->
 </hoursOfOperation>
 <availabilityExceptions value="[string]"/><!-- 0..1 Description of availability exceptions -->
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the location --></endpoint>
</Location>

JSON-шаблон

{doco
  "resourceType" : "Location",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Уникальный код или число, идентифицируется местонахождение для его пользователей
  "status" : "<code>", // active | suspended | inactive
  "operationalStatus" : { Coding }, // The Operational status of the location (typically only for a bed/room)
  "name" : "<string>", // Название места, используемое людьми
  "alias" : ["<string>"], // A list of alternate names that the location is known as or was known as in the past
  "description" : "<string>", // Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
  "mode" : "<code>", // instance | kind
  "type" : [{ CodeableConcept }], // Тип выполняемой функции
  "telecom" : [{ ContactPoint }], // Контактные сведения для местонахождения
  "address" : { Address }, // Физическое местонахождение
  "physicalType" : { CodeableConcept }, // Физическая форма местонахождения
  "position" : { // Абсолютное географическое расположение
    "longitude" : <decimal>, // R!  Долгота в системе координат WGS84
    "latitude" : <decimal>, // R!  Широта в системе координат WGS84
    "altitude" : <decimal> // Высота над уровнем моря в системе координат WGS84
  },
  "managingOrganization" : { Reference(Organization) }, // Организация, которая несет ответственность за предоставление и содержание
  "partOf" : { Reference(Location) }, // Другой ресурс Location, физической частью которого является данный
  "hoursOfOperation" : [{ // What days/times during a week is this location usually open
    "daysOfWeek" : ["<code>"], // mon | tue | wed | thu | fri | sat | sun
    "allDay" : <boolean>, // The Location is open all day
    "openingTime" : "<time>", // Time that the Location opens
    "closingTime" : "<time>" // Time that the Location closes
  }],
  "availabilityExceptions" : "<string>", // Description of availability exceptions
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the location
}

Turtle-шаблон

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Location;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Location.identifier [ Identifier ], ... ; # 0..* Уникальный код или число, идентифицируется местонахождение для его пользователей
  fhir:Location.status [ code ]; # 0..1 active | suspended | inactive
  fhir:Location.operationalStatus [ Coding ]; # 0..1 The Operational status of the location (typically only for a bed/room)
  fhir:Location.name [ string ]; # 0..1 Название места, используемое людьми
  fhir:Location.alias [ string ], ... ; # 0..* A list of alternate names that the location is known as or was known as in the past
  fhir:Location.description [ string ]; # 0..1 Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
  fhir:Location.mode [ code ]; # 0..1 instance | kind
  fhir:Location.type [ CodeableConcept ], ... ; # 0..* Тип выполняемой функции
  fhir:Location.telecom [ ContactPoint ], ... ; # 0..* Контактные сведения для местонахождения
  fhir:Location.address [ Address ]; # 0..1 Физическое местонахождение
  fhir:Location.physicalType [ CodeableConcept ]; # 0..1 Физическая форма местонахождения
  fhir:Location.position [ # 0..1 Абсолютное географическое расположение
    fhir:Location.position.longitude [ decimal ]; # 1..1 Долгота в системе координат WGS84
    fhir:Location.position.latitude [ decimal ]; # 1..1 Широта в системе координат WGS84
    fhir:Location.position.altitude [ decimal ]; # 0..1 Высота над уровнем моря в системе координат WGS84
  ];
  fhir:Location.managingOrganization [ Reference(Organization) ]; # 0..1 Организация, которая несет ответственность за предоставление и содержание
  fhir:Location.partOf [ Reference(Location) ]; # 0..1 Другой ресурс Location, физической частью которого является данный
  fhir:Location.hoursOfOperation [ # 0..* What days/times during a week is this location usually open
    fhir:Location.hoursOfOperation.daysOfWeek [ code ], ... ; # 0..* mon | tue | wed | thu | fri | sat | sun
    fhir:Location.hoursOfOperation.allDay [ boolean ]; # 0..1 The Location is open all day
    fhir:Location.hoursOfOperation.openingTime [ time ]; # 0..1 Time that the Location opens
    fhir:Location.hoursOfOperation.closingTime [ time ]; # 0..1 Time that the Location closes
  ], ...;
  fhir:Location.availabilityExceptions [ string ]; # 0..1 Description of availability exceptions
  fhir:Location.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the location
]

Changes since R3

Location
Location.mode
  • No longer marked as Modifier
Location.type
  • Max Cardinality changed from 1 to *
Location.hoursOfOperation
  • Added Element
Location.hoursOfOperation.daysOfWeek
  • Added Element
Location.hoursOfOperation.allDay
  • Added Element
Location.hoursOfOperation.openingTime
  • Added Element
Location.hoursOfOperation.closingTime
  • Added Element
Location.availabilityExceptions
  • Added Element

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 6 tests of which 6 fail to execute.)

Структура

ИмяФлагиКард.ТипОписание и ограниченияdoco
.. Location TUDomainResourceПодробные сведения и информация о положении физического места
Элементы, определённые в прародителе: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierУникальный код или число, идентифицируется местонахождение для его пользователей
... status ?!Σ0..1codeactive | suspended | inactive
LocationStatus (Required)
... operationalStatus Σ0..1CodingThe Operational status of the location (typically only for a bed/room)
v2 BED STATUS (Preferred)
... name Σ0..1stringНазвание места, используемое людьми
... alias 0..*stringA list of alternate names that the location is known as or was known as in the past
... description Σ0..1stringДополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
... mode Σ0..1codeinstance | kind
LocationMode (Required)
... type Σ0..*CodeableConceptТип выполняемой функции
V3 Value SetServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointКонтактные сведения для местонахождения
... address 0..1AddressФизическое местонахождение
... physicalType Σ0..1CodeableConceptФизическая форма местонахождения
Location type (Example)
... position 0..1BackboneElementАбсолютное географическое расположение
.... longitude 1..1decimalДолгота в системе координат WGS84
.... latitude 1..1decimalШирота в системе координат WGS84
.... altitude 0..1decimalВысота над уровнем моря в системе координат WGS84
... managingOrganization Σ0..1Reference(Organization)Организация, которая несет ответственность за предоставление и содержание
... partOf 0..1Reference(Location)Другой ресурс Location, физической частью которого является данный
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun
DaysOfWeek (Required)
.... allDay 0..1booleanThe Location is open all day
.... openingTime 0..1timeTime that the Location opens
.... closingTime 0..1timeTime that the Location closes
... availabilityExceptions 0..1stringDescription of availability exceptions
... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to services operated for the location

doco Документация по этому формату

UML-диаграмма (Legend)

Location (DomainResource)Уникальный код или число, идентифицируется местонахождение для его пользователейidentifier : Identifier [0..*]The status property covers the general availability of the resource, not the current value which may be covered by the operationStatus, or by a schedule/slots if they are configured for the location (this element modifies the meaning of other elements)status : code [0..1] « Показывает, находится ли все еще это местонахождение в использовании. (Strength=Required)LocationStatus! »The Operational status covers operation values most relevant to beds (but can also apply to rooms/units/chair/etc. such as an isolation unit/dialysis chair). This typically covers concepts such as contamination, housekeeping and other activities like maintenanceoperationalStatus : Coding [0..1] « The operational status if the location (where typically a bed/room). (Strength=Preferred)v2.0116? »Название места, используемое людьми. Не требуется быть уникальнымname : string [0..1]A list of alternate names that the location is known as or was known as in the pastalias : string [0..*]Описание месторасположения, которое помогает при поиске этого места или для ссылок на негоdescription : string [0..1]Показывает, представляет ли экземпляр ресурса определенное местонахождение или класс местонахожденийmode : code [0..1] « Показывает, описывает ли экземпляр ресурса конкретное местонахождение или только его тип. (Strength=Required)LocationMode! »Обозначает тип функции, выполняемой в этом местеtype : CodeableConcept [0..*] « Описывает функцию этого места. (Strength=Extensible)v3.ServiceDeliveryLocationRol...+ »Контактные сведения коммуникационных устройств, доступных в этом месте. Сюда могут входить номера телефонов, факсов, мобильных, адреса электронной почты и веб-сайтыtelecom : ContactPoint [0..*]Физическое местонахождениеaddress : Address [0..1]Физическая форма местонахождения, например здание, комната, машина, дорогаphysicalType : CodeableConcept [0..1] « Физическая форма местонахождения. (Strength=Example)LocationType?? »Организация, которая несет ответственность за предоставление и содержание местаmanagingOrganization : Reference [0..1] « Organization »Другой ресурс Location, физической частью которого является данный LocationpartOf : Reference [0..1] « Location »A description of when the locations opening ours are different to normal, e.g. public holiday availability. Succinctly describing all possible exceptions to normal site availability as detailed in the opening hours TimesavailabilityExceptions : string [0..1]Technical endpoints providing access to services operated for the locationendpoint : Reference [0..*] « Endpoint »PositionДолгота. Область значений и интерпретация такие же, как для текста элемента "longitude" в KML (см. примечания ниже)longitude : decimal [1..1]Широта. Область значений и интерпретация такие же, как для текста элемента "latitude" в KML (см. примечания ниже)latitude : decimal [1..1]Высота над уровнем моря. Область значений и интерпретация такие же, как для текста элемента "altitude" в KML (см. примечания ниже)altitude : decimal [0..1]HoursOfOperationIndicates which days of the week are available between the start and end TimesdaysOfWeek : code [0..*] « The days of the week. (Strength=Required)DaysOfWeek! »The Location is open all dayallDay : boolean [0..1]Time that the Location opensopeningTime : time [0..1]Time that the Location closesclosingTime : time [0..1]Абсолютное географическое расположение места, выраженное в системе координат WGS84 (эта же система координат используется в KML)position[0..1]What days/times during a week is this location usually openhoursOfOperation[0..*]

XML-шаблон

<Location xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Уникальный код или число, идентифицируется местонахождение для его пользователей --></identifier>
 <status value="[code]"/><!-- 0..1 active | suspended | inactive -->
 <operationalStatus><!-- 0..1 Coding The Operational status of the location (typically only for a bed/room) --></operationalStatus>
 <name value="[string]"/><!-- 0..1 Название места, используемое людьми -->
 <alias value="[string]"/><!-- 0..* A list of alternate names that the location is known as or was known as in the past -->
 <description value="[string]"/><!-- 0..1 Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию -->
 <mode value="[code]"/><!-- 0..1 instance | kind -->
 <type><!-- 0..* CodeableConcept Тип выполняемой функции --></type>
 <telecom><!-- 0..* ContactPoint Контактные сведения для местонахождения --></telecom>
 <address><!-- 0..1 Address Физическое местонахождение --></address>
 <physicalType><!-- 0..1 CodeableConcept Физическая форма местонахождения --></physicalType>
 <position>  <!-- 0..1 Абсолютное географическое расположение -->
  <longitude value="[decimal]"/><!-- 1..1 Долгота в системе координат WGS84 -->
  <latitude value="[decimal]"/><!-- 1..1 Широта в системе координат WGS84 -->
  <altitude value="[decimal]"/><!-- 0..1 Высота над уровнем моря в системе координат WGS84 -->
 </position>
 <managingOrganization><!-- 0..1 Reference(Organization) Организация, которая несет ответственность за предоставление и содержание --></managingOrganization>
 <partOf><!-- 0..1 Reference(Location) Другой ресурс Location, физической частью которого является данный --></partOf>
 <hoursOfOperation>  <!-- 0..* What days/times during a week is this location usually open -->
  <daysOfWeek value="[code]"/><!-- 0..* mon | tue | wed | thu | fri | sat | sun -->
  <allDay value="[boolean]"/><!-- 0..1 The Location is open all day -->
  <openingTime value="[time]"/><!-- 0..1 Time that the Location opens -->
  <closingTime value="[time]"/><!-- 0..1 Time that the Location closes -->
 </hoursOfOperation>
 <availabilityExceptions value="[string]"/><!-- 0..1 Description of availability exceptions -->
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the location --></endpoint>
</Location>

JSON-шаблон

{doco
  "resourceType" : "Location",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Уникальный код или число, идентифицируется местонахождение для его пользователей
  "status" : "<code>", // active | suspended | inactive
  "operationalStatus" : { Coding }, // The Operational status of the location (typically only for a bed/room)
  "name" : "<string>", // Название места, используемое людьми
  "alias" : ["<string>"], // A list of alternate names that the location is known as or was known as in the past
  "description" : "<string>", // Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
  "mode" : "<code>", // instance | kind
  "type" : [{ CodeableConcept }], // Тип выполняемой функции
  "telecom" : [{ ContactPoint }], // Контактные сведения для местонахождения
  "address" : { Address }, // Физическое местонахождение
  "physicalType" : { CodeableConcept }, // Физическая форма местонахождения
  "position" : { // Абсолютное географическое расположение
    "longitude" : <decimal>, // R!  Долгота в системе координат WGS84
    "latitude" : <decimal>, // R!  Широта в системе координат WGS84
    "altitude" : <decimal> // Высота над уровнем моря в системе координат WGS84
  },
  "managingOrganization" : { Reference(Organization) }, // Организация, которая несет ответственность за предоставление и содержание
  "partOf" : { Reference(Location) }, // Другой ресурс Location, физической частью которого является данный
  "hoursOfOperation" : [{ // What days/times during a week is this location usually open
    "daysOfWeek" : ["<code>"], // mon | tue | wed | thu | fri | sat | sun
    "allDay" : <boolean>, // The Location is open all day
    "openingTime" : "<time>", // Time that the Location opens
    "closingTime" : "<time>" // Time that the Location closes
  }],
  "availabilityExceptions" : "<string>", // Description of availability exceptions
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the location
}

Turtle-шаблон

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Location;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Location.identifier [ Identifier ], ... ; # 0..* Уникальный код или число, идентифицируется местонахождение для его пользователей
  fhir:Location.status [ code ]; # 0..1 active | suspended | inactive
  fhir:Location.operationalStatus [ Coding ]; # 0..1 The Operational status of the location (typically only for a bed/room)
  fhir:Location.name [ string ]; # 0..1 Название места, используемое людьми
  fhir:Location.alias [ string ], ... ; # 0..* A list of alternate names that the location is known as or was known as in the past
  fhir:Location.description [ string ]; # 0..1 Дополнительные детали о месторасположении, которые могут отображаться для определения месторасположения вдобавок к его названию
  fhir:Location.mode [ code ]; # 0..1 instance | kind
  fhir:Location.type [ CodeableConcept ], ... ; # 0..* Тип выполняемой функции
  fhir:Location.telecom [ ContactPoint ], ... ; # 0..* Контактные сведения для местонахождения
  fhir:Location.address [ Address ]; # 0..1 Физическое местонахождение
  fhir:Location.physicalType [ CodeableConcept ]; # 0..1 Физическая форма местонахождения
  fhir:Location.position [ # 0..1 Абсолютное географическое расположение
    fhir:Location.position.longitude [ decimal ]; # 1..1 Долгота в системе координат WGS84
    fhir:Location.position.latitude [ decimal ]; # 1..1 Широта в системе координат WGS84
    fhir:Location.position.altitude [ decimal ]; # 0..1 Высота над уровнем моря в системе координат WGS84
  ];
  fhir:Location.managingOrganization [ Reference(Organization) ]; # 0..1 Организация, которая несет ответственность за предоставление и содержание
  fhir:Location.partOf [ Reference(Location) ]; # 0..1 Другой ресурс Location, физической частью которого является данный
  fhir:Location.hoursOfOperation [ # 0..* What days/times during a week is this location usually open
    fhir:Location.hoursOfOperation.daysOfWeek [ code ], ... ; # 0..* mon | tue | wed | thu | fri | sat | sun
    fhir:Location.hoursOfOperation.allDay [ boolean ]; # 0..1 The Location is open all day
    fhir:Location.hoursOfOperation.openingTime [ time ]; # 0..1 Time that the Location opens
    fhir:Location.hoursOfOperation.closingTime [ time ]; # 0..1 Time that the Location closes
  ], ...;
  fhir:Location.availabilityExceptions [ string ]; # 0..1 Description of availability exceptions
  fhir:Location.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the location
]

Changes since Release 3

Location
Location.mode
  • No longer marked as Modifier
Location.type
  • Max Cardinality changed from 1 to *
Location.hoursOfOperation
  • Added Element
Location.hoursOfOperation.daysOfWeek
  • Added Element
Location.hoursOfOperation.allDay
  • Added Element
Location.hoursOfOperation.openingTime
  • Added Element
Location.hoursOfOperation.closingTime
  • Added Element
Location.availabilityExceptions
  • Added Element

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 6 tests of which 6 fail to execute.)

 

See the Profiles & Extensions and the Альтернативные определения: Основное определение XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the Анализ зависимостей

PathОписаниеТипСсылка
Location.status Показывает, находится ли все еще это местонахождение в использовании.RequiredLocationStatus
Location.operationalStatus The operational status if the location (where typically a bed/room).Preferredv2.0116
Location.mode Показывает, описывает ли экземпляр ресурса конкретное местонахождение или только его тип.RequiredLocationMode
Location.type Описывает функцию этого места.Extensiblev3.ServiceDeliveryLocationRoleType
Location.physicalType Физическая форма местонахождения.ExampleLocationType
Location.hoursOfOperation.daysOfWeek The days of the week.RequiredDaysOfWeek

  • 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 .

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

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.

Searching for locations often require that a facility is within a specified distance of a specified point. For example, to locate healthcare facilities within 11.2 kms of a client's home, or the current geo-coded position of a practitioner travelling between patients (read from a mobile phone or device).

 GET [base]/Location?near=-83.694810|42.256500|11.20|km...

The distance and distance unit parameter components are optional, if the units are missing, kms are to be assumed. If the distance parameter component is missing, then the server may choose its own interpretation of what near enough is to be included in the search results.

Note: The STU3 version of this functionality did not support the multiple multiple separator , or chaining. The update to this format now supports both these use cases.
(And the near-distance was deprecated as a result of this change too)

The distance between the location and the provided point is often used as one of the determining factors for selection of the location. So this value is included in the results.
However the value cannot be inside the Location resource as it is different depending on the point of reference in the search. So the distance between is included in the search section of the bundle entry. Where multiple near positions are included, the distance to the closest point provided may be included.

<entry> 
    <resource>
        <Location>
            <!-- location details -->
        </Location>
    </resource>
    <search>
        <extension url="http://hl7.org/fhir/StructureDefinition/location-distance">
            <valueDistance >
                <!-- The distance that this location resource is from the provided point in the query --<
                </value value="10.5"/>
                </unit value="km"/>
            </valueDistance>
        </extension>
    </search>
</entry> 

Параметры поиска для этого ресурса. Также к нему применяются общие параметры. Более подробную информацию о поиске в REST, обмене сообщениями и сервисах см. в разделе Поиск.

ИмяТипОпределениеВыражениеIn Common
addressstringАдрес или часть адреса этого местаLocation.address
address-citystringГород, указанный в адресеLocation.address.city
address-countrystringСтрана, указанная в адресеLocation.address.country
address-postalcodestringПочтовый индекс, указанный в адресеLocation.address.postalCode
address-statestringШтат, указанный в адресеLocation.address.state
address-usetokenКод типа использования, указанный в адресеLocation.address.use
endpointreferenceTechnical endpoints providing access to services operated for the locationLocation.endpoint
(Endpoint)
identifiertokenAn identifier for the locationLocation.identifier
namestringA portion of the location's name or aliasLocation.name | Location.alias
nearspecialSearch for locations where the location.position is near to, or within a specified distance of, the provided coordinates expressed as [latitude]|[longitude]|[distance]|[units] (using the WGS84 datum, see notes). If the units are omitted, then kms should be assumed. If the distance is omitted, then the server can use its own discression as to what distances should be considered near (and units are irrelevant) Servers may search using various techniques that might have differing accuracies, depending on implementation efficiency. Requires the near-distance parameter to be provided alsoLocation.position
operational-statustokenSearches for locations (typically bed/room) that have an operational status (e.g. contaminated, housekeeping)Location.operationalStatus
organizationreferenceПоиск местонахождений, контролируемых указанной организациейLocation.managingOrganization
(Organization)
partofreferenceA location of which this location is a partLocation.partOf
(Location)
statustokenПоиск по местонахождениям с указанным видом статусаLocation.status
typetokenКод типа местонахожденияLocation.type