HL7 FHIR JP Core ImplementationGuide
1.1.0 - release Japan flag

HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.0). See the Directory of published versions

Resource Profile: JP Core Location Profile

項目内容
定義URL http://jpfhir.jp/fhir/core/StructureDefinition/JP_Location
Version 1.1.0
Name

JP_Location
Title

JP Core Location Profile
Status Active ( 2022-10-24 )
Copyright

Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG

このプロファイルはLocationリソースに対して、所在場所のデータを送受信するための基礎となる制約と拡張を定めたものである。


本プロファイルは、患者、プロバイダ、または組織に関連付けられたロケーションを記録、検索、およびフェッチするために 、FHIR Location リソースを使用するにあたっての、最低限の制約を記述したものである。Location リソースに対して本プロファイルに準拠する場合に必須となる要素や、サポートすべき拡張、用語、検索パラメータを定義する。

背景および想定シナリオ

本プロファイルは、以下のようなユースケースを想定している。

  • 所在場所名または所在場所の住所による所在場所の検索

  • 他のリソースからの所在場所の参照（例：Encounterリソースのhospitalizationで参照される患者の入院前や退院後の所在場所）

スコープ

所在場所には、偶発的な場所（事前の指定や許可なしに医療に使用される場所）と、正式に指定された専用の場所の両方が含まれる。場所は、プライベート、パブリック、モバイル、または固定であり、小さな冷凍庫から完全な病院の建物または駐車場までの規模になる。本リソースに含まれる所在場所の例を示す（ただし、この一覧に限定されない）。

  • 建物、病棟、廊下、部屋またはベッド
  • モバイルクリニック
  • 冷凍庫、インキュベーター
  • 車両またはリフト
  • 家、小屋、またはガレージ
  • 道路、駐車場、公園
  • 救急車（ジェネリック）
  • 救急車（特定）
  • 患者の家（一般）
  • 管轄

これらの所在場所は、何かが発生した患者の所在場所（骨折した部位、例えば足）をカバーすることを目的としていないが、患者が足を骨折した場所（例えば、遊び場）をカバーできる。

プロファイル定義

Usage:

プロファイル詳細

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Location 0..*Location物理的な場所の詳細情報と位置情報
... identifier 0..*IdentifierUnique code or number identifying the location to its users / ユーザに場所を特定する一意のコードまたは番号
... status 0..1codeactive | suspended | inactive / アクティブ|中断|非アクティブ
... operationalStatus 0..1CodingThe operational status of the location (typically only for a bed/room) / ロケーションの運用ステータス（通常、ベッド/部屋のみ）
... name 0..1stringName of the location as used by humans / 人間が使用する場所の名前
... alias 0..*stringA list of alternate names that the location is known as, or was known as, in the past / その場所が過去に知られていた、または以前から知られていた別名のリスト
... description 0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name / 名前以外の場所を識別するための詳細情報として表示できる場所に関する追加の詳細
... mode 0..1codeinstance | kind / インスタンス|種類
... type 0..*CodeableConceptType of function performed / 実行される機能のタイプ
... telecom 0..*ContactPointContact details of the location / 所在地の連絡先
... address 0..1AddressPhysical location / 物理的な場所
... physicalType 0..1CodeableConceptPhysical form of the location / 場所の物理的な形態
... position 0..1BackboneElementThe absolute geographic location / 絶対的な地理的位置
.... longitude 1..1decimalLongitude with WGS84 datum / WGS84データの経度
.... latitude 1..1decimalLatitude with WGS84 datum / WGS84データの緯度
.... altitude 0..1decimalAltitude with WGS84 datum / WGS84データによる高度
... managingOrganization 0..1Reference(JP Core Organization Profile)Organization responsible for provisioning and upkeep / プロビジョニングと維持管理を担当する組織
... partOf 0..1Reference(JP Core Location Profile)Another Location this one is physically a part of / この場所が物理的に存在するもう一つの場所
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open / この場所は通常、1週間のうち何日/時間帯に営業している
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun / 月｜火｜水｜木｜金｜土｜日
.... 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 Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Location 0..*Location物理的な場所の詳細情報と位置情報
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierUnique code or number identifying the location to its users / ユーザに場所を特定する一意のコードまたは番号
... status ?!Σ0..1codeactive | suspended | inactive / アクティブ|中断|非アクティブ
Binding: LocationStatus (required): Indicates whether the location is still in use.

... operationalStatus Σ0..1CodingThe operational status of the location (typically only for a bed/room) / ロケーションの運用ステータス（通常、ベッド/部屋のみ）
Binding: hl7VS-bedStatus (preferred): The operational status if the location (where typically a bed/room).

... name Σ0..1stringName of the location as used by humans / 人間が使用する場所の名前
... alias 0..*stringA list of alternate names that the location is known as, or was known as, in the past / その場所が過去に知られていた、または以前から知られていた別名のリスト
... description Σ0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name / 名前以外の場所を識別するための詳細情報として表示できる場所に関する追加の詳細
... mode Σ0..1codeinstance | kind / インスタンス|種類
Binding: LocationMode (required): Indicates whether a resource instance represents a specific location or a class of locations.

