Facility draft

One facility that a municipality lists in its open data. It has what the facility datasets of the 自治体標準オープンデータセット share: name, address, location, the publishing municipality, the operator, contact and opening hours. It corresponds to GIF's core data model 施設 (facility). Subtypes per kind of facility, such as AEDs and public toilets, add the columns of their own dataset.


Kind	entity
Type IRI	`https://datamodels.jp/ns/facility/Facility`
@context	`https://datamodels.jp/context/facility/v1.jsonld`
JSON Schema	`/schema/facility/Facility/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

* 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:

http

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.

json

{
  "id": "urn:ngsi-ld:Facility:131016-131016F00001",
  "type": "Facility",
  "name": "千代田区役所",
  "nameKana": "チヨダクヤクショ",
  "externalFacilityId": "131016F00001",
  "localGovernmentCode": "131016",
  "address": {
    "addressCountry": "JP",
    "postalCode": "102-8688",
    "addressRegion": "東京都",
    "addressLocality": "千代田区",
    "machiaza": "九段南",
    "chome": "1",
    "banchi": "2",
    "go": "1",
    "residentialIndication": true,
    "localGovernmentCode": "131016",
    "abrMachiazaId": "0008001",
    "addressText": "東京都千代田区九段南1丁目2番1号"
  },
  "location": {
    "type": "Point",
    "coordinates": [
      139.75354,
      35.693947
    ]
  },
  "operatorName": "千代田区",
  "corporateNumber": "8000020131016",
  "contactPoint": {
    "telephone": "03-3264-2111",
    "otherChannels": "千代田区コールセンター 03-3264-3910（年中無休、8:00〜21:00）",
    "postalCode": "102-8688"
  },
  "openingHoursSpecification": {
    "dayOfWeek": [
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday"
    ],
    "opens": "08:30",
    "closes": "17:00",
    "description": "祝日・年末年始（12月29日〜1月3日）を除く。一部の窓口は開庁時間が異なる。"
  },
  "url": "https://www.city.chiyoda.lg.jp/"
}

json

{
  "@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:Facility:131016-131016F00001",
  "type": "Facility",
  "name": {
    "type": "Property",
    "value": "千代田区役所"
  },
  "nameKana": {
    "type": "Property",
    "value": "チヨダクヤクショ"
  },
  "externalFacilityId": {
    "type": "Property",
    "value": "131016F00001"
  },
  "localGovernmentCode": {
    "type": "Property",
    "value": "131016"
  },
  "address": {
    "type": "Property",
    "value": {
      "addressCountry": "JP",
      "postalCode": "102-8688",
      "addressRegion": "東京都",
      "addressLocality": "千代田区",
      "machiaza": "九段南",
      "chome": "1",
      "banchi": "2",
      "go": "1",
      "residentialIndication": true,
      "localGovernmentCode": "131016",
      "abrMachiazaId": "0008001",
      "addressText": "東京都千代田区九段南1丁目2番1号"
    }
  },
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        139.75354,
        35.693947
      ]
    }
  },
  "operatorName": {
    "type": "Property",
    "value": "千代田区"
  },
  "corporateNumber": {
    "type": "Property",
    "value": "8000020131016"
  },
  "contactPoint": {
    "type": "Property",
    "value": {
      "telephone": "03-3264-2111",
      "otherChannels": "千代田区コールセンター 03-3264-3910（年中無休、8:00〜21:00）",
      "postalCode": "102-8688"
    }
  },
  "openingHoursSpecification": {
    "type": "Property",
    "value": {
      "dayOfWeek": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "opens": "08:30",
      "closes": "17:00",
      "description": "祝日・年末年始（12月29日〜1月3日）を除く。一部の窓口は開庁時間が異なる。"
    }
  },
  "url": {
    "type": "Property",
    "value": "https://www.city.chiyoda.lg.jp/"
  }
}

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.

Digital Agency GIF core data model "Facility"8 of 13 fields

GIF's facility has basic items (ID, type information, the name with kana and English, an alternate name, a description, the facility address, access, parking, contact information) and extended items for implementation models (hours, fees, capacity, accessibility and more). The facility datasets of the 自治体標準オープンデータセット reference it column by column.

This model	Maps to	Note
`externalFacilityId`	`ID (id)`	in GIF an ID that identifies the facility; in the datasets an ID unique within the municipality, used together with the local government code
`name`	`名称 (name)`
`nameKana`	`名称(カナ) (nameKana)`	required in GIF
`nameEn`	`名称(英字) (nameEn)`
`address`	`施設住所 (facilityAddress)`	GIF's address; see JapaneseAddress's gif-address table
`location`	`施設住所 > 代表点の緯度、代表点の経度 (latitudeOfRepresentativePoint, longitudeOfRepresentativePoint)`	extended items of GIF's address; the 緯度 and 経度 columns in the datasets
`contactPoint`	`連絡先情報 (contactPointInformation)`	GIF's contact point; see ContactPoint's gif-contact-point table
`openingHoursSpecification`	`利用可能曜日、開始時刻、終了時刻、利用可能日時説明 (availableDay, startTime, endTime, availabileDateTimeDescription)`	extended items; see OpeningHours's gif-facility-hours table
`localGovernmentCode`	no counterpart	not in GIF's facility; in the datasets the code of the publishing government
`operatorName`	no counterpart	GIF's facility has no operator item; it is the 商号または名称 (tradeName) of GIF's core data model 法人 (corporation)
`corporateNumber`	no counterpart	the 法人番号 (legalEntityNumber) of GIF's core data model 法人 (corporation)
`url`	no counterpart	not among GIF's basic facility items; the URL column in the datasets
`remarks`	no counterpart	not in GIF's facility; the 備考 column in the datasets

Mapping file (YAML) for converting data from this standard: gif-facility.yaml (see Mapping files)

Licence of this standard: CC BY 4.0 (schema), CC0 1.0 (repository)

Notes

Built on the columns that the eight facility datasets of the Digital Agency's 自治体標準オープンデータセット share (data item definition sheet A, 2026-08-01, checked 2026-10-11, https://www.digital.go.jp/resources/open_data/municipal-standard-data-set-test: 01 public facilities, 05 childcare facilities, 08 AEDs, 09 care service providers, 10 medical institutions, 11 tourist facilities, 13 public toilets, 14 fire water supplies), and on GIF's core data model 施設 (438_コアデータモデル_DMD.xlsx, checked 2026-10-11), which the datasets reference column by column. The GIF correspondence is in mapping/gif-facility.yaml.
Added on 2026-10-11 as proposed in #104; the maintainer (@dkastl) took the issue's suggestions as decisions, without a group discussion: a new subject facility; first scope Facility, the common value types ContactPoint and OpeningHours, and the subtypes AEDLocation, PublicToilet and MedicalInstitution; one subtype (x-subclass-of) per dataset; English names.
Only id and type are required. Dataset 14 (fire water supplies) has no name column, and dataset 11 (tourist facilities) gives a corporate number instead of the local government code when a company publishes it. A subtype keeps its parent's required attributes, so requiring more here would rule out subtypes for these datasets. AEDLocation, PublicToilet and MedicalInstitution require name, localGovernmentCode and externalFacilityId, as EvacuationSite does.
The accessibility columns that datasets 01 (public facilities) and 11 (tourist facilities) share (wheelchair access and rental, ramps, braille, guide dogs, subtitles, written communication, priority parking, ostomate toilet, nursing room and more) are not in the base: only two of the eight datasets have them, none of the first subtypes uses them, and GIF too keeps them in a separate core data model, アクセシビリティ (accessibility), as an extended item of the facility. They come as a value type with PublicFacility or TouristFacility; adding an attribute to the base is backward compatible.
Upstream considered (2026-10-11): Smart Data Models PointOfInterest (dataModel.PointOfInterest) gives the kind of place as codes of an international classification (category) and the address as a schema.org PostalAddress; it cannot carry Japanese addresses or the per-dataset columns, so its type is not used. schema.org Place, CivicStructure, PublicToilet, MedicalOrganization and Hospital are close in meaning, but a catalog type needs its own schema, so the types are minted; schema.org terms are used for the attributes contactPoint, openingHoursSpecification and url.
Names and IRIs: name, nameKana and nameEn share EvacuationSite's IRIs (nameKana and nameEn in the disaster namespace) so that one meaning has one term. Remarks (備考) are remarks in the facility namespace: datasets 01 and 11 have a description column (説明) next to remarks, so the NGSI-LD core description is kept for that (EvacuationSite puts 備考 into description). The ID is externalFacilityId, shaped like EvacuationSite's externalSiteId; schema.org identifier was not used because it can be any identifier.
Left out: 地方公共団体名 (follows from the code), 高度の種別 and 高度の値 (a floor, an elevation or a height above ground), pictures and their licences, as for EvacuationSite, until a system needs them.

Facility draft ​

Types and relationships ​

Attributes ​

Using this model ​

Example ​

Referenced standards ​

Notes ​