プレリリース版です。正式公開までは、公開済みのファイルも含めて内容が変わることがあります。
Skip to content

出典: https://datamodels.jp/models/common/JapaneseAddress/ · 文章は CC BY 4.0

JapaneseAddress ドラフト 値型 サブクラス ​

日本の住所

address 属性の値として使う、日本の住所です。意味が同じ項目には、schema.org の PostalAddress の語を使っています。そのうえで、日本固有の構造(町字、丁目、番地、号)、JIS コードと全国地方公共団体コード、アドレス・ベース・レジストリの町字 ID、住居表示かどうかを加えています。どの項目も任意です。構造化できないときは、addressText だけでも構いません。

種類値型:属性の値の中で使い、単独のエンティティにはならない
親の型https://schema.org/PostalAddress のサブクラスです。親はこのカタログの外の型で、この型はそれより狭いか、項目を足しています。意味が合う項目は親の語彙の IRI を使います。関係は語彙に rdfs:subClassOf として書いてあります。
IRIhttps://datamodels.jp/ns/common/JapaneseAddress
@contexthttps://datamodels.jp/context/common/v1.jsonld
JSON Schema/schema/common/JapaneseAddress/v1.json
ライセンスCC0 1.0:ファイル(@context、JSON Schema、例)は条件なしで使えます

この @context と JSON Schema の URL(バージョンの別名)は、常に互換性のある最新版を指します。
内容が変わらない URL はバージョンにあります。詳しくはURL とバージョンを見てください。

型と関係 ​

型と関係の図addressaddressaddressaddressaddressaddressaddressJapaneseAddress日本の住所DesignatedShelter指定避難所ほか 3 件の関係 →EvacuationSite指定緊急避難場所ほか 3 件の関係 →AEDLocationAED の設置場所ほか 4 件の関係 →Facility施設ほか 6 件の関係 →MedicalInstitution医療機関ほか 4 件の関係 →PublicToilet公衆トイレほか 4 件の関係 →RoadRestriction通行規制ほか 1 件の関係 →

値型として使う他の分野ほか N 件: その型のページに続きがある

フィールド ​

フィールド説明値
addressCountry国。常に JP です。
https://schema.org/addressCountry
string = JP
postalCode郵便番号(7 桁。ハイフンの有無は問いません)
https://schema.org/postalCode
string, pattern ^\d{3}-?\d{4}$
addressRegion都道府県名
https://schema.org/addressRegion
string
addressLocality市区町村名。政令指定都市は、市名と区名を含みます(例:横浜市中区)。
https://schema.org/addressLocality
string
machiaza町字(町名、大字、字)。丁目は含めません。
https://datamodels.jp/ns/common/machiaza
string
chome丁目。数字だけで書きます(「一丁目」なら "1")。
https://datamodels.jp/ns/common/chome
string, pattern ^\d+$
banchi番地。住居表示を実施している区域では街区符号、それ以外では枝番を含む地番全体です(例:4638-1)。
https://datamodels.jp/ns/common/banchi
string
go号。住居表示を実施している区域では住居番号です。地番の区域では空にします(枝番は banchi に含めます)。
https://datamodels.jp/ns/common/go
string
buildingName建物名、部屋番号など、号より下の表記
https://datamodels.jp/ns/common/buildingName
string
residentialIndication住居表示を実施している区域なら true(banchi と go は街区符号と住居番号)、地番なら false
https://datamodels.jp/ns/common/residentialIndication
boolean
jisPrefectureCode都道府県コード(JIS X 0401、2 桁)
https://datamodels.jp/ns/common/jisPrefectureCode
string, pattern ^\d{2}$
jisMunicipalityCode市区町村コード(JIS X 0402、都道府県コードを含む 5 桁)
https://datamodels.jp/ns/common/jisMunicipalityCode
string, pattern ^\d{5}$
localGovernmentCode全国地方公共団体コード(JIS X 0402 の 5 桁と検査数字 1 桁)
https://datamodels.jp/ns/common/localGovernmentCode
string, pattern ^\d{6}$
abrMachiazaIdアドレス・ベース・レジストリの町字 ID(7 桁)。全国地方公共団体コードと組み合わせると、町字を一意に識別できます。
https://datamodels.jp/ns/common/abrMachiazaId
string, pattern ^\d{7}$
addressText住所の全文(正規化した 1 行の表記)。構造化した項目がそろわないときの受け皿でもあります。
https://datamodels.jp/ns/common/addressText
string

