ForHosting KIT · 旅行・地理

純標高変化

Q: 距離や GPS 座標は必要ですか？

いいえ。 必要なのは順序付き標高標本のみです。距離・勾配・地図投影は対象外ですので、必要なら別途計算してください。

標高100, 120, 110, 150, 140 mの断面では、正味の変化は40 mですが、累積では60 m登り20 m下ります。最低点と最高点、高低差、上下移動の合計も分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

標高: 100, 120, 110, 150, 140 m

結果

サンプル数: 5 m
開始標高: 100
終了標高: 140
最低標高: 100

トレイルや道路断面に沿った純標高変化は、最後の標本から最初の標本を引いただけではありません。ハイカー、レース主催者、ルーティングエンジンは累積上昇と累積下降も重視します。始点と同じ標高で終わるアップダウンの多い経路でも、エネルギーは消費されるためです。この純標高変化計算機は、メートルまたはフィートの標高標本を経路順に受け取り、連続差分を一度走査し、純変化・累積上昇・累積下降・最小最大標高・標高レンジ・総垂直移動量を返します。アルゴリズムは純粋な算術で、地図タイルもGPS平滑化もネットワークも使いません。GPX由来の系列の評価、DEM抽出の検証、誠実な登坂統計をルートカードに載せる用途にご利用ください。

断面における純変化・累積上昇・累積下降の意味

経路に沿った順序付き標高標本 e0, e1, …, e(n−1) があるとき、純標高変化は単に最終値から初値を引いたものです（終点マイナス始点）。この一つの数値が「経路は始点より高く終わったか低く終わったか」に答え、目的地が起点より低い場合は負になります。体感のきつさは表しません。

累積上昇は連続する正の差分 max(0, ei − e(i−1)) をすべて合計するため、後で同じ高さを失っても上り区間はすべて累積登りに加算されます。累積下降は下り一歩を max(0, e(i−1) − ei) として合計します。代数的には、浮動小数の丸めの範囲で純変化＝累積上昇−累積下降となり、GPXやDEM抽出を監査する際の健全性確認に役立ちます。

標高レンジは系列全体の最大から最小を引いたもので、始点と終点が等しくても地形の垂直幅を捉えます。総垂直移動量は上昇と下降の和で、距離を固定したときのおおまかな負荷の代理指標になることがあります。本機能はカルマンフィルタ、スパイク除去、GPS誤差閾値を適用せず、標本が示す値をそのまま報告します。

レース規則やトレーニング負荷モデル向けに平滑化したトレイル統計が必要な場合は、上流でノイズの多い気圧系列を清浄化してください。

正確な登り下りの数値が必要な場面

トレイル計画アプリは、ユーザーが週末ループに決める前に DEM や気圧系列を登坂バッジと難易度ラベルに変換します。ウルトラマラソンやグラベルレースの主催者は、コース地図が変わりボランティアが別デバイスから同じトラックを再出力しても再現可能な累積上昇を必要とします。

フィットネス基盤は、時計の標本レートがルート計画と異なるとき、走行後に計画断面と実績断面を比較します。検証失敗は残高を消費しません。

活用例

ハイキング難易度ラベル

GPX トラック由来の順序付き DEM または気圧標本を入力し、ループを選ぶハイカー向けルートカードに純変化・累積上昇・累積下降を掲載します。

レースコースとイベント地図

公式コースのポリラインが改訂されるたびに累積上昇と下降を再計算し、選手向け資料を測定断面と一致させます。

よくある質問

純標高変化はどのように計算されますか？

純変化は最後の標高標本から最初を引いた値です。累積上昇は正の連続ステップを合計し、累積下降は負のステップの絶対値を合計します。恒等式：net = gain − loss。

なぜ累積上昇が純変化より大きくなるのですか？

途中の上りも、その後下っても計上されるためです。始点に戻る往復は純変化ゼロでも、累積上昇は累積下降と等しい正の値になります。

距離や GPS 座標は必要ですか？

いいえ。必要なのは順序付き標高標本のみです。距離・勾配・地図投影は対象外ですので、必要なら別途計算してください。

unit はメートルをフィートに換算しますか？

いいえ。 unit は表示ラベル（m または ft）です。断面全体を一つの単位系で送ってください。ハンドラは値を換算しません。

GPSや気圧計のばらついた値は平滑化されますか？

いいえ。フィルターや突出値の除去は行わず、入力した標高の値をそのまま集計します。記録にばらつきがある場合は、特に大会規則や練習計画に使う前に、データを整えてください。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/net-elevation-change

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

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

curl -X POST https://api.kit.forhosting.com/geo/net-elevation-change \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"elevations":[100,120,110,150,140]}'

const res = await fetch("https://api.kit.forhosting.com/geo/net-elevation-change", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "elevations": [
      100,
      120,
      110,
      150,
      140
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/net-elevation-change",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "elevations": [
        100,
        120,
        110,
        150,
        140
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/net-elevation-change", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"elevations":[100,120,110,150,140]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"elevations":[100,120,110,150,140]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/net-elevation-change", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "elevations": [
    100,
    120,
    110,
    150,
    140
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.net_elevation_change",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

入力契約、単位、応答フィールド、検証

任意の unit は m または ft の enum（既定 m）で、表示ラベルにすぎません。ハンドラはメートルとフィートを換算しないため、系列全体を一つの単位系に揃えてください。標本が二つ未満だと単一標高では変化を定義できないため失敗します。勾配パーセントが必要なら距離と勾配は別計算してください。経路順の有限数を少なくとも二つ含む必須配列 elevations を持つ JSON 本体を POST してください。別名 samples, profile, values, heights も同じように解決されます。各要素は JSON 数または数値文字列でよく、非有限値・空スロット・非数値トークンは無効なインデックスを示す invalid_input で失敗します。成功時の本体には sample_count、start_elevation と end_elevation、min_elevation と max_elevation と elevation_range、net_change、total_gain と total_loss、total_vertical、エコーされた unit、恒等式を再掲する短い formula 文字列が含まれます。例：elevations [100, 120, 110, 150, 140] は始点 100、終点 140、net_change 40、total_gain 60 (20+40)、total_loss 20 (10+10)、min 100、max 150、range 50、total_vertical 80 を与えます。本エンドポイントは連続標本間の垂直差分のみを測ります。

純標高変化 API が価値を発揮する場面

ポリラインに沿って標高ラスタを切り出す GIS ノートブックは、各言語バインディングで上昇下降を再実装する代わりに、この parse エンドポイントを呼べます。実装は純粋な parse ティア A のため、成功した呼び出しはモデルトークンも外向きネットワークもなく、公開された基本価格 $0.002 です。

連携の活用例

GIS とノートブック自動化

計画ポリライン沿いに標高を標本化した後、API を呼び出して上昇・下降・レンジを取得し、言語ごとに差分ループを書き直さずに済みます。

技術的な質問

純標高変化計算機の料金はいくらですか？

ブラウザツールは無料です。API リクエストは成功呼び出しあたり $0.002 の前払い KIT 残高を使用し、無効入力は課金されません。

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