ForHosting KIT · 開発者向けツール

グリッド偏角計算—方眼北・真北・磁北の補正

この計算機は、グリッド収束角と磁気偏角を組み合わせ、方眼北、地理学的な真北、磁北の間で方位を一貫して変換します。東向きを正とする規約で、両方の角度を十進度で入力してください。結果にはグリッド偏角に加え、各方向と逆方向の補正量が表示されます。そのため、変換のたびに加算か減算かを覚える必要がありません。地図作成、測量、航法、北基準を明示する必要があるソフトウェアに適しています。

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

無料で実行 API仕様を見る

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

3種類の北基準を区別します

地図上の方位は、基準となる北が分からなければ完全な情報ではありません。真北は地理学的北とも呼ばれ、子午線に沿って地理極へ向かいます。方眼北は、投影座標グリッドの縦線に沿う方向です。この縦線は通常、地点の子午線と完全には一致しないため、その角度差をグリッド収束角で表します。磁北はその場所の地磁気の方向であり、場所と時間によって変化します。磁気偏角は、真北から磁北までの角度差です。この計算機では、時計回り、すなわち東向きを正、西向きを負とする明確な規約を用います。グリッド収束角は真北から方眼北、磁気偏角は真北から磁北への角度です。座標、地図投影、日付、磁場モデルから入力値そのものを算出する機能ではありません。同じ場所と観測日に対応する値をご使用ください。

符号を推測せず補正量を適用します

返される各変換フィールドは、元の方位に加える補正量です。現在の基準で始まり、目的の基準で終わる名前のフィールドを選び、その値を加算してください。たとえば方眼方位に<code>grid_to_true_offset_deg</code>を加えると真方位になります。<code>grid_to_magnetic_offset_deg</code>を加えれば、2段階の計算をせず方眼方位から磁気方位へ直接変換できます。逆方向のフィールドは、丸め前には正確に反対の符号です。この規約では、真方位は方眼方位に収束角を加えた値で、磁気方位は真方位から磁気偏角を引いた値です。<code>grid_declination_deg</code>は方眼北から磁北への符号付き角度で、磁気偏角からグリッド収束角を引いて求めます。補正量を加えた後は、通常の0以上360未満など、ご利用の方式に合わせて最終方位を正規化してください。

適切な入力値を選び検証します

グリッド収束角は、特定の投影座標参照系と地点に対応します。別のグリッドゾーンの値を流用したり、印刷地図の図郭と真北の関係が図面全体で同じだと仮定したりしないでください。地磁気は時間とともに変化するため、磁気偏角も場所と時期に対応します。最新で信頼できる磁場モデル、海図・地図、または現地記録から取得し、その情報源が東を正とする符号付き角度を使うのか、東西の表記を使うのかをご確認ください。西の値は入力前に負数へ変換します。検証には任意の方位を使い、変換を一周させ、正規化後に開始値へ戻ることを確認してください。方眼から真北とその逆、方眼から磁北とその逆の補正量は、それぞれ相殺されます。精度オプションは表示桁数だけを制御し、測量精度を保証するものではありません。APIの利用料金は1リクエスト当たり$0.002です。

活用例

航法用ワークシートを作成

公開されている収束角と偏角を、方眼・真・磁気方位用の明確な補正量に変換します。

測量計算を確認

現場または事務所の処理で、方位角の北基準を変える際に正しい符号が使われているか確認します。

地図ソフトウェアを構築

決定論的な変換定数を生成し、入力角度と符号規約を結果とともに保存します。

よくある質問

グリッド偏角とは何ですか？

ここでは方眼北から磁北への符号付き角度です。東を正とすると、磁気偏角からグリッド収束角を引いた値になります。

どの符号規約を使用しますか？

時計回りまたは東向きが正、西向きが負です。名前で示された補正量を元の方位に加算します。

方眼方位を磁気方位へ変換する方法は？

方眼方位にgrid_to_magnetic_offset_degを加え、その結果をご希望の範囲へ正規化してください。

座標から収束角や磁気偏角を計算しますか？

いいえ。既知の値を組み合わせます。収束角は該当する投影法から、磁気偏角は正しい場所と日付に対応する資料から取得してください。

APIリクエストの料金はいくらですか？

APIリクエストは1回$0.002です。決定論的なローカル演算だけを使うため、ブラウザーでも無料で実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/grid-to-geographic-offset

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

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

curl -X POST https://api.kit.forhosting.com/geo/grid-to-geographic-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}'

const res = await fetch("https://api.kit.forhosting.com/geo/grid-to-geographic-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grid_convergence_deg": 2.25,
    "magnetic_declination_deg": 7.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/grid-to-geographic-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grid_convergence_deg": 2.25,
    "magnetic_declination_deg": 7.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/grid-to-geographic-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/grid-to-geographic-offset", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "grid_convergence_deg": 2.25,
  "magnetic_declination_deg": 7.5
}

レスポンス例

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