このモデルを使う ​

他のモデルは、属性の値としてこの値型を参照します。その属性を持つデータを検証すると、この値型のスキーマも読み込まれます(JSON を検証する)。

例 ​

例の多くは架空のシナリオ(東京都千代田区の大雨対応)です。地名とコードは実在のものですが、出来事・人・チームは架空です。公開されている一覧の実際の行を写した例もあり、そのときは注記に出典があります。書き方は例の書き方にあります。

json
{
  "addressCountry": "JP",
  "postalCode": "102-8688",
  "addressRegion": "東京都",
  "addressLocality": "千代田区",
  "machiaza": "九段南",
  "chome": "1",
  "banchi": "2",
  "go": "1",
  "buildingName": "千代田区役所",
  "residentialIndication": true,
  "jisPrefectureCode": "13",
  "jisMunicipalityCode": "13101",
  "localGovernmentCode": "131016",
  "abrMachiazaId": "0008001",
  "addressText": "東京都千代田区九段南1丁目2番1号"
}

ファイル: example.json

改善の提案

属性が足りない、説明がおかしいと思ったら、Issue で知らせてください。新しい属性やモデルは提案フォームから提案できます。進め方は貢献するにあります。 ソースファイル(注記、対応表)は GitHub にあります。

参照している標準 ​

このモデルが対応している標準と、項目ごとの対応です。開くと対応表が見られます。

デジタル庁 アドレス・ベース・レジストリ(町字、地番、住居表示の街区・住居のデータセット)15 項目中 10 項目が対応

列の名前と意味は、上のページで公開されている「データフォーマット(仕様確定版)」(2024-01-15)で 2026-10-30 に確認した(2025 年 6 月版は公開準備中)。使うのはデータセット「03 町字」(mt_town)、「04 地番」(mt_parcel)、「05 住居表示-街区」(mt_rsdtdsp_blk)、「06 住居表示-住居」(mt_rsdtdsp_rsdt)。デジタル庁の abr-geocoder の結果もほぼ同じ名前を使う。ただし、丁目は chome(書き方)だけで chome_number は無く、lg_code と machiaza_id は structured_address ではなく ids の下にある。この表は対応を説明するもので、datamodels convert で変換するためのものではない。

このモデル対応先備考
addressCountry対応なしデータには無い。常に JP
postalCodepost_code町字(mt_town)の列。郵便番号が複数あるとき(セミコロン区切り)は、ほかの情報で 1 つに決まる場合だけその番号を入れ、決まらなければ postalCode は省く
addressRegionpref
addressLocalitycounty + city + ward郡、市区町村、政令市の区をつなげる
machiazaoaza_cho + koaza大字・町と小字をつなげる。丁目は JapaneseAddress の chome に入れる
chomechome_numberchome_number は丁目の数字。レジストリの chome 列は「一丁目」のような書き方
banchiblk_num、prc_num1 + prc_num2 + prc_num3住居表示では街区符号(blk_num)。地番では本番(prc_num1)、支号(prc_num2)、支号の支号(prc_num3)をハイフンでつなげ、空の部分は省く(例:4638-1)。ハイフンでつなげるのはこのカタログの決まり。レジストリでは、例外的に数字以外を含むことがある。
gorsdt_num + rsdt_num2住居番号(rsdt_num)。住居番号が 2 つの番号でできているとき(団地・中高層建物の特例や枝番)は、後の番号(rsdt_num2)をハイフンでつなげる(このカタログの決まり)。地番では空。
residentialIndicationrsdt_addr_flg1(住居表示実施)→true、0(住居表示非実施)→false。フラグは町字ごとで、住居表示の区域とそうでない区域が同じ町字にあるときは、その町字に 2 つのレコードがある。住所が当てはまる方のレコードの値を使う。
localGovernmentCodelg_code
jisPrefectureCode対応なしlg_code の先頭 2 桁
jisMunicipalityCode対応なしlg_code の先頭 5 桁
abrMachiazaIdmachiaza_id
buildingName対応なしレジストリには無い
addressText対応なしレジストリには無い。各項目をつなげて作る

