MedicalInstitution draft subclass

One hospital or clinic: one row of the list a municipality publishes as 自治体標準オープンデータセット dataset 10 (医療機関一覧). A subtype of Facility that adds the kind of institution, the medical institution code, clinical departments, number of beds, its role in disaster medical care (災害拠点分類) and after-hours care. Consultation days and hours go into openingHoursSpecification.

Kind	entity
Subclass of	A subclass of Facility. Attributes with the same name carry the parent's IRIs and the parent's required attributes stay required, so code that reads the parent's attributes reads this type too. The type itself differs: a client that selects by the parent type finds this one only by following rdfs:subClassOf in the vocabulary.
Type IRI	https://datamodels.jp/ns/facility/MedicalInstitution
@context	https://datamodels.jp/context/facility/v1.jsonld
JSON Schema	/schema/facility/MedicalInstitution/v1.json
Licence	CC0 1.0: the files (@context, JSON Schema, examples) can be used without conditions

These @context and JSON Schema URLs always point to the latest compatible version.
For URLs that never change, see Versions. More in URLs and versions.

Types and relationships

used as a value typesubclassother subjectN more links: continued on that type's page

Attributes

Attribute	Description	Value
name*	Name of the facility https://uri.etsi.org/ngsi-ld/name	Property, string
nameKana	Name in full-width katakana https://datamodels.jp/ns/disaster/nameKana	Property, string
nameEn	Name in English https://datamodels.jp/ns/disaster/nameEn	Property, string
externalFacilityId*	The facility's ID in the municipality's list (unique within the municipality and the dataset). Together with localGovernmentCode it is unique nationwide https://datamodels.jp/ns/facility/externalFacilityId	Property, string
localGovernmentCode*	Local government code (6 digits including the check digit) of the municipality that publishes the list https://datamodels.jp/ns/common/localGovernmentCode	Property, string
address	Address of the facility (JapaneseAddress). Its localGovernmentCode is that of the municipality the facility lies in, which can differ from the publisher https://schema.org/address	Property, object: JapaneseAddress
location	Location (a point) https://uri.etsi.org/ngsi-ld/location	GeoProperty (Geometry, Point)
operatorName	Name of the organisation that runs the facility or, for equipment such as an AED, installed it (団体名, 法人の名称 in the datasets) https://datamodels.jp/ns/facility/operatorName	Property, string
corporateNumber	Corporate number (13 digits, National Tax Agency) of the organisation that runs the facility or installed the equipment https://datamodels.jp/ns/facility/corporateNumber	Property, string
contactPoint	How to get in touch (ContactPoint): telephone, extension, fax, e-mail, web form, other channels, postal code https://schema.org/contactPoint	Property, object: ContactPoint
openingHoursSpecification	When the facility can be used (OpeningHours): weekdays, opening and closing time, remarks https://schema.org/openingHoursSpecification	Property, object: OpeningHours
url	Web page about the facility https://schema.org/url	Property, string (uri)
remarks	Remarks https://datamodels.jp/ns/facility/remarks	Property, string
medicalInstitutionType	Kind of medical institution: hospital (20 beds or more), clinicWithBeds (1 to 19 beds), clinicWithoutBeds (no beds) https://datamodels.jp/ns/facility/medicalInstitutionType	Property, string: hospital | clinicWithBeds | clinicWithoutBeds
medicalInstitutionCode	Medical institution code, as the dataset gives it (the example in the definition sheet has 10 digits) https://datamodels.jp/ns/facility/medicalInstitutionCode	Property, string
medicalDepartments	Clinical departments, as written by the publisher, for example 内科 or 整形外科 https://datamodels.jp/ns/facility/medicalDepartments	Property, array
numberOfBeds	Number of beds https://datamodels.jp/ns/facility/numberOfBeds	Property, integer, ≥ 0
disasterBaseClass	The institution's role in disaster medical care: core (core disaster base hospital), regional (regional disaster base hospital), firstAidStation (first-aid station) https://datamodels.jp/ns/facility/disasterBaseClass	Property, string: core | regional | firstAidStation
afterHoursCare	What the institution does outside its consultation hours, in words https://datamodels.jp/ns/facility/afterHoursCare	Property, string

* required

Using this model

• How to validate data and send it to a broker: Using the models.

• To add attributes of your own to this model, the extension builder writes the @context and JSON Schema.

• Extended this model? If you publish it on a site made with the toolkit, it shows on this page once your site is on the list of sites. Without a site, list your extension so others can reuse your names (how to fill in the form).