... type Σ0..*CodeableConceptType of function performed / 実行される機能のタイプ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.


... telecom 0..*ContactPointContact details of the location / 所在地の連絡先
... address 0..1AddressPhysical location / 物理的な場所
... physicalType Σ0..1CodeableConceptPhysical form of the location / 場所の物理的な形態
Binding: LocationType (example): Physical form of the location.

... position 0..1BackboneElementThe absolute geographic location / 絶対的な地理的位置
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... longitude 1..1decimalLongitude with WGS84 datum / WGS84データの経度
.... latitude 1..1decimalLatitude with WGS84 datum / WGS84データの緯度
.... altitude 0..1decimalAltitude with WGS84 datum / WGS84データによる高度
... managingOrganization Σ0..1Reference(JP Core Organization Profile)Organization responsible for provisioning and upkeep / プロビジョニングと維持管理を担当する組織
... partOf 0..1Reference(JP Core Location Profile)Another Location this one is physically a part of / この場所が物理的に存在するもう一つの場所
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open / この場所は通常、1週間のうち何日/時間帯に営業している
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun / 月｜火｜水｜木｜金｜土｜日
Binding: DaysOfWeek (required): The days of the week.


.... 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 Documentation for this format

Terminology Bindings

PathConformanceValueSet
Location.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Location.statusrequiredLocationStatus
Location.operationalStatuspreferredHl7VSBedStatus
Location.moderequiredLocationMode
Location.typeextensibleServiceDeliveryLocationRoleType
Location.physicalTypeexampleLocationType
Location.hoursOfOperation.daysOfWeekrequiredDaysOfWeek

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Location 0..*Location物理的な場所の詳細情報と位置情報
... identifier 0..*IdentifierUnique code or number identifying the location to its users / ユーザに場所を特定する一意のコードまたは番号
... status 0..1codeactive | suspended | inactive / アクティブ|中断|非アクティブ
... operationalStatus 0..1CodingThe operational status of the location (typically only for a bed/room) / ロケーションの運用ステータス（通常、ベッド/部屋のみ）
... name 0..1stringName of the location as used by humans / 人間が使用する場所の名前
... alias 0..*stringA list of alternate names that the location is known as, or was known as, in the past / その場所が過去に知られていた、または以前から知られていた別名のリスト
... description 0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name / 名前以外の場所を識別するための詳細情報として表示できる場所に関する追加の詳細
... mode 0..1codeinstance | kind / インスタンス|種類
... type 0..*CodeableConceptType of function performed / 実行される機能のタイプ
... telecom 0..*ContactPointContact details of the location / 所在地の連絡先
... address 0..1AddressPhysical location / 物理的な場所
... physicalType 0..1CodeableConceptPhysical form of the location / 場所の物理的な形態
... position 0..1BackboneElementThe absolute geographic location / 絶対的な地理的位置
.... longitude 1..1decimalLongitude with WGS84 datum / WGS84データの経度
.... latitude 1..1decimalLatitude with WGS84 datum / WGS84データの緯度
.... altitude 0..1decimalAltitude with WGS84 datum / WGS84データによる高度
... managingOrganization 0..1Reference(JP Core Organization Profile)Organization responsible for provisioning and upkeep / プロビジョニングと維持管理を担当する組織
... partOf 0..1Reference(JP Core Location Profile)Another Location this one is physically a part of / この場所が物理的に存在するもう一つの場所
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open / この場所は通常、1週間のうち何日/時間帯に営業している
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun / 月｜火｜水｜木｜金｜土｜日
.... 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 Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Location 0..*Location物理的な場所の詳細情報と位置情報
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierUnique code or number identifying the location to its users / ユーザに場所を特定する一意のコードまたは番号
... status ?!Σ0..1codeactive | suspended | inactive / アクティブ|中断|非アクティブ
Binding: LocationStatus (required): Indicates whether the location is still in use.

... operationalStatus Σ0..1CodingThe operational status of the location (typically only for a bed/room) / ロケーションの運用ステータス（通常、ベッド/部屋のみ）
Binding: hl7VS-bedStatus (preferred): The operational status if the location (where typically a bed/room).

... name Σ0..1stringName of the location as used by humans / 人間が使用する場所の名前
... alias 0..*stringA list of alternate names that the location is known as, or was known as, in the past / その場所が過去に知られていた、または以前から知られていた別名のリスト
... description Σ0..1stringAdditional details about the location that could be displayed as further information to identify the location beyond its name / 名前以外の場所を識別するための詳細情報として表示できる場所に関する追加の詳細
... mode Σ0..1codeinstance | kind / インスタンス|種類
Binding: LocationMode (required): Indicates whether a resource instance represents a specific location or a class of locations.

... type Σ0..*CodeableConceptType of function performed / 実行される機能のタイプ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.