この標準のデータを変換するための対応表(YAML): abr.yaml(説明は対応表)

この標準のライセンス: 公共データ利用規約(第1.0版)(PDL1.0)。地番のデータ(地番マスター)には、登記所備付地図データ利用規約も適用される(上のページからリンクした「データの利用規約」を参照)。

デジタル庁 GIF コアデータモデル「住所」15 項目中 12 項目が対応

GIF の住所は町字(streetAddress)に丁目を含め、番地以下を cityBlock ひとつにまとめる。JapaneseAddress は丁目・番地・号を分けて持つため、GIF へ変換するときは連結する。

このモデル対応先備考
addressCountrycountryGIF は国コードリスト(CountryRegionCodeList)。JP に対応
postalCodepostalCode
addressRegionprefecture
addressLocalitycityAndCounty郡名・政令市の区名を含む点は同じ
machiazastreetAddressGIF の町字は丁目を含む。machiaza + chome に対応
chomestreetAddress上記のとおり町字に含まれる
banchicityBlockGIF は番地以下(街区符号・住居番号または地番)をひとつの項目にまとめる。banchi + go に対応
gocityBlock
buildingNamebuildingNameEtc
addressTextfullAddress
localGovernmentCodelocalGovernmentCode
abrMachiazaIdstreetAddressIdどちらもアドレス・ベース・レジストリの町字ID
jisPrefectureCode対応なしGIF には無い。localGovernmentCode の先頭2桁から導ける
jisMunicipalityCode対応なしGIF には無い。localGovernmentCode の先頭5桁から導ける
residentialIndication対応なしGIF には無い

この標準との対応表(YAML): gif-address.yaml(説明は対応表)

この標準のライセンス: スキーマは CC BY 4.0、リポジトリは CC0 1.0

国土地理院「指定緊急避難場所データ」「指定避難所データ」の住所3 項目中 1 項目が対応

住所は 1 列の連結表記だけ。構造化した項目は無い。

このモデル対応先備考
addressCountry対応なしデータには無い。常に JP
addressText住所
localGovernmentCode対応なしデータには無い。ファイル名の市町村コードから導ける

この標準のデータを変換するための対応表(YAML): gsi-address.yaml(説明は対応表)

この標準のライセンス: 国土地理院コンテンツ利用規約と、同サイトの「ご利用上の注意」

自治体標準オープンデータセット・データ項目定義書A(20260801版)の所在地の項目(デジタル庁)15 項目中 11 項目が対応

定義書Aのうち、01 公共施設、02 文化財、03 指定緊急避難場所、05 子育て施設、07 公衆無線LAN、08 AED、09 介護サービス事業所、10 医療機関、11 観光施設、12 イベント、13 公衆トイレ、14 消防水利施設の 12 のデータセットが同じ所在地の項目を持つ(15 食品等営業許可は連結表記・所在地の全国地方公共団体コード・町字ID のみ)。項目名は日本語名(英語名)で示す。項目番号はデータセットごとに異なる。

このモデル対応先備考
addressCountry対応なしデータセットには無い。常に JP
postalCode郵便番号 (contactPointPostalCode)定義上は連絡先の郵便番号で、所在地と異なることがある。そのため変換では postalCode に入れない。12 イベント、13 公衆トイレ、14 消防水利施設には無い
addressRegion所在地_都道府県 (prefecture)
addressLocality所在地_市区町村 (city)郡名・政令市の区名を含む点は同じ
machiaza所在地_町字 (streetAddress)データセットの町字は丁目を含む(例 青葉町一丁目)。machiaza + chome に対応
chome所在地_町字 (streetAddress)上記のとおり町字に含まれる。漢数字は算用数字にする(一丁目 → 1)
banchi所在地_番地以下 (cityBlock)番地以下をひとつの項目にまとめる(例 ○-○)。banchi + go に対応
go所在地_番地以下 (cityBlock)
buildingName建物名等(方書) (buildingNameEtc)
addressText所在地_連結表記 (fullAddress)都道府県から建物名等までを連結した表記。データセットでは必須の項目なので、構造化した項目が空でもこれは入る
localGovernmentCode所在地_全国地方公共団体コード (locatedLocalGovernmentCode)先頭の「全国地方公共団体コード」(localGovernmentCode)はデータを公開する団体のコードで、所在地が管轄外にあると異なる。住所には所在地のほうを使う
abrMachiazaId町字ID (streetAddressId)どちらもアドレス・ベース・レジストリの町字ID。記入例は 0008-001 のようにハイフンを含むので、取り除いて 7 桁にする
jisPrefectureCode対応なしデータセットには無い。localGovernmentCode の先頭2桁から導ける
jisMunicipalityCode対応なしデータセットには無い。localGovernmentCode の先頭5桁
residentialIndication対応なしデータセットには無い

