ForHosting KIT · 開発者向けツール

度・小数分をDMSへ変換

度・小数分で表す座標は、十進度と度分秒の中間に位置する形式です。この変換ツールは、整数の度、小数分、半球記号を受け取り、小数分を整数分と秒に分解します。正規化したDMS、座標軸、符号、整形済み座標、確認用の符号付き十進度を返します。計算は常に決まった結果になり、緯度と経度の地理的な上限も検証します。そのため、GPS記録、測量資料、航法の演習、座標データを自動整形する処理に安心してご利用いただけます。

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

無料で実行 API仕様を見る

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

小数分を秒へ分解する方法

度・小数分は一般にDDMと略され、度を整数のまま保ちながら、分を小数で表します。度分秒へ変換する際は、度をそのまま使い、decimal_minutesの整数部分をDMSの分とし、残った小数部分を60倍して秒を求めます。たとえば26.78分には、整数の26分が含まれています。残りの0.78分を60倍すると46.8秒になるため、元の度、26分、46.8秒と指定された半球記号が結果になります。このツールは、浮動小数点計算で生じる微小な誤差がJSONに現れないよう、秒を小数点以下6桁に丸めます。丸めた秒がちょうど60になった場合は1分へ繰り上げ、分も60になった場合は1度へ繰り上げます。したがって、正常な結果に60秒や60分という無効な成分は残りません。レスポンスには使用した式も含まれるため、授業、テストデータ、移行履歴で計算を確認できます。場所の検索、測地系の変換、地図投影、ジオコーディングは行いません。固定された算術だけで、1つの地理角度の表記形式を変換します。

度・分・半球記号を正しく入力する方法

degreesには0以上の整数を、decimal_minutesには0以上60未満の有限値を指定してください。方向は度のマイナス符号ではなくhemisphereで指定します。NとSは緯度、EとWは経度を示します。この規則により、負の度と西半球記号を同時に指定するような曖昧な入力を防げます。緯度の上限は90度、経度の上限は180度です。極や反子午線の境界を越えないよう、上限ちょうどの度では小数分を0にする必要があります。小文字の半球記号は大文字へ正規化され、それ以外の文字は拒否されます。正常なレスポンスには、整数の度と分、丸めた秒、正規化した半球記号、座標軸、符号、読みやすいDMS文字列、独立確認用のsigned_decimal_degreesが含まれます。南と西は負、北と東は正の確認値になります。ブラウザーとAPIは同じ純粋関数を実行するため、ネットワーク、地域設定、乱数、時刻に左右されず、同じ入力から同じ出力を得られます。APIで正常に処理した1項目の料金は$0.002で、ページ上では手軽な変換を無料でお試しいただけます。

実務でDDMからDMSへの変換を活用する方法

DDMは、携帯GPS受信機、野外ノート、海上のウェイポイント、航空資料、整数分より高い精度を必要としながら秒の欄を設けない帳票などで使われます。一方、DMSは公開座標、測量記述、学習問題、人が読む報告書で今も一般的なため、両形式の変換は日常的な標準化作業です。現地データを処理する場合は、元のDDM値と返されたDMS成分を一緒に保存してください。確認担当者が分解を再現でき、単なる書式変更と測定位置の変更を区別できます。表計算データを移行する際は、緯度と経度を別々に呼び出し、各行で適切な半球記号を維持してください。学習用途では、返された秒を「小数分×60」の手計算と比較し、signed_decimal_degreesを使って方位と符号の関係を確認できます。このツールが1項目で処理するのは1つの角度だけです。自由形式の緯度経度ペアを解析せず、半球を推測せず、測地系を変換せず、地名を座標化しません。大量取り込みの前に、北緯90度・0分の境界例と、60分を指定した無効例をテストしてください。これにより、入力列が十進度、小数分、秒を取り違えていないか確認できます。決定的な出力は、固定テスト、監査記録、再現可能なETLに適しており、正常なAPIリクエスト1件の料金は$0.002です。

活用例

携帯GPSの記録を標準化

現地で記録したDDM地点を標準DMS成分へ変換し、報告書や共有座標一覧に利用できます。

測量・航法資料を作成

小数分を秒へ分け、緯度または経度に対応する半球記号を正しく維持します。

座標変換の課題を確認

手計算を、常に同じ結果となる分、秒、符号、確認用十進度と比較できます。

よくある質問

小数分はどのように秒へ変換しますか？

整数分を取り除いた小数部分を60倍します。26.78分の場合、0.78×60で46.8秒です。

小数分に60を指定できますか？

いいえ。0以上60未満で指定してください。60分は度へ繰り上げる必要があります。

南緯や西経では度を負にしますか？

いいえ。度は0以上の整数とし、半球にSまたはWを指定してください。signed_decimal_degreesは負で返ります。

秒はどのように丸められますか？

秒は常に小数点以下6桁へ丸めます。結果が60になった場合は次の1分へ繰り上げます。

変換料金はいくらですか？

ブラウザー版は無料です。APIでは正常な1項目を、公開基本料金$0.002で処理します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/ddm-to-dms

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

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

curl -X POST https://api.kit.forhosting.com/geo/ddm-to-dms \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"degrees":40,"decimal_minutes":26.78,"hemisphere":"N"}'

const res = await fetch("https://api.kit.forhosting.com/geo/ddm-to-dms", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "degrees": 40,
    "decimal_minutes": 26.78,
    "hemisphere": "N"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/ddm-to-dms",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "degrees": 40,
    "decimal_minutes": 26.78,
    "hemisphere": "N"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/ddm-to-dms", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"degrees":40,"decimal_minutes":26.78,"hemisphere":"N"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"degrees":40,"decimal_minutes":26.78,"hemisphere":"N"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/ddm-to-dms", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "degrees": 40,
  "decimal_minutes": 26.78,
  "hemisphere": "N"
}

レスポンス例

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