臺灣社政領域基礎實作指引
0.0.1 - ci-build

臺灣社政領域基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

Resource Profile: 服務地點及托育地址-Location TWSS Base

Official URL: https://sfaa.gov.tw/base/StructureDefinition/Location-twss-base Version: 0.0.1
Draft as of 2026-08-10 Computable Name: LocationTWSSBase

繼承 TW Core IG 0.3.2 的 Location Profile，並補充社福服務地點的管理機構與座標資料。

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..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... 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): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTWSSBase 服務地點或托育地址。
... position S 0..1 BackboneElement 絕對地理位置
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍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 TWCoreLocation

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... address 0..1 AddressTWSSBase 服務地點或托育地址。
... position S 0..1 BackboneElement 絕對地理位置
.... longitude S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
... managingOrganization 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... 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: Hl7VSBedStatus (3.0.0) (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 (3.0.0) (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 AddressTWSSBase 服務地點或托育地址。
... physicalType 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position S 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 S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。
... 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 📍3.0.0 THO v7.3
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📍3.0.0 THO v7.3
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..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 0..1 code active | suspended | inactive
Binding: LocationStatus (required): 地點的狀態，指明該地點是否目前正在使用中；應填入所綁定值集中的其中一個代碼。
... 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): 此聯絡方式的用途；應填入所綁定值集中的其中一個代碼。
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... address S 0..1 AddressTWSSBase 服務地點或托育地址。
... position S 0..1 BackboneElement 絕對地理位置
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.telecom.system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Location.telecom.use Base required ContactPointUse 📍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 TWCoreLocation

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... address 0..1 AddressTWSSBase 服務地點或托育地址。
... position S 0..1 BackboneElement 絕對地理位置
.... longitude S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
... managingOrganization 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* TWCoreLocation 用於描述一個實體地點的詳細資訊和位置資訊
... 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: Hl7VSBedStatus (3.0.0) (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 (3.0.0) (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 AddressTWSSBase 服務地點或托育地址。
... physicalType 0..1 CodeableConceptTW 絕對的地理位置
Binding: LocationType (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
... position S 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 S 1..1 decimal 機構地址經度。
.... latitude S 1..1 decimal 機構地址緯度。
.... altitude 0..1 decimal 以 WGS84 為基準的海拔高度
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 此服務地點所屬機構。
... 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 📍3.0.0 THO v7.3
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📍3.0.0 THO v7.3
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