この標準のデータを変換するための対応表(YAML): jichitai-opendata-address.yaml(説明は対応表)

この標準のライセンス: 公共データ利用規約(第1.0版)(PDL1.0、CC BY 4.0 と互換)

注記 ​

  • エンティティの型ではなく、値型です。address Property(IRI https://schema.org/address)の値として使い、エンティティのスキーマから $ref でこのスキーマを参照します。
  • 日本の住所の公式なモデルは、デジタル庁の GIF コアデータモデルの「住所」です。JapaneseAddress は同じ情報を扱い、項目ごとの対応は mapping/gif-address.yaml とこのページにあります。GIF は XSD と Excel で公開されていて、JSON-LD でも JSON Schema でもありません。この値型があるのはそのためです。
  • 検討した上流:型そのものは、カタログの値型として定め、schema.org の PostalAddress のサブクラスとしています(2026-10-12)。日本の住所の部分(町字、丁目、番地、号)とコードを足しているからです。schema.org の PostalAddress の語は、意味が合うものを再利用しています(addressCountry、postalCode、addressRegion、addressLocality)。streetAddress は使いません。schema.org はこの語で欧米式の住所の番地の行を指しますが、GIF は同じ名前を町字に使っているからです。IRI を再利用すると意味があいまいになるので、構造化した項目と addressText で置き換えました。対応は GIF の対応表に記録しています。
  • コードは、JIS X 0401(都道府県、2 桁)、JIS X 0402(市区町村、5 桁)、全国地方公共団体コード(検査数字を含む 6 桁)に従います。abrMachiazaId は、デジタル庁のアドレス・ベース・レジストリの町字 ID です。
  • GeoProperty の座標は、GeoJSON の仕様により WGS84 です。JGD2011 の座標は、ここで必要な精度ではそのまま使えます。
  • 2026-10-03 に、地番の区域では地番全体(枝番を含む。例:4638-1)を banchi に入れ、go は空にすると決めました。枝番は号ではないからです。アドレス・ベース・レジストリでは、住居表示の街区符号・住居番号(rsdt)と地番(chiban)が別の項目になっています。変換(geolonia/datamodels-toolkit#3)で実データを試したときにわかりました。
  • 項目をどこまで分けるかは、デジタル庁のアドレス・ベース・レジストリを手本にしています(2026-10-30)。分かれている項目をあとでつなげるのは簡単な規則でできますが、つながった項目を分け直すには文字列を解析しなければならず、間違えることがあるからです。GIF は番地以下(街区符号・住居番号または地番)を cityBlock の 1 つにまとめていますが、JapaneseAddress は chome、banchi、go を分けて持ち、GIF に変換するときにつなげます。machiaza と chome は streetAddress に、banchi と go は cityBlock になります(mapping/gif-address.yaml)。レジストリのさらに細かい項目(小字、住居番号の 2 つ目の番号、地番の支号)は別の項目にせず、machiaza、go、banchi に入れます。それより細かい情報は、レジストリから引けます。町字は abrMachiazaId と localGovernmentCode の組で決まり、街区、住居、地番はさらに banchi と go で探します。レジストリとの対応は mapping/abr.yaml にあります。
  • 項目の名前は、レジストリの列名(blk_num、rsdt_num、prc_num1〜3 など)に合わせず、今のままにすると決めました(2026-10-30)。レジストリの列は、地番、街区、住居というデータセットごとに分かれていて、街区符号と地番は別のデータセットの別の列です。モデルでは、どちらも banchi の 1 つで扱えるほうが使いやすいからです。