ForHosting KIT · 開発者向けツール

角度と高さから水平距離を計算

この計算機は、物体の垂直な高さと、その頂点までの仰角が分かっているときに、観測地点から物体までの水平距離を求めます。直角三角形の関係を利用し、高さを角度の正接で割ります。これは高さに余接を掛けることと同じです。結果の長さの単位は入力した高さと同じになるため、現地での概算、測量の演習、撮影位置の検討、実用的な幾何計算に利用できます。斜めの視線距離ではなく、地面に沿った水平距離を求める計算です。

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

無料で実行 API仕様を見る

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

この計算で求める距離

物体の高さと地面上の距離を、直角三角形を構成する互いに垂直な2辺として扱います。既知の垂直高さと、観測地点の水平線から物体の頂点まで測った仰角を入力してください。返される値は水平な隣辺であり、頂点までの斜めの視線距離ではありません。正接は対辺を隣辺で割った値なので、式を変形すると隣辺は対辺を正接で割って求められます。この問題では対辺が高さ、隣辺が水平距離です。高さにはメートル、フィート、センチメートルなど、一貫した任意の長さの単位を使用できます。三角比には単位がないため、結果は入力した高さと同じ単位になります。角度は度で入力し、0より大きく90より小さくなければなりません。また、観測地点と物体の根元の間が水平で、入力した高さが観測水準から目標点までの垂直差全体を表すものと仮定しています。

実用的な仰角の測り方

信頼できる結果を得るには、適切な角度測定が必要です。物体の根元が見える場所、または根元の位置が分かる場所に立ち、傾斜計、測量機器、校正済みのスマートフォン用ツールなどで、水平基準から頂点までを測ってください。機器を安定させ、角度を度で記録します。仰角が小さい場合は、わずかな測定誤差でも正接の変化によって距離に大きな差が生じやすくなります。可能であれば複数回測定し、代表的な値を採用してください。この計算機は、観測点と物体の根元が同じ高さにあると仮定します。機器が根元より高い、または低い場合は、物体の公称全高ではなく、機器から目標点までの垂直差を入力します。平地で目の高さから塔を見る場合は、塔の高さから目の高さを差し引いてください。傾斜地では、より完全な測量モデルが必要です。

結果の読み方と確認方法

出力には、元の高さと角度、ラジアンに変換した角度、計算された水平距離が含まれます。入力値も結果に残るため、自動処理の記録を確認しやすく、ラジアン値から三角関数に渡された数値も確認できます。よく知られた角度を使うと、妥当性を簡単に点検できます。45度では正接が1なので、水平距離と高さは同じです。45度未満なら距離は高さより大きく、45度を超えるなら小さくなるはずです。この関係と合わない場合は、角度を垂直線ではなく水平線から測ったか、ラジアンではなく度で入力したかをご確認ください。この式は理想的な直角三角形を表します。地球の曲率、大気屈折、根元のずれや接近不能、地形の傾斜、機器の校正誤差は補正しません。近距離では影響が小さくても、高精度または長距離の測量では重要になる場合があります。

活用例

目印までの距離を概算

既知の目印の高さと測定した仰角を使い、観測地点からの水平距離を見積もります。

現地観測の配置を計画

垂直な対象物に対して、カメラ、測定機器、観測地点をどこに置くか検討できます。

直角三角形の問題を確認

対辺と鋭角から隣辺を求める計算を、決定論的な余接の結果で確認できます。

よくある質問

どの式を使いますか？

水平距離は、高さを仰角の正接で割って求めます。高さにその角度の余接を掛ける式と同じです。

結果の単位は何ですか？

入力した高さと同じ長さの単位です。フィートを入力すればフィート、メートルならメートルで返されます。

視線に沿った距離ですか？

いいえ。直角三角形の水平な隣辺であり、観測地点から目標までの斜めの斜辺ではありません。

角度を0度から90度の間にする理由は何ですか？

この幾何モデルでは、正の鋭角を使います。0度では距離に上限がなく、90度ではこの式から正の水平距離を定義できません。

観測地点が根元より高い場合はどうしますか？

観測地点から目標点までの垂直差を高さとして使用してください。その差が不明なら、この簡略計算だけでは求められません。

API の料金はいくらですか？

API は1リクエストあたり $0.002 です。同じ決定論的な計算をブラウザーで無料実行することもできます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/distance-from-angle-height

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

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

curl -X POST https://api.kit.forhosting.com/geo/distance-from-angle-height \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"height":30,"angle_degrees":35}'

const res = await fetch("https://api.kit.forhosting.com/geo/distance-from-angle-height", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "height": 30,
    "angle_degrees": 35
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/distance-from-angle-height",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "height": 30,
    "angle_degrees": 35
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/distance-from-angle-height", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"height":30,"angle_degrees":35}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"height":30,"angle_degrees":35}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/distance-from-angle-height", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "height": 30,
  "angle_degrees": 35
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.distance_from_angle_height",
  "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の完全なドキュメントを見る →