Current Build

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

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

Patient Administration Work GroupMaturity Level: 3 Trial UseCompartments: Not linked to any defined compartments

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

Ресурс Location (Местонахождение) включает в себя как случайные места (место, которое используется для оказания услуг здравоохранения без предварительного назначения или разрешения), так и выделенные, формально назначаемые места. Местонахождение может быть частным, государственным, мобильным или фиксированным, и варьироваться по масштабу от малых морозильных камер до целых зданий больниц или автостоянок.

Примеры местонахождений :

  • Здание, палата, коридор, комната или койка
  • Мобильная клиника
  • Морозильник, инкубатор
  • Автомобиль или лифт
  • Дом, сарай или гараж
  • Дорога, парковочное место, парк
  • Машина скорой помощи (вообще)
  • Машина скорой помощи (конкретная)
  • Дом пациента (вообще)
  • Страна

Эти местонахождения не предназначены для указания частей тела пациента, на которых с ним что-то произошло (например сломанная нога пациента), но успешно используются для указания места, где пациент сломал ногу (например детская площадка).

Ресурсы Location и Organization тесно связаны между собой и часто комбинируются/совпадают/вызывают путаницу.
Ресурс Location в большей мере предназначен для описания физических структур, которыми управляет/эксплуатирует организация, а ресурс Organization больше предназначен для представления концептуальных иерархий, таких как палата.

В ресурсе Location можно не указывать точный адрес, когда он описывается географическими координатами отдаленных областей, или при записи с помощью устройства. Ресурсы Locations с режимом = "kind" тоже не будут иметь адреса, так как они обозначают только тип местонахождения, но также могут иметь и адрес, по которому они могут быть найдены.

Ресурс Location можно использовать для описания некоторой юрисдикции. Это может быть сочетание физических границ и ещё какого-то дискриминатора(-ов):

  • Страна - общенациональное сообщество или федеральное правительство (Министерство здравоохранения)
  • Область или штат (сообщество или Правительство)
  • Бизнес (по предприятию)
  • Сфера бизнеса (CDC/FDA)
  • Бизнес-сегмент (фармацевтическое дело в Великобритании)

На этот ресурс ссылаются Account, ActivityDefinition, AdverseEvent, Appointment, AppointmentResponse, AuditEvent, CarePlan, Claim, Contract, Device, DeviceRequest, DiagnosticReport, EligibilityRequest, Encounter, ExplanationOfBenefit, Flag, HealthcareService, Immunization, List, MedicationDispense, Observation, PractitionerRole, Procedure, Provenance, ResearchStudy, Schedule, ServiceRequest, SupplyDelivery и SupplyRequest

Структура

ИмяФлагиКард.ТипОписание и ограниченияdoco
.. Location DomainResourceПодробные сведения и информация о положении физического места
Элементы, определённые в прародителе: 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..1CodeableConceptТип выполняемой функции
ServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointКонтактные сведения для местонахождения
... address 0..1AddressФизическое местонахождение
... physicalType Σ0..1CodeableConceptФизическая форма местонахождения
LocationType (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, физической частью которого является данный
... 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/dialisys 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 Bed Status? »Название места, используемое людьми. Не требуется быть уникальным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]Показывает, представляет ли экземпляр ресурса определенное местонахождение или класс местонахождений (this element modifies the meaning of other elements)mode : code [0..1] « Показывает, описывает ли экземпляр ресурса конкретное местонахождение или только его тип. (Strength=Required)LocationMode! »Обозначает тип функции, выполняемой в этом местеtype : CodeableConcept [0..1] « Описывает функцию этого места. (Strength=Extensible)ServiceDeliveryLocationRoleTy...+ »Контактные сведения коммуникационных устройств, доступных в этом месте. Сюда могут входить номера телефонов, факсов, мобильных, адреса электронной почты и веб-сайты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 »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]Абсолютное географическое расположение места, выраженное в системе координат WGS84 (эта же система координат используется в KML)position[0..1]

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..1 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>
 <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, физической частью которого является данный
  "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..1 Тип выполняемой функции
  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.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the location
]

Changes since DSTU2

Location
Location.operationalStatus
  • Added Element
Location.alias
  • Added Element
Location.endpoint
  • Added Element

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 6 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.).

Структура

ИмяФлагиКард.ТипОписание и ограниченияdoco
.. Location DomainResourceПодробные сведения и информация о положении физического места
Элементы, определённые в прародителе: 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..1CodeableConceptТип выполняемой функции
ServiceDeliveryLocationRoleType (Extensible)
... telecom 0..*ContactPointКонтактные сведения для местонахождения
... address 0..1AddressФизическое местонахождение
... physicalType Σ0..1CodeableConceptФизическая форма местонахождения
LocationType (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, физической частью которого является данный
... 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/dialisys 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 Bed Status? »Название места, используемое людьми. Не требуется быть уникальным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]Показывает, представляет ли экземпляр ресурса определенное местонахождение или класс местонахождений (this element modifies the meaning of other elements)mode : code [0..1] « Показывает, описывает ли экземпляр ресурса конкретное местонахождение или только его тип. (Strength=Required)LocationMode! »Обозначает тип функции, выполняемой в этом местеtype : CodeableConcept [0..1] « Описывает функцию этого места. (Strength=Extensible)ServiceDeliveryLocationRoleTy...+ »Контактные сведения коммуникационных устройств, доступных в этом месте. Сюда могут входить номера телефонов, факсов, мобильных, адреса электронной почты и веб-сайты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 »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]Абсолютное географическое расположение места, выраженное в системе координат WGS84 (эта же система координат используется в KML)position[0..1]

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..1 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>
 <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, физической частью которого является данный
  "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..1 Тип выполняемой функции
  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.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the location
]

Changes since DSTU2

Location
Location.operationalStatus
  • Added Element
Location.alias
  • Added Element
Location.endpoint
  • Added Element

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 6 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.).

 

Альтернативные определения: Основное определение (XML, JSON), XML Schema/Schematron + JSON Schema, ShEx (for Turtle)

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

  • В одном и том же местонахождении оказывать услуги могут одновременно несколько организаций или специалистов. Такие ссылки указываются не в ресурсе Location, а в Organization и Practitioner.
  • Местонахождения могут варьироваться от целых зданий до шкафов; с помощью элемента Location.partOf можно соотносить меньшие местонахождения с содержащими их более крупными местонахождениями.
  • Для выражения Location.position используется такой же синтаксис, показатели и система ссылок, что и в Google Earth KML-файлах, см. Google/OGS's KML .

В элементе Location.mode указывается тип местонахождения, представляет ли ресурс Location определенное (потенциально идентифицируемое) местонахождение ('экземпляр') или класс местонахождения ('вид'). Особенно ресурсы для ввода заказов, для планирования ресурсов, планы и определения могут использовать ресурс Location в режиме 'kind'. В этих областях применения часто нет необходимости ссылаться на конкретное место, а можно указывать только класс местонахождения. Пример такой ссылки можно найти в планировании, где нам необходимо выделить "изолированную комнату" для пациента, или необходимо отправить "скорую" в определенное время. В этих случаях не имеет значения, какая именно изолированная комната или скорая помощь имеется в виду, и достаточно просто указать "вид" местонахождения.

Обратите внимание, что режим "вид" не следует использовать для представления местонахождения, если при этом имеется в виду экземпляр местонахождения, но отсутствует идентификационная информация. Например когда пациент прибыл "на скорой", но не известно на какой машине скорой помощи, это должно быть представлено с помощью ресурса Location в режиме "instance" без указания идентификатора, а не Location 'вида' скорая помощь.

Некоторые из элементов данных ресурса Location имеют значение только в режиме "instance" и не должны быть использованы в режиме "kind":
(однако эта информация все еще может быть включена, если она необходима, например когда это общий элемент, но не глобально общий, например машина скорой помощи Burgers MU)

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

Пример иерархии местонахождений призван помочь дать некоторые рекомендации в качестве примера, как может выглядеть иерархия местонахождений в фиктивной больнице.
(Вложенность здесь будет передаваться с помощью структуры "part-of")

Больница A Строение C (instance)
    Восточное крыло (instance)
        Уровень 1 (instance)
            Приемная (instance)
            Пост медицинской сестры EM-ns1 (instance)
                Медицинский шкаф A (instance)
            Комната 1 (instance)
                Комната 1a (instance) - пространство в комнате может разделяться с помощью занавески
                    Кровать 1a (instance) - всегда в этой комнате
                Комната 1b (instance)
                    Каталка 43 (instance) - перемещается
                Комната 1d (instance)
                    Каталка 19 (instance) - перемещается
                Комната 2 (instance)
                    ...
            Демонстрационный зал EM-TA (instance)
            Коридор (generic)
        Уровень 2 (instance)
            Приемная (instance)
                ...
            Пост медицинской сестры EM-ns1 (instance)
                Медицинский шкаф A (instance)
            Коридор (generic)
Мобильные службы (kind)
    Машина скорой помощи (kind)
        Машина скорой помощи AMB1 (instance)
        Машина скорой помощи AMB2 (instance)
	

Примечание: палаты/отделения не являются частью этой структуры - они входят в организационную иерархию.

Searching for locations often require that a facility is within a specified distance of a particular point. For example, to locate healthcare facilities within 2kms of a clients 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&near-distance=11.20||km...

Note: The near search parameters are not able to be used with multiples thus the multiple seperator , should not be used with near or near-distance.

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.

<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
neartokenThe coordinates expressed as [latitude]:[longitude] (using the WGS84 datum, see notes) to find locations near to (servers may search using a square rather than a circle for efficiency) Requires the near-distance parameter to be provided alsoLocation.position
near-distancequantityA distance quantity to limit the near search to locations within a specific distance Requires the near parameter to also be includedLocation.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