... telecom 0..*ContactPointContact details of the location / 所在地の連絡先
... address 0..1AddressPhysical location / 物理的な場所
... physicalType Σ0..1CodeableConceptPhysical form of the location / 場所の物理的な形態
Binding: LocationType (example): Physical form of the location.

... position 0..1BackboneElementThe absolute geographic location / 絶対的な地理的位置
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... longitude 1..1decimalLongitude with WGS84 datum / WGS84データの経度
.... latitude 1..1decimalLatitude with WGS84 datum / WGS84データの緯度
.... altitude 0..1decimalAltitude with WGS84 datum / WGS84データによる高度
... managingOrganization Σ0..1Reference(JP Core Organization Profile)Organization responsible for provisioning and upkeep / プロビジョニングと維持管理を担当する組織
... partOf 0..1Reference(JP Core Location Profile)Another Location this one is physically a part of / この場所が物理的に存在するもう一つの場所
... hoursOfOperation 0..*BackboneElementWhat days/times during a week is this location usually open / この場所は通常、1週間のうち何日/時間帯に営業している
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..*codemon | tue | wed | thu | fri | sat | sun / 月｜火｜水｜木｜金｜土｜日
Binding: DaysOfWeek (required): The days of the week.


.... 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 Documentation for this format

Terminology Bindings

PathConformanceValueSet
Location.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Location.statusrequiredLocationStatus
Location.operationalStatuspreferredHl7VSBedStatus
Location.moderequiredLocationMode
Location.typeextensibleServiceDeliveryLocationRoleType
Location.physicalTypeexampleLocationType
Location.hoursOfOperation.daysOfWeekrequiredDaysOfWeek

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron

必須要素

本プロファイルで定義された必須項目はない。

Extensions定義

本プロファイルで追加定義された拡張はない。

利用方法

OperationおよびSearch Parameter 一覧

Search Parameter一覧

コンフォーマンス パラメータ 型 例
SHALL name string GET [base]/Location?name=３南
SHALL identifier token GET [base]/Location?identifier=http://myhospital.com/fhir/Locationid|1234
SHOULD address string GET [base]/Location?address=東京都文京区本郷７丁目３−１
SHOULD address-city string GET [base]/Location?address-city=文京区
SHOULD address-state string GET [base]/Location?address-state=東京都
SHOULD address-postalcode string GET [base]/Location?address-postalcode=1130033
必須検索パラメータ

次の検索パラメータは必須でサポートされなければならない。

  1. name 検索パラメータを使用して、任意の名前パートによる文字列検索をサポートしなければならない（SHALL）

    GET [base]/Location?name=[string]

    例：

    GET [base]/Location?name=３南

    名前が一致するLocationリソースを含むBundleを取得する。

  2. identifier 検索パラメータを使用して、ロケーションIDなどの識別子によるLocationの検索をサポートしなければならない（SHALL）

    GET [base]/Location?identifier={system|}[code]

    例：

    GET [base]/Location?identifier=http://myhospital.com/fhir/Locationid|1234

    指定された識別子に一致するLocationリソースを含むBundleを取得する。

  3. address 検索パラメータを使用して、住所テキストによる文字列検索をサポートしなければならない（SHALL）

    GET [base]/Location?address=[string]

    例：

    GET [base]/Location?address=東京都文京区本郷７丁目３−１

    住所文字列が一致するLocationリソースを含むBundleを取得する。

  4. address-city 検索パラメータを使用して、住所の市町村名によるLocationの検索をサポートすることが望ましい（SHOULD）

    GET [base]/Location?address-city=[string]

    例：

    GET [base]/Location?address-city=文京区

    指定された住所の市町村名が一致するLocationリソースを含むBundleを取得する。

  5. address-state 検索パラメータを使用して、住所の都道府県名によるLocationの検索をサポートすることが望ましい（SHOULD）

    GET [base]/Location?address-state=[string]

    例：

    GET [base]/Location?address-state=東京都

    指定された住所の都道府県名が一致するLocationリソースを含むBundleを取得する。

  6. address-postalcode 検索パラメータを使用して、住所の郵便番号によるLocationの検索をサポートすることが望ましい（SHOULD）

    GET [base]/Location?address-postalcode=[string]

    例：

    GET [base]/Location?address-postalcode=1130033

    指定された住所の郵便番号が一致するLocationリソースを含むBundleを取得する。

追加検索パラメータ

追加検索パラメータは定義しない。

サンプル

その他、参考文献・リンク等

  1. 退院時サマリー規約 http://www.hl7.jp/library/item/HL7J-CDA-007.pdf
  2. 診療情報提供書規格 http://www.hl7.jp/intro/std/HL7J-CDA-005.pdf
  3. 特定健診情報ファイル仕様 https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/0000165280.html
  4. SS-MIX2 標準化ストレージ 仕様書 Ver.1.2h https://www.jami.jp/jamistd/docs/SS-MIX2/h/SS-MIX2_StndrdStrgSpecVer.1.2h.pdf
  5. ICSR E2B(R3) https://www.pmda.go.jp/int-activities/int-harmony/ich/0093.html