JapaneseAddress draft value type

This is not an entity type but a structure used as the value of an attribute.

A Japanese postal address as the value of an address Property. schema.org PostalAddress terms where the meaning matches, plus the Japanese structure (machiaza, chome, banchi, go), JIS and local-government codes, the Address Base Registry town id and the residential-indication flag. Every field is optional; addressText alone is acceptable when the address cannot be structured.

Japanese name	日本の住所
IRI	https://datamodels.jp/ns/common/JapaneseAddress
@context	https://datamodels.jp/context/common/v1.jsonld (alias, latest compatible version) https://datamodels.jp/context/common/v1.0.0.jsonld (this version, immutable)
JSON Schema	/schema/common/JapaneseAddress/v1.json /schema/common/JapaneseAddress/v1.0.0.json
Examples	example.json
Source	github.com/geolonia/datamodels

Fields

addressCountry

Country. Always JP

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

postalCode

Postal code, 7 digits with or without hyphen

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

addressRegion

Prefecture name

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

addressLocality

Municipality name. For designated cities includes the ward (e.g. 横浜市中区)

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

machiaza

Town or district name (町字: 町名, 大字, 字), without chome

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

chome

Chome (丁目), digits only ("一丁目" → "1")

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

banchi

Banchi (番地) or, in residential-indication areas, the block number (街区符号)

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

go

Go (号) or, in residential-indication areas, the residence number (住居番号)

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

buildingName

Building name, room number and anything below go

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

residentialIndication

true in a residential-indication area (banchi/go are block and residence numbers), false for lot numbers (地番)

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

jisPrefectureCode

Prefecture code (JIS X 0401, 2 digits)

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

jisMunicipalityCode

Municipality code (JIS X 0402, 5 digits including the prefecture code)

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

localGovernmentCode

Local government code (全国地方公共団体コード: JIS X 0402 plus a check digit, 6 digits)

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

abrMachiazaId

Address Base Registry town id (町字ID, 7 digits). Unique together with localGovernmentCode

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

addressText

Full address as one normalised line. Also the fallback when structured fields are unavailable

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

Usage

"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", { ... }] }

Example (key-values)

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.

{
  "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号"
}

Corresponding standards: Digital Agency GIF core data model "Address"

Digital Agency GIF core data model "Address" · CC BY 4.0 (schema), CC0 1.0 (repository)

GIF keeps chome inside streetAddress (町字) and folds everything below into a single cityBlock. JapaneseAddress keeps chome, banchi and go apart, so a conversion to GIF concatenates them.

This model	Maps to	Note
addressCountry	country	GIF uses a country code list; JP corresponds
postalCode	postalCode
addressRegion	prefecture
addressLocality	cityAndCounty	both include county and designated-city ward names
machiaza	streetAddress	GIF streetAddress includes chome; corresponds to machiaza + chome
chome	streetAddress	included in streetAddress
banchi	cityBlock	GIF folds everything below the town into one field; corresponds to banchi + go
go	cityBlock
buildingName	buildingNameEtc
addressText	fullAddress
localGovernmentCode	localGovernmentCode
abrMachiazaId	streetAddressId	both are the Address Base Registry town id
jisPrefectureCode	no counterpart	not in GIF; derivable from the first two digits of localGovernmentCode
jisMunicipalityCode	no counterpart	not in GIF; the first five digits of localGovernmentCode
residentialIndication	no counterpart	not in GIF

Notes

• 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.

Model content on this page is licensed under CC BY 4.0. LICENSE-CONTENT