日本語
JapaneseAddress ドラフト 値型 サブクラス
日本の住所
address 属性の値として使う、日本の住所です。意味が同じ項目には、schema.org の PostalAddress の語を使っています。そのうえで、日本固有の構造(町字、丁目、番地、号)、JIS コードと全国地方公共団体コード、アドレス・ベース・レジストリの町字 ID、住居表示かどうかを加えています。どの項目も任意です。構造化できないときは、addressText だけでも構いません。
| 種類 | 値型:属性の値の中で使い、単独のエンティティにはならない |
| 親の型 | https://schema.org/PostalAddress のサブクラスです。親はこのカタログの外の型で、この型はそれより狭いか、項目を足しています。意味が合う項目は親の語彙の IRI を使います。関係は語彙に rdfs:subClassOf として書いてあります。 |
| IRI | https://datamodels.jp/ns/common/JapaneseAddress |
| @context | https://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 とバージョンを見てください。
型と関係
値型として使う他の分野ほか 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 は街区符号と住居番号)、地番なら falsehttps://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 にあります。
参照している標準
このモデルが対応している標準と、項目ごとの対応です。開くと対応表が見られます。
デジタル庁 アドレス・ベース・レジストリ(町字、地番、住居表示の街区・住居のデータセット)
列の名前と意味は、上のページで公開されている「データフォーマット(仕様確定版)」(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 |
postalCode | post_code | 町字(mt_town)の列。郵便番号が複数あるとき(セミコロン区切り)は、ほかの情報で 1 つに決まる場合だけその番号を入れ、決まらなければ postalCode は省く |
addressRegion | pref | |
addressLocality | county + city + ward | 郡、市区町村、政令市の区をつなげる |
machiaza | oaza_cho + koaza | 大字・町と小字をつなげる。丁目は JapaneseAddress の chome に入れる |
chome | chome_number | chome_number は丁目の数字。レジストリの chome 列は「一丁目」のような書き方 |
banchi | blk_num、prc_num1 + prc_num2 + prc_num3 | 住居表示では街区符号(blk_num)。地番では本番(prc_num1)、支号(prc_num2)、支号の支号(prc_num3)をハイフンでつなげ、空の部分は省く(例:4638-1)。ハイフンでつなげるのはこのカタログの決まり。レジストリでは、例外的に数字以外を含むことがある。 |
go | rsdt_num + rsdt_num2 | 住居番号(rsdt_num)。住居番号が 2 つの番号でできているとき(団地・中高層建物の特例や枝番)は、後の番号(rsdt_num2)をハイフンでつなげる(このカタログの決まり)。地番では空。 |
residentialIndication | rsdt_addr_flg | 1(住居表示実施)→true、0(住居表示非実施)→false。フラグは町字ごとで、住居表示の区域とそうでない区域が同じ町字にあるときは、その町字に 2 つのレコードがある。住所が当てはまる方のレコードの値を使う。 |
localGovernmentCode | lg_code | |
jisPrefectureCode | 対応なし | lg_code の先頭 2 桁 |
jisMunicipalityCode | 対応なし | lg_code の先頭 5 桁 |
abrMachiazaId | machiaza_id | |
buildingName | 対応なし | レジストリには無い |
addressText | 対応なし | レジストリには無い。各項目をつなげて作る |
この標準のデータを変換するための対応表(YAML): abr.yaml(説明は対応表)
この標準のライセンス: 公共データ利用規約(第1.0版)(PDL1.0)。地番のデータ(地番マスター)には、登記所備付地図データ利用規約も適用される(上のページからリンクした「データの利用規約」を参照)。
デジタル庁 GIF コアデータモデル「住所」
GIF の住所は町字(streetAddress)に丁目を含め、番地以下を cityBlock ひとつにまとめる。JapaneseAddress は丁目・番地・号を分けて持つため、GIF へ変換するときは連結する。
| このモデル | 対応先 | 備考 |
|---|---|---|
addressCountry | country | GIF は国コードリスト(CountryRegionCodeList)。JP に対応 |
postalCode | postalCode | |
addressRegion | prefecture | |
addressLocality | cityAndCounty | 郡名・政令市の区名を含む点は同じ |
machiaza | streetAddress | GIF の町字は丁目を含む。machiaza + chome に対応 |
chome | streetAddress | 上記のとおり町字に含まれる |
banchi | cityBlock | GIF は番地以下(街区符号・住居番号または地番)をひとつの項目にまとめる。banchi + go に対応 |
go | cityBlock | |
buildingName | buildingNameEtc | |
addressText | fullAddress | |
localGovernmentCode | localGovernmentCode | |
abrMachiazaId | streetAddressId | どちらもアドレス・ベース・レジストリの町字ID |
jisPrefectureCode | 対応なし | GIF には無い。localGovernmentCode の先頭2桁から導ける |
jisMunicipalityCode | 対応なし | GIF には無い。localGovernmentCode の先頭5桁から導ける |
residentialIndication | 対応なし | GIF には無い |
この標準との対応表(YAML): gif-address.yaml(説明は対応表)
この標準のライセンス: スキーマは CC BY 4.0、リポジトリは CC0 1.0
国土地理院「指定緊急避難場所データ」「指定避難所データ」の住所
住所は 1 列の連結表記だけ。構造化した項目は無い。
| このモデル | 対応先 | 備考 |
|---|---|---|
addressCountry | 対応なし | データには無い。常に JP |
addressText | 住所 | |
localGovernmentCode | 対応なし | データには無い。ファイル名の市町村コードから導ける |
この標準のデータを変換するための対応表(YAML): gsi-address.yaml(説明は対応表)
この標準のライセンス: 国土地理院コンテンツ利用規約と、同サイトの「ご利用上の注意」
自治体標準オープンデータセット・データ項目定義書A(20260801版)の所在地の項目(デジタル庁)
定義書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 と互換)
注記
- エンティティの型ではなく、値型です。
addressProperty(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 つで扱えるほうが使いやすいからです。