JapaneseAddress ドラフト 値型

これはエンティティ型ではなく、属性の値として使う構造です。

日本の住所

address 属性の値として使う日本の住所。意味が同じ項目は schema.org の PostalAddress の語を使い、日本固有の構造（町字・丁目・番地・号）、JIS コードと全国地方公共団体コード、アドレス・ベース・レジストリの町字ID、住居表示フラグを追加したもの。どの項目も任意。構造化できない場合は addressText だけでもよい。

IRI	https://datamodels.jp/ns/common/JapaneseAddress
@context	https://datamodels.jp/context/common/v1.jsonld （エイリアス、互換性のある最新版） https://datamodels.jp/context/common/v1.0.0.jsonld （このバージョン、不変）
JSON Schema	/schema/common/JapaneseAddress/v1.json /schema/common/JapaneseAddress/v1.0.0.json
例	example.json
ソース	github.com/geolonia/datamodels

フィールド

addressCountry

国。常に JP

• 値: string = JP
• IRI: https://schema.org/addressCountry

postalCode

郵便番号（7桁、ハイフンあり・なしどちらも可）

• 値: string, pattern ^\d{3}-?\d{4}$
• IRI: https://schema.org/postalCode

addressRegion

都道府県名

• 値: string
• IRI: https://schema.org/addressRegion

addressLocality

市区町村名。政令指定都市は市名と区名を含む（例: 横浜市中区）

• 値: string
• IRI: https://schema.org/addressLocality

machiaza

町字（町名・大字・字）。丁目は含めない

• 値: string
• IRI: https://datamodels.jp/ns/common/machiaza

chome

丁目。数字のみ（「一丁目」→ "1"）

• 値: string, pattern ^\d+$
• IRI: https://datamodels.jp/ns/common/chome

banchi

番地または街区符号（住居表示実施区域では街区符号）

• 値: string
• IRI: https://datamodels.jp/ns/common/banchi

go

号または住居番号（住居表示実施区域では住居番号）

• 値: string
• IRI: https://datamodels.jp/ns/common/go

buildingName

建物名・部屋番号など、号より下の表記

• 値: string
• IRI: https://datamodels.jp/ns/common/buildingName

residentialIndication

住居表示実施区域なら true（banchi/go は街区符号/住居番号）、地番なら false

• 値: boolean
• IRI: https://datamodels.jp/ns/common/residentialIndication

jisPrefectureCode

都道府県コード（JIS X 0401、2桁）

• 値: string, pattern ^\d{2}$
• IRI: https://datamodels.jp/ns/common/jisPrefectureCode

jisMunicipalityCode

市区町村コード（JIS X 0402、都道府県コードを含む5桁）

• 値: string, pattern ^\d{5}$
• IRI: https://datamodels.jp/ns/common/jisMunicipalityCode

localGovernmentCode

全国地方公共団体コード（JIS X 0402 の5桁 + 検査数字1桁）

• 値: string, pattern ^\d{6}$
• IRI: https://datamodels.jp/ns/common/localGovernmentCode

abrMachiazaId

アドレス・ベース・レジストリの町字ID（7桁）。全国地方公共団体コードと組み合わせて町字を一意に識別する

• 値: string, pattern ^\d{7}$
• IRI: https://datamodels.jp/ns/common/abrMachiazaId

addressText

住所の全文（正規化済みの一行表記）。構造化フィールドが揃わない場合の受け皿でもある

• 値: string
• IRI: https://datamodels.jp/ns/common/addressText

使い方

"address": {
  "$ref": "https://datamodels.jp/schema/common/JapaneseAddress/v1.0.0.json",
  "x-ngsi": { "type": "Property", "model": "https://datamodels.jp/ns/common/JapaneseAddress" },
  "x-iri": "https://schema.org/address"
}

{ "@context": ["https://datamodels.jp/context/common/v1.0.0.jsonld", { ... }] }

例（key-values）

{
  "addressCountry": "JP",
  "postalCode": "760-0017",
  "addressRegion": "香川県",
  "addressLocality": "高松市",
  "machiaza": "番町",
  "chome": "1",
  "banchi": "8",
  "go": "15",
  "buildingName": "高松市役所 3階",
  "residentialIndication": true,
  "jisPrefectureCode": "37",
  "jisMunicipalityCode": "37201",
  "localGovernmentCode": "372013",
  "abrMachiazaId": "0001001",
  "addressText": "香川県高松市番町1丁目8-15"
}

対応する標準: デジタル庁 GIF コアデータモデル「住所」

デジタル庁 GIF コアデータモデル「住所」 · CC BY 4.0 (schema), CC0 1.0 (repository)

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 には無い

注記

• A value type, not an entity type. Use it as the value of an address Property (IRI https://schema.org/address) and reference the schema with $ref from an entity schema.
• The official Japanese address model is the Digital Agency's GIF core data model 住所 (Address). JapaneseAddress covers the same information; the field-by-field correspondence is in mapping/gif-address.yaml and on the page. GIF is published as XSD and Excel, not as JSON-LD or JSON Schema, which is why this value type exists.
• schema.org PostalAddress terms are reused where the meaning matches (addressCountry, postalCode, addressRegion, addressLocality). streetAddress is not used: schema.org means the street line of a Western address by it, while GIF uses the same name for 町字. Reusing the IRI would carry an ambiguous meaning; the structured fields and addressText replace it, and the GIF mapping records the correspondence.
• Codes follow JIS X 0401 (prefecture, 2 digits), JIS X 0402 (municipality, 5 digits) and the 全国地方公共団体コード (6 digits with check digit). abrMachiazaId is the 町字ID of the Digital Agency's Address Base Registry.
• GeoProperty coordinates are WGS84 by the GeoJSON specification; JGD2011 coordinates can be used as-is at the precision relevant here.

このページのモデル内容は CC BY 4.0 で提供されています。 LICENSE-CONTENT