• Files that particular brokers and tools can load as they are, made from this model: Adapters

• The Link header, for sending data without @context in the body:

  Link: <https://datamodels.jp/context/facility/v1.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"

Example

The examples are a fictional scenario (heavy rain in Chiyoda, Tokyo). Place names and codes are real; the events, people and teams are invented. See writing examples.

{
  "id": "urn:ngsi-ld:MedicalInstitution:131016-131016M00001",
  "type": "MedicalInstitution",
  "name": "三井記念病院",
  "nameKana": "ミツイキネンビョウイン",
  "externalFacilityId": "131016M00001",
  "localGovernmentCode": "131016",
  "address": {
    "addressCountry": "JP",
    "addressRegion": "東京都",
    "addressLocality": "千代田区",
    "machiaza": "神田和泉町",
    "banchi": "1",
    "localGovernmentCode": "131016",
    "addressText": "東京都千代田区神田和泉町1番地"
  },
  "location": {
    "type": "Point",
    "coordinates": [
      139.77597,
      35.699192
    ]
  },
  "operatorName": "社会福祉法人三井記念病院",
  "corporateNumber": "6010005001053",
  "contactPoint": {
    "telephone": "03-3862-9111",
    "postalCode": "101-8643"
  },
  "medicalInstitutionType": "hospital",
  "medicalDepartments": [
    "内科",
    "循環器内科",
    "外科",
    "麻酔科"
  ],
  "numberOfBeds": 482,
  "disasterBaseClass": "regional"
}

{
  "@context": [
    "https://datamodels.jp/context/facility/v1.jsonld",
    "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context-v1.8.jsonld"
  ],
  "id": "urn:ngsi-ld:MedicalInstitution:131016-131016M00001",
  "type": "MedicalInstitution",
  "name": {
    "type": "Property",
    "value": "三井記念病院"
  },
  "nameKana": {
    "type": "Property",
    "value": "ミツイキネンビョウイン"
  },
  "externalFacilityId": {
    "type": "Property",
    "value": "131016M00001"
  },
  "localGovernmentCode": {
    "type": "Property",
    "value": "131016"
  },
  "address": {
    "type": "Property",
    "value": {
      "addressCountry": "JP",
      "addressRegion": "東京都",
      "addressLocality": "千代田区",
      "machiaza": "神田和泉町",
      "banchi": "1",
      "localGovernmentCode": "131016",
      "addressText": "東京都千代田区神田和泉町1番地"
    }
  },
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        139.77597,
        35.699192
      ]
    }
  },
  "operatorName": {
    "type": "Property",
    "value": "社会福祉法人三井記念病院"
  },
  "corporateNumber": {
    "type": "Property",
    "value": "6010005001053"
  },
  "contactPoint": {
    "type": "Property",
    "value": {
      "telephone": "03-3862-9111",
      "postalCode": "101-8643"
    }
  },
  "medicalInstitutionType": {
    "type": "Property",
    "value": "hospital"
  },
  "medicalDepartments": {
    "type": "Property",
    "value": [
      "内科",
      "循環器内科",
      "外科",
      "麻酔科"
    ]
  },
  "numberOfBeds": {
    "type": "Property",
    "value": 482
  },
  "disasterBaseClass": {
    "type": "Property",
    "value": "regional"
  }
}

Files: example.json · example-normalized.jsonld · Open in the JSON-LD Playground: see the full IRI behind every attribute (expanded form).

Something missing or wrong?

Open an issue, or propose new attributes or models with the proposal form. How it works: Contributing. The source files (notes, mapping tables) are on GitHub.

Referenced standards

The standards this model corresponds to, field by field. Open one to see its table.

Municipal standard open dataset, data item definition sheet A (2026-08-01), sheet '10. medical institutions' (Digital Agency)19 of 19 fields

The list this model represents; a medical institution is a hospital or a clinic. Columns are given as the Japanese name (English item name). The address, location, contact and consultation-hours columns map as in the JapaneseAddress, Geometry, ContactPoint and OpeningHours tables. Columns left out: 地方公共団体名, 高度の種別 and 高度の値, 状況 (status: no definition or value list, and the name of an NGSI-LD core term), 画像 with its licence.

This model	Maps to	Note
localGovernmentCode	全国地方公共団体コード (localGovernmentCode)	the publishing municipality; the municipality the facility lies in is address.localGovernmentCode (所在地_全国地方公共団体コード)
externalFacilityId	ID (identifier)	the entity id is made from this ID (convert.id); the definition sheet makes it unique within the municipality's list. A list that has one ID on several rows (for example 1.31E+11, rounded by a spreadsheet) is converted after its IDs are fixed, not by numbering rows
name	名称 (name)
nameKana	名称_カナ (nameKana)
nameEn	名称_英字 (nameEn)
medicalInstitutionType	医療機関の種類 (medicalType)	病院 → hospital, 有床診療所 → clinicWithBeds, 無床診療所 → clinicWithoutBeds; the converter has no transform for this yet
address	所在地_* (fullAddress, prefecture, city, streetAddress, cityBlock), 建物名等(方書) (buildingNameEtc), 町字ID (streetAddressId)	see the JapaneseAddress table
location	緯度 (latitude), 経度 (longitude)	a point [longitude, latitude]
operatorName	法人の名称 (legalEntityName)
corporateNumber	法人番号 (legalEntityNumber)
medicalInstitutionCode	医療機関コード (medicalCode)
contactPoint	電話番号 (contactPointPhoneNumber) … 郵便番号 (contactPointPostalCode)	FAX番号 included; see the ContactPoint table
openingHoursSpecification	診療曜日 (serviceDay), 診療開始時間 (startTime), 診療終了時間 (endTime), 診療日時特記事項 (dateTimeRemarks)	see the OpeningHours table jichitai-opendata-medical-hours
afterHoursCare	時間外における対応 (afterHoursCare)
medicalDepartments	診療科目 (medicalSpecialities)	split at ';'
numberOfBeds	病床数 (numberOfBeds)
disasterBaseClass	災害拠点分類 (disasterClassification)	基幹災害医療センター → core, 地域災害医療センター → regional, 救護所 → firstAidStation. The definition sheet's value list and example write 期間災害医療センター, read as a typo for 基幹. The converter has no transform for this yet
url	URL (url)
remarks	備考 (remarks)

Mapping file (YAML) for converting data from this standard: jichitai-opendata-medical.yaml (see Mapping files)

Licence of this standard: Public Data License (Version 1.0) (PDL1.0), compatible with CC BY 4.0

Notes

• Built on the Digital Agency's 自治体標準オープンデータセット, data item definition sheet A (2026-08-01, checked 2026-10-11), sheet 10 医療機関一覧 (https://www.digital.go.jp/resources/open_data/municipal-standard-data-set-test). Field by field in mapping/jichitai-opendata-medical.yaml.
• A subtype (x-subclass-of) of Facility that adds the columns of this dataset only: kind of institution, medical institution code, clinical departments, number of beds, disaster base class and after-hours care. Consultation days and hours go into openingHoursSpecification, the fax number into contactPoint.
• The kind of institution and the disaster base class take values after the definition sheet's value lists (病院 → hospital and so on). The disaster base class list and example write 期間災害医療センター, read as a typo for 基幹 (core); the current national terms are 基幹災害拠点病院 and 地域災害拠点病院. The 状況 (status) column is left out: it has no definition or value list, and its name is an NGSI-LD core term.
• Upstream considered (2026-10-11): schema.org MedicalOrganization, Hospital and MedicalClinic are close in meaning and have medicalSpecialty, but its values are members of the schema.org MedicalSpecialty enumeration, which do not match Japanese department names; changing an upstream term's type is not allowed, so departments are medicalDepartments, an array of strings. The number of beds is minted too: schema.org numberOfBeds counts beds in a hotel room. Smart Data Models has no hospital type.
• The example (三井記念病院) comes from published sources, all checked 2026-10-11: the number of beds and the disaster base status from the Tokyo Metropolitan Government's 東京都災害拠点病院一覧 (as of 2024-08-01); the corporation's name, kana and corporate number from the National Tax Agency's corporate number site; the postal code, telephone and departments from the hospital's website; the coordinates from GSI's address search (神田和泉町 1番地). The ID is invented. Chiyoda City does not publish a medical institution list on the Tokyo open data catalog (checked 2026-10-11).
• Real data seen (Chuo City's 医療機関一覧, checked 2026-10-11, 1331 rows): the kind of institution is written as 一般診療所, 歯科診療所 and 企業内診療所, none of which is in the definition sheet's list; four rows have 有り (yes) as the number of beds, and the converter rejects them; the disaster base class, consultation days and hours are empty. The value list stays as it is (decided 2026-10-11); it is revisited if a second municipality also uses kinds that the definition sheet does not list.