sb.jugesuke.net

/**
 * 土地連絡図索引データJSONの型定義
 */

/**
 * 和暦の年を表す型
 */
export interface JapaneseYear {
  /**
   * "明治"、"大正"、"昭和"、"平成"のいずれかを表す文字列。
   */
  era: "M" | "T" | "S" | "H";

  /**
   * 和暦の年数を表す数値。例えば、平成31年は31、昭和64年は64となります。
   */
  year: number;
}

/**
 * 土地連絡図の調査日を表す型
 */
export interface MapDate {
  /**
   * 調査年を和暦で表すオブジェクト。不明な場合はnullとなります。
   */
  japanese_year: JapaneseYear | null;

  /**
   * 調査月を表す数字。
   * 不明な場合はnullとなります。
   */
  year: number | null;

  /**
   * 調査月を表す文字列。複数月がある場合は「5.6」のように表されます。
   * 不明な場合はnullとなります。
   */
  month: string | null;

  /**
   * 調査日を表す数字。
   * 不明な場合はnullとなります。
   */
  day: number | null;
}

/**
 * 字を表す型
 */
export interface AzaListItem {
  /**
   * 正規化された字名。azaList[].normalized の値と対応する。
   */
  normalized: string;

  /**
   * 原典に記載された字名の表記（表記ゆれを含む）。
   *
   * 表記ゆれがない場合はnormalizedと同一の文字列になります。
   * 旧字体・仮名の揺れなど表記が複数存在する字名では、代表的な表記を normalized として採用し、原典の記載をそのまま original に保持します。
   */
  original: string;
}

/**
 * 各図が持つ情報を表す型
 */
export interface MapEntry {
  /**
   * 地図の管理番号。通常は数値文字列（例："1"）だが、サフィックス付き（例："35-1"）の場合もある。
   */
  number: string;

  /**
   * 地図の作成日付
   *
   * 記載がない場合は、値が null になるのではなく、date 内の全フィールド（japanese_year・year・month・day）がすべて null になります。
   */
  date: MapDate;

  /**
   * 事業手の氏名。不明・未記入の場合は空文字列 ""。
   */
  project_owner: string;

  /**
   * 備考・注記。記載なしの場合は null。
   * このフィールドは構造化されたデータではなく、原典の記載や、構造化できない情報をそのまま保持するためのものです。
   */
  notes: string | null;

  /**
   * この地図に記載されている字のリスト
   *
   * 地図の対象字が特定できない場合、aza_list の各エントリの normalized・original がともに空文字列になることがあります。
   * これは欠損データを示します。
   * 他村の字が記載されている場合は、その字も aza_list に含まれますが、あ字名の前に尊名が付記されています。
   */
  aza_list: AzaListItem[];
}

/**
 * 字のリストを表す型
 * 登場するすべての字名を列挙した正規化マスターです。
 * maps[].aza_list[].normalized の値はこのリストの normalized と一致します。
 */
export interface AzaListEntry {
  /**
   * 正規化された字名。この値が字名の一意な識別子となる。
   */
  normalized: string;

  /**
   * normalized と異なる原典表記のリスト（表記ゆれの一覧）。
   * 表記ゆれが存在しない字名では空配列 [] になる。
   */
  originals: string[];
}

/**
 * 土地連絡図索引データ全体を表す型
 */
export interface TochiRenrakuzuIndexData {
  /**
   * 土地連絡図のリストを表す配列。
   */
  maps: MapEntry[];

  /**
   * 字名正規化マスター
   *
   * 他村の字が記載されている場合は、その字も aza_list に含まれますが、字名の前に尊名が付記されています。
   */
  azaList: AzaListEntry[];
}