臺灣核心實作指引(TW Core IG)
0.3.3 - Ci-Build Trial Use

臺灣核心實作指引(TW Core IG), published by 衛生福利部. This guide is not an authorized publication; it is the continuous build for version 0.3.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/MOHW-TWCoreIG/cctwFHIRterm/ and changes regularly. See the Directory of published versions

Resource Profile: TW Core Location

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Location-twcore Version: 0.3.3
Active as of 2025-11-21 Computable Name: TWCoreLocation

此臺灣核心-地點（TW Core Location） Profile說明本IG如何進一步定義FHIR的Location Resource以呈現地點的詳細資料。

Resource Location - 內容

這是關於一個提供服務的具體位置的描述，包括那裡如何存放、查找、包含或安置資源和人員的資訊。

範圍與使用

地點（Location）既包括臨時的地方（像是一個沒有提前被指定或批准就用來提供醫療服務的地方），也包括那些被正式確定用於特定目的的地方。這些地點既可以是私有的，也可以是公有的，有的可以移動，有的是固定不動的，大小也各不相同，從小型的冷凍箱到整座醫院大樓或停車場都是。

地點的例子有：

  • 建築物、病區、走廊、房間或床位
  • 流動診所
  • 冷凍箱、孵育器
  • 車輛或升降機
  • 家裡、小屋或車庫
  • 道路、停車位、公園
  • 救護車（通稱）
  • 救護車（具體指某一輛）
  • 病人的家（通稱）
  • 行政管轄區

這裡提到的地點位置不是指病人身上發生了什麼（比如病人的腿斷了那裡），而是指病人腿斷發生時的地點（比如在遊樂場）。

界限與關聯

地點（Location）和機構（Organization）是兩種密切相關的resources，但它們的用途有所不同。地點專注於描述具體的實體空間，這些空間由機構管理或運營。相比之下，機構更多地代表組織結構上的概念層次，例如：管理一間病房。

在某些情況下，地點可以不需要具體的地址就有效，例如：透過地理編碼描述偏遠地區，或由裝置記錄的位置。那些模式為「kind」的地點通常也不會有地址，因為它們只是表示一種地點的類型，但如果這些地點有一個具體地址可以找到，那麼也可以記錄地址。

地點還可以用來描述一個管轄區域，這可能是基於實體邊界和其他特定因素組合而定的一個範圍，例如：

  • 國家 - 涵蓋全國的社區或聯邦政府（如：衛生部/衛生福利部）；
  • 省份或州 （社區或政府）；
  • 業務 （跨越整個企業）；
  • 業務範圍 - 如疾病管制署（CDC）或食品藥物管理署（FDA）；
  • 業務部門 - 如英國的藥局。

這個 resource 被多個其他 FHIR resources 參照，包括使用上下文/情境（UsageContext）、帳戶（Account）、活動定義（ActivityDefinition）、醫療不良事件（AdverseEvent）、預約（Appointment）、預約回應（AppointmentResponse）等。

註釋（Notes）

  • 多個機構（Organization）或健康照護服務提供者（Practitioner）可能在同一個地點（Location）提供服務。這些參照資訊不會被保存在Location resource中，而是可以在機構（Organization）和健康照護服務提供者（Practitioner）的模型中找到。
  • 地點可以範圍從整棟建築到小櫃子；使用地點的partOf資料項目可以將較小的地點與包含它的較大地點關聯起來。
  • 地點的位置（Location.position）使用與Google Earth的KML文件相同的語法、基準和參照系統表示，詳見Google/OGS的KML標準。

Location Mode

Location.mode資料項目可以用來指示一個 Location resource 是代表一個特定的（可能可識別的）地點（「instance」），還是某類地點（「kind」）。特別是在涉及醫令、排程、計劃和定義的時，可能會參照處於「kind」mode的地點。在這些領域，往往不需要指向一個具體的地點，而是指向某類地點。這在計劃時尤其明顯，比如我們需要為一位病人分配「一間隔離室」，或者在特定時間派遣「一輛救護車」。在這些情況下，沒有必要確切識別哪一個隔離室或哪一輛救護車被分配，只需指出是一種地點的「kind」就足夠了。

需要注意的是：當你有一個具體的地點參與，但缺少該地點的具體識別資訊時，應該使用「instance」mode，即使無法提供該地點的完整識別資訊。這是因為「instance」模式用於表示一個具體的、特定的地點實例，即使某些具體細節（如identifier）未知。

而「kind」 mode則不應用於試圖填補關於具體地點實例缺失資訊的情況，而是用於表示某類地點，即一個通用類別或地點的類型，而不是指向一個具體的、可識別的單一地點。

