ForHosting KIT · PDF・文書ツール

用紙1枚あたりのラベル枚数計算

用紙1枚あたりのラベル枚数計算ツールは、印刷や用紙の発注前に、長方形グリッドの行数、列数、総枚数を求めます。用紙とラベルの寸法を同じ単位で入力し、プリンターに必要な上、右、下、左の余白を指定してください。任意の水平間隔と垂直間隔で、隣接するラベル間の空きを表せます。結果には使用可能寸法、占有寸法、未使用寸法も表示されるため、ラベルを暗黙に縮小せず、レイアウトが収まるか確認できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

すべての寸法を同じ単位で入力します

まず、用紙と仕上がりラベル1枚の実際の幅と高さを入力します。ミリメートル、インチ、ポイントなど、任意の長さ単位を使用できます。この計算は単位変換を行わず、入力値の比率をそのまま扱います。そのため、すべての項目で同じ単位を使うことが重要です。ミリメートル表記の用紙とインチ表記のラベルを組み合わせないでください。プリンタードライバーで拡大縮小されたアートワークの寸法ではなく、実際の断裁寸法を指定します。用紙とラベルの寸法は、有限かつ0より大きい数値でなければなりません。この検証により、未入力、負数、誤って入力された文字列から不正確な枚数が算出されることを防げます。向きにもご注意ください。sheet_widthとlabel_widthは水平方向、高さの項目は垂直方向を表します。回転配置が可能な場合は、ラベルの幅と高さを入れ替えてもう一度計算し、合計を比較してください。図柄、紙目、貼付装置、文字の読みやすさによって向きが限定される場合があるため、自動回転は行いません。

枚数を求める前に余白と間隔を指定します

余白は、ラベルを置けない用紙端の領域です。プリンターの印刷不可領域が左右非対称の場合や、端ごとの廃棄幅が異なる場合にも対応できるよう、上、右、下、左を個別に入力します。省略した余白は0です。左右の余白の合計は用紙幅と同じ値まで指定できますが、それを超えることはできません。上下についても同様です。horizontal_gapは隣接する列の間隔、vertical_gapは隣接する行の間隔です。間隔はラベル同士の間だけに入り、先頭ラベルの前や末尾ラベルの後には入りません。したがって、1行に3枚ある場合、水平間隔は2か所です。どちらの間隔も初期値は0で、負数は指定できません。使用可能幅は用紙幅から左右の余白を引いた値で、使用可能高さも同様に求めます。この方式により、最後のラベルの後にも間隔を加算して、ぴったり収まるレイアウトを過小評価する誤りを防ぎます。

収容枚数と残り寸法を確認します

結果にはcolumns、rows、labels_per_sheetが含まれます。一部だけ収まるラベルは使用できないため、列数と行数は整数で、その積が総枚数です。使用可能領域がラベルより小さい場合、正しい寸法を入力していても0が返ることがあります。これは配置結果であり、入力エラーではありません。使用可能寸法は余白を除いた領域を示します。占有寸法にはラベルと内部の間隔が含まれ、未使用寸法は使用可能領域内の残りを示します。残りは自動的に分配または中央揃えされません。中央に配置する場合、最初のラベル位置を決める際に、unused_widthの半分を左余白へ、unused_heightの半分を上余白へ加えてください。本計算は、軸に沿った長方形ラベルの規則的なグリッドを前提とします。塗り足し、トンボ、プリンター公差、角丸の余裕、見当マークは自動追加されません。必要な場合は寸法、余白、間隔に含め、大量印刷前にプリンター仕様と照合してください。

活用例

特注ラベル用紙を計画する

抜き型、用紙、印刷工程を発注する前に、選んだ用紙とラベル寸法および間隔を比較できます。

印刷テンプレートを設定する

文書やレイアウトソフトでラベルを配置するための正確な行列数と残り寸法を取得できます。

ラベルの向きを比較する

通常の向きと回転した向きを計算し、より多く配置できる有効なグリッドを選べます。

よくある質問

料金はいくらですか？

APIリクエスト1回の料金は$0.002です。同じ決定論的な計算をブラウザーでも実行できます。

どの測定単位を使用できますか？

ミリメートルやインチなど任意の長さ単位を使用できますが、1回の入力ではすべて同じ単位にしてください。

最後のラベルの後にも間隔が入りますか？

いいえ。間隔は隣接するラベル間だけに入り、n枚のラベルにはnから1を引いた数の間隔が必要です。

ラベルが収まらない場合はどうなりますか？

収まらない方向の数は0となり、labels_per_sheetも0になります。

最適に収まるよう自動的にラベルを回転しますか？

いいえ。指定された向きを使用します。回転を調べるには、別のリクエストでlabel_widthとlabel_heightを入れ替えてください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/doc/labels-per-sheet

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/doc/labels-per-sheet \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sheet_width":210,"sheet_height":297,"label_width":63.5,"label_height":38.1}'

const res = await fetch("https://api.kit.forhosting.com/doc/labels-per-sheet", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "sheet_width": 210,
    "sheet_height": 297,
    "label_width": 63.5,
    "label_height": 38.1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/labels-per-sheet",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "sheet_width": 210,
    "sheet_height": 297,
    "label_width": 63.5,
    "label_height": 38.1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/labels-per-sheet", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"sheet_width":210,"sheet_height":297,"label_width":63.5,"label_height":38.1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"sheet_width":210,"sheet_height":297,"label_width":63.5,"label_height":38.1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/labels-per-sheet", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "sheet_width": 210,
  "sheet_height": 297,
  "label_width": 63.5,
  "label_height": 38.1
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.labels_per_sheet",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	25
`max_pages`	200

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →