ForHosting KIT · 開発者向けツール

地図の縮尺と起伏から等高線間隔を計算

等高線間隔を決める際は、地形を詳しく表すことと、線を読みやすく保つことの両方が必要です。この計算ツールは、縮尺の分母と対象範囲の標高差に、明示された地図作成上の経験則を適用します。推奨間隔をメートルとフィートで示し、縮尺と起伏のどちらが結果を決めたか、さらに標高差に含まれるおおよその等高帯数も返します。一般的な地形図の計画に使う目安であり、公的な作成要領や案件固有の精度基準に代わるものではありません。

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

無料で実行 API仕様を見る

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

縮尺が読みやすい間隔を制約する理由

縮尺1:50,000は、地図上の1単位が地上の同じ50,000単位に当たることを表します。分母が大きいほど、同じ紙面に広い地域を収めるため、等高線を細かくすると線同士を見分けにくくなります。このツールでは分母を2,500で割り、その値をメートルとして縮尺側の候補を求めます。これは表現できる鉛直方向の細かさに関する実用的な目安であり、測量精度を保証する値ではありません。入力欄には比率全体ではなく、50,000のように分母だけを指定してください。ただし、縮尺だけで最終判断はできません。平坦地では細かな表現が役立つ一方、山地では線が密集する場合があります。掲載寸法、線幅、注記の頻度、標高データの精度、想定読者も考慮して最終値を決める必要があります。

地形の起伏が推奨値に与える影響

ここでいう起伏は、作図範囲内の最高標高と最低標高の差です。ツールはこの標高差を30で割り、範囲全体がおよそ三十以下の等高帯に収まることを目安にします。この確認により、縮尺だけで間隔を決めた結果、急斜面が判別しにくい線の塊になることを避けられます。起伏から得た候補と縮尺から得た候補を比較し、大きい方を採用するとともに、どちらが決定要因だったかを出力します。地図が一つの谷や市街地だけを扱う場合は、広域全体ではなく実際の図郭内の標高差を使ってください。孤立した山頂のような外れ値にも注意が必要です。そのような場合は全範囲と主要部分の両方で試算し、補助曲線、標高点、局所的な描画方法の変更も検討してください。

計算値を標準的な間隔へ切り上げる理由

計算途中では23.4メートルのように、反復使用や注記に向かない値が生じます。そのため、適切な十の累乗における1、2、2.5、5の系列のうち、次に大きい値へ切り上げます。20メートルをわずかに超える条件なら25メートルとなり、25を超えれば50メートルとなります。切り上げることで、経験則が求める読みやすさを損なうほど線を密にすることを防ぎます。出力にはフィート換算と、入力した起伏を横切る等高帯数の概算も含まれます。フィート値は単なる換算であり、ヤード・ポンド法向けに別途丸めた地図規格ではありません。制作前には、元データの鉛直精度、計曲線の配置、公的または契約上の仕様と照合してください。地域の慣行に合う近隣の慣用値を選ぶ場合も、図面の判読性とデータ精度の両方を満たすことが重要です。

活用例

地形図の新規作成を計画する

最終レイアウトで線密度や注記を検討する前に、根拠の明確な初期値を得られます。

複数の地図縮尺を比較する

同じ地形でも縮尺を変えると適切な鉛直間隔がどう変化するか確認できます。

地形表現の密度を点検する

既存の等高線が縮尺と総起伏に対して過密または過疎でないかを判断できます。

よくある質問

縮尺には何を入力しますか？

分母だけを入力してください。1:25,000の地図なら25000と指定します。

起伏はどのように求めますか？

作図範囲内の最高標高から最低標高を引き、その差をメートルで入力します。

推奨間隔は必ず守る規格ですか？

いいえ、一般的な目安です。適用される仕様、元データの精度、線の表現、地図の目的を優先してください。

なぜ値を切り上げるのですか？

縮尺と起伏の確認から導かれた限度より、等高線が密になることを防ぐためです。

決定要因とは何ですか？

縮尺側と起伏側の候補のうち、どちらが大きく、推奨値を決めたかを示します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/contour-interval

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

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

curl -X POST https://api.kit.forhosting.com/geo/contour-interval \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scale_denominator":50000,"relief_m":600}'

const res = await fetch("https://api.kit.forhosting.com/geo/contour-interval", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "scale_denominator": 50000,
    "relief_m": 600
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/contour-interval",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "scale_denominator": 50000,
    "relief_m": 600
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/contour-interval", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"scale_denominator":50000,"relief_m":600}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"scale_denominator":50000,"relief_m":600}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/contour-interval", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "scale_denominator": 50000,
  "relief_m": 600
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

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