ALUZZA MARINE: Japan boat trade and tide tables

使える品目の番号と名前（日本語と英語）、データの注意を返す。最初にこれを呼ぶと間違えにくい。

{
  "type": "object",
  "properties": {}
}

ある年・流れ・品目の、国ごとの数量と金額（円）を返す。partner を書けばその国だけ。partner に「世界の合計」と書けば全体。

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 2011,
      "maximum": 2025,
      "description": "年（2011〜2025）"
    },
    "flow": {
      "type": "string",
      "enum": [
        "import",
        "export"
      ],
      "description": "import＝日本の輸入・export＝日本の輸出"
    },
    "hs": {
      "type": "string",
      "description": "品目の番号。例：8903（船の合計）・890332（モーターボート 7.5〜24m）・890322（セールボート 7.5〜24m）・840721（船外機）・8902（漁船）。一覧は list_codes"
    },
    "partner": {
      "type": "string",
      "description": "相手の国の日本語名（例：アメリカ・フランス・中国・韓国・タイ）。省くと全部の国"
    }
  },
  "required": [
    "year",
    "flow",
    "hs"
  ]
}

年の範囲・流れ・品目で、相手の国を数量か金額の大きい順に並べる。1 つあたりの平均の値段（円）も付ける。

{
  "type": "object",
  "properties": {
    "flow": {
      "type": "string",
      "enum": [
        "import",
        "export"
      ],
      "description": "import＝日本の輸入・export＝日本の輸出"
    },
    "hs": {
      "type": "string",
      "description": "品目の番号。例：8903（船の合計）・890332（モーターボート 7.5〜24m）・890322（セールボート 7.5〜24m）・840721（船外機）・8902（漁船）。一覧は list_codes"
    },
    "year_from": {
      "type": "integer",
      "minimum": 2011,
      "maximum": 2025,
      "description": "年（2011〜2025）"
    },
    "year_to": {
      "type": "integer",
      "minimum": 2011,
      "maximum": 2025,
      "description": "年（2011〜2025）"
    },
    "by": {
      "type": "string",
      "enum": [
        "quantity",
        "value"
      ],
      "description": "quantity＝数量の順・value＝金額の順（省くと quantity）"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "何か国まで（省くと 10）"
    }
  },
  "required": [
    "flow",
    "hs"
  ]
}

流れ・品目・相手の国の、2011〜2025 年の年ごとの数量と金額（円）を返す。partner を省くと世界の合計。

{
  "type": "object",
  "properties": {
    "flow": {
      "type": "string",
      "enum": [
        "import",
        "export"
      ],
      "description": "import＝日本の輸入・export＝日本の輸出"
    },
    "hs": {
      "type": "string",
      "description": "品目の番号。例：8903（船の合計）・890332（モーターボート 7.5〜24m）・890322（セールボート 7.5〜24m）・840721（船外機）・8902（漁船）。一覧は list_codes"
    },
    "partner": {
      "type": "string",
      "description": "相手の国の日本語名。省くと世界の合計"
    }
  },
  "required": [
    "flow",
    "hs"
  ]
}

潮見表の地点（気象庁の潮位表の 239 か所）を探す。query に地名（例：釧路・東京・横浜・博多）、region に地方（例：北海道東部・関東地方・伊豆諸島）。どちらも省くと地方の一覧と地点の数。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "地点の名前の一部か、2 文字の地点記号（例：TK）"
    },
    "region": {
      "type": "string",
      "description": "地方の名前の一部"
    }
  }
}

ある地点・ある日の満潮と干潮の時刻と潮位（cm・潮位表基準面から）、月齢、潮回り（大潮・中潮・小潮・長潮・若潮）、その日の月相を返す（2026-01-01〜2027-12-31）。days で 7 日まで続けて。include_hourly で 1 時間ごとの潮位も。気象庁の天文潮の推算で、予報ではない。

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "description": "地点の名前（例：東京・釧路）か地点記号（例：TK）。同じ名前の候補が複数あるときは候補を返す"
    },
    "date": {
      "type": "string",
      "description": "日付（YYYY-MM-DD・日本の日付）"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "何日分（省くと 1）"
    },
    "include_hourly": {
      "type": "boolean",
      "description": "1 時間ごと（0〜23 時）の潮位も返すか（省くと false）"
    }
  },
  "required": [
    "station",
    "date"
  ]
}

いま（日本の時刻）から見た、次の満潮と次の干潮の時刻・潮位・あと何分か、いまの潮位のおよその値と上げ潮か下げ潮か、潮回りを返す。読み上げ用の短い文（speech_ja）つき。at で別の時刻も。気象庁の天文潮の推算で、予報ではない。

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "description": "地点の名前（例：東京・釧路）か地点記号（例：TK）"
    },
    "at": {
      "type": "string",
      "description": "日本の時刻 YYYY-MM-DDTHH:MM（省くといま）"
    }
  },
  "required": [
    "station"
  ]
}

港（潮見表の地点）のいちばん近い気象台・測候所（40 km 以内）の、過去の月ごとの平均気温・平均風速・降水量（1991 年から・気象庁の観測）。year だけならその年の 12 か月、month だけなら毎年のその月、両方なら一つの月、どちらも省くと最新の 12 か月。過去の観測で、予報ではない。

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "description": "港の名前か地点記号（例：釧路・東京・TK）、または気象台の名前"
    },
    "year": {
      "type": "integer",
      "minimum": 1991,
      "maximum": 2100,
      "description": "年"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "月"
    }
  },
  "required": [
    "station"
  ]
}