所以，如果我們知道某個具體事件（如病人乘救護車到達）涉及一個具體的地點實例，但我們不知道是哪一輛救護車，我們仍然應該使用「instance」mode並嘗試提供盡可能多的資料，而不是使用「kind」mode。「kind」是用於當我們需要參用一個廣泛的地點類別，而不是特定的地點實例時。

當mode為「instance」時，一些資料項目才適用；當mode為「kind」時以下這些資料項目通常不使用：（不過，如果某些資訊對於描述某類地點來說仍然有意義，即使它是特定於某個範圍的通用而非全球通用的，例如：代表Burgers Medical Centre的某一輛救護車，這時這些資料項目還是可以被包含進來的。）

  • 地點的唯一識別碼（Location.identifier）
  • 地點的聯絡方式（Location.telecom）
  • 地點的地址（Location.address）
  • 地點的位置（Location.position）
  • 地點的狀態（Location.status）
  • 管理地點的機構（Location.managingOrganization）

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Location Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier 地點的唯一識別號
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus Σ 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name SΣ 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description Σ 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type Σ 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... system SΣC 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 0..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType Σ 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

This structure is derived from Location

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta 0..1 Meta 此Location Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
... identifier 0..* Identifier 地點的唯一識別號
... status S 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name S 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... system S 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value S 0..1 string 實際的聯絡方式之細節
.... use S 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period S 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization S 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Location Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier 地點的唯一識別號
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus Σ 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name SΣ 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description Σ 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type Σ 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... system SΣC 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 0..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType Σ 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Location Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier 地點的唯一識別號
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus Σ 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name SΣ 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description Σ 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type Σ 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... system SΣC 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 0..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType Σ 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Differential View

This structure is derived from Location

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta 0..1 Meta 此Location Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
... identifier 0..* Identifier 地點的唯一識別號
... status S 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name S 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... system S 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value S 0..1 string 實際的聯絡方式之細節
.... use S 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period S 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization S 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location 用於描述一個實體地點的詳細資訊和位置資訊
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Location紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Location Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Location Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier 地點的唯一識別號
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... operationalStatus Σ 0..1 Coding 地點的運營狀態（通常僅適用於床位 / 房間）
Binding: hl7VS-bedStatus (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
... name SΣ 1..1 string 人們使用的地點名稱
... alias 0..* string 這是一份地點過去或現在所使用的其他名稱的清單
... description Σ 0..1 string 關於地點的額外資訊，除了名稱之外，還可以提供更多的細節來幫助識別這個地點。
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): 表明為一個地點或是一個地點的類別；應填入所綁定值集中的其中一個代碼。
... type Σ 0..* CodeableConceptTW 執行的功能類型
Binding: ServiceDeliveryLocationRoleType (extensible): 應填入所綁定值集中的其中一個代碼。
... telecom S 0..* ContactPoint 地點的聯絡細節
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... system SΣC 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 0..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile
Binding: ContactPointUse (required): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTW 實體地點
... physicalType Σ 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position 0..1 BackboneElement 絕對地理位置
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal 以 WGS84 為基準的經度
.... latitude 1..1 decimal 以 WGS84 為基準的緯度
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(TW Core Organization) 負責地點的提供與維護之機構
... partOf 0..1 Reference(TW Core Location) 此地點是另一個地點的一部分
... hoursOfOperation 0..* BackboneElement 這個地點通常在一個星期的哪些日子/時間開放？
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 此地點全天開放
.... openingTime 0..1 time 此地點的開放時間
.... closingTime 0..1 time 此地點的關閉時間
... availabilityExceptions 0..1 string 可用性例外情況說明
... endpoint 0..* Reference(Endpoint) 提供用於此地點運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦2.0.0 THO v7.0
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.0
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍4.0.1 FHIR Std.
Location.physicalType Base example Location type 📦4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單，請參閱TW Core Server能力聲明。

建議應該支援以下查詢參數：

  1. 建議應該（SHOULD） 支援透過查詢參數 _id 查詢所有Location：
    (如何透過token查詢)
    GET [base]/Location?_id=[id]
    GET [base]/Location/[id]

    例子：
    (1) GET [base]/Location?_id=loc-ent-example
    (2) GET [base]/Location/loc-ent-example

  2. 建議應該（SHOULD） 支援透過查詢參數 address 查詢所有Location：
    (如何透過string查詢)
    GET [base]/Location?address=[string]

    例子：
    (1) GET [base]/Location?address=新北市

  3. 建議應該（SHOULD） 支援透過查詢參數 name 查詢所有Location：
    (如何透過string查詢)
    GET [base]/Location?name=[string]

    例子：
    (1) GET [base]/Location?name=衛生福利部臺北醫院