日本語
ContactPoint ドラフト 値型
連絡先
施設や組織への連絡の方法です。contactPoint 属性の値として使います。電話番号、内線番号、FAX 番号、メールアドレス、問い合わせフォームの URL、そのほかの連絡手段、郵便番号を持ちます。項目は、自治体標準オープンデータセットの連絡先の列と、GIF のコアデータモデル「連絡先」に合わせています。意味が同じ項目には、schema.org の ContactPoint の語を使います。どの項目も任意です。
| 種類 | 値型:属性の値の中で使い、単独のエンティティにはならない |
| IRI | https://datamodels.jp/ns/common/ContactPoint |
| @context | https://datamodels.jp/context/common/v1.jsonld |
| JSON Schema | /schema/common/ContactPoint/v1.json |
| ライセンス | CC0 1.0:ファイル(@context、JSON Schema、例)は条件なしで使えます |
この @context と JSON Schema の URL は、常に互換性のある最新版を指します。
内容が変わらない URL はバージョンにあります。詳しくはURL とバージョンを見てください。
型と関係
値型として使う他のサブジェクトほか N 件: その型のページに続きがある
フィールド
| フィールド | 説明 | 値 |
|---|---|---|
telephone | 電話番号。公開者が書いたとおりの表記です(例:03-3264-2111)。複数あるときは「 / 」で区切ります。https://schema.org/telephone | string |
telephoneExtension | 内線番号https://datamodels.jp/ns/common/telephoneExtension | string |
faxNumber | FAX 番号https://schema.org/faxNumber | string |
email | メールアドレスhttps://schema.org/email | string |
url | 連絡に使うウェブページや問い合わせフォームの URLhttps://schema.org/url | string |
otherChannels | SNS のアカウントなど、そのほかの連絡手段と、連絡先についての備考(自由記述)https://datamodels.jp/ns/common/otherChannels | string |
postalCode | 連絡先の郵便番号(7 桁。ハイフンの有無は問いません)。施設の所在地の郵便番号と違うことがあります。https://schema.org/postalCode | string, pattern ^\d{3}-?\d{4}$ |
このモデルを使う
他のモデルは、属性の値としてこの値型を参照します。書き方はモデルのルールにあります。
例
例は架空のシナリオ(東京都千代田区の大雨対応)です。地名とコードは実在のものですが、出来事・人・チームは架空です。書き方は例の書き方にあります。
json
{
"telephone": "03-3264-2111",
"otherChannels": "千代田区コールセンター 03-3264-3910(年中無休、8:00〜21:00)",
"postalCode": "102-8688"
}ファイル: example.json
改善の提案
属性が足りない、説明がおかしいと思ったら、Issue で知らせてください。新しい属性やモデルは提案フォームから提案できます。進め方は貢献するにあります。 ソースファイル(注記、対応表)は GitHub にあります。
参照している標準
このモデルが対応している標準と、項目ごとの対応です。開くと対応表が見られます。
デジタル庁 GIF コアデータモデル「連絡先」
GIF の連絡先は、名称、用途、電話番号(複数可、内線を含む)、メールアドレス(複数可)、URL、SNS(複数可)、住所、備考を持つ。GIF のコアデータモデル「施設」は、これを連絡先情報(contactPointInformation)として持つ。
| このモデル | 対応先 | 備考 |
|---|---|---|
telephone | 連絡先電話番号 (contactPointPhoneNumber) | |
telephoneExtension | 連絡先電話番号 (contactPointPhoneNumber) | GIF は内線番号も電話番号に含める |
faxNumber | 対応なし | GIF の連絡先には無い。データセットの FAX番号(contactPointFaxNumber)にあたる |
email | 連絡先メールアドレス (contactPointEmailAddress) | |
url | 連絡先URL (contactPointUrl) | |
otherChannels | 連絡先SNS (contactPointSocialMedia), 連絡先備考 (contactPointRemark) | GIF は SNS(「サービス名: ID」)と備考を分ける。ここでは 1 つの文章にまとめる |
postalCode | 連絡先住所 (contactPointAddress) | GIF の住所(JapaneseAddress の対応表 gif-address)の郵便番号 |
この標準のデータを変換するための対応表(YAML): gif-contact-point.yaml(説明は対応表)
この標準のライセンス: スキーマは CC BY 4.0、リポジトリは CC0 1.0
自治体標準オープンデータセット・データ項目定義書A(20260801版)の連絡先の項目(デジタル庁)
定義書Aのうち、01 公共施設、05 子育て施設、08 AED、09 介護サービス事業所、10 医療機関が、この名前の連絡先の列を持つ(FAX番号は 05、09、10 だけ)。11 観光施設は「連絡先電話番号」「連絡先内線番号」と名前が違う。13 公衆トイレには連絡先が無い。項目名は日本語名(英語名)で示す。
| このモデル | 対応先 | 備考 |
|---|---|---|
telephone | 電話番号 (contactPointPhoneNumber) | GIF の電話番号の表記。複数あるときは「 / 」で区切る |
telephoneExtension | 内線番号 (contactPointExtension) | |
faxNumber | FAX番号 (contactPointFaxNumber) | 05、09、10 だけ |
email | 連絡先メールアドレス (contactPointEmailAddress) | |
url | 連絡先FormURL (contactPointFormUrl) | |
otherChannels | 連絡先備考(その他、SNSなど) (contactPointRemarks) | |
postalCode | 郵便番号 (contactPointPostalCode) | 定義上は連絡先の郵便番号。データセットの記入例はハイフンなし(1234567)で、どちらの形も受け付ける |
この標準のデータを変換するための対応表(YAML): jichitai-opendata-contact.yaml(説明は対応表)
この標準のライセンス: 公共データ利用規約(第1.0版)(PDL1.0、CC BY 4.0 と互換)
注記
- エンティティの型ではなく、値型です。
contactPointProperty(IRI https://schema.org/contactPoint )の値として使い、エンティティのスキーマから $ref でこのスキーマを参照します。 - デジタル庁の自治体標準オープンデータセット、データ項目定義書 A(2026-08-01、2026-10-11 に確認)の連絡先の列(電話番号、内線番号、FAX番号、連絡先メールアドレス、連絡先FormURL、連絡先備考(その他、SNSなど)、郵便番号)に基づいています。これらの列は 01 公共施設、05 子育て施設、08 AED、09 介護サービス事業所、10 医療機関、11 観光施設にあります(FAX番号は 05、09、10 だけ)。11 観光施設は、同じ列を「連絡先電話番号」「連絡先内線番号」という名前で持ち、「連絡先名称」も持ちます。対応は mapping/jichitai-opendata-contact.yaml にあります。
- GIF のコアデータモデル「連絡先」(438_コアデータモデル_DMD.xlsx、2026-10-11 に確認)にも対応します。GIF は連絡先名称、用途、住所を持ち、FAX 番号と内線番号を電話番号に含めます。対応は mapping/gif-contact-point.yaml にあります。
- 検討した上流(2026-10-11):schema.org の ContactPoint の語は、意味が合うものを再利用しています(telephone、faxNumber、email、url、postalCode)。型そのものは、カタログの値型として定めています。JapaneseAddress と同じく、カタログの値型には自分のスキーマとページが要るからです。Smart Data Models の PointOfInterest の contactPoint も、schema.org の ContactPoint と同じ形です。内線番号と、SNS などのそのほかの連絡手段にあたる語は schema.org に無いので、common の名前空間で定めました(telephoneExtension、otherChannels)。
- 入れていないもの:連絡先の名称(11 観光施設の「連絡先名称」、GIF の連絡先名称)、GIF の用途と住所。最初のモデル(AEDLocation、PublicToilet、MedicalInstitution)のデータセットに無いからです。必要になったら追加します。