API使用法APIの説明（全プログラム共通）- APIの説明（全プログラム共通）
- パラメータ名
（全プログラム共通） - 緯度・経度と
地心直交座標の換算 - 距離と方位角の計算
- 距離と方向角の計算
- 平面直角座標
への換算 - 緯度・経度への換算
- 世界測地系座標変換
TKY2JGD - PatchJGD
- PatchJGD(標高版)
- SemiDynaEXE
- ジオイド高
- 重力値推定計算
<はじめに>
以下の測量計算プログラムは全てREST APIの機能をご利用いただけます。①緯度・経度と地心直交座標の相互換算
②距離と方位角の計算
③距離と方向角の計算
④平面直角座標への換算
⑤緯度・経度への換算
⑥世界測地系座標変換(TKY2JGD)
⑦PatchJGD
⑧PatchJGD(標高版)
⑨SemiDynaEXE
⑩ジオイド高
⑪重力値推定計算
このAPIはリモートサーバからのアクセスを受けつけ、リクエストに応じて処理結果をXML形式あるいはJSON形式で出力する機能を有します。
同一IPアドレスからのリクエストは、10秒間で10回（ただしTKY2JGDとPatchJGDは負荷が大きいため10秒間で3回）に設定しています。
<パラメータ引渡方法>
REST API(Representational State Transfer Application Programming Interface)とは、一般のサーバやクライアントから、ある特定の規則に従ってWEBサーバ側でパラメータを受け取り、処理結果をXML形式やJSON形式で応答するAPIのことです。
ある特定の規則とは、「HTTP動詞(GET)を使用して、URLにUTF-8で符号化したパラメータを送信する。」ことになります。
パラメータの引渡し(リクエスト)及び出力(レスポンス)の例は以下の通りです。
【リクエスト(PatchJGDである位置の緯度・経度を補正）】
ある特定の規則とは、「HTTP動詞(GET)を使用して、URLにUTF-8で符号化したパラメータを送信する。」ことになります。
パラメータの引渡し(リクエスト)及び出力(レスポンス)の例は以下の通りです。
【リクエスト(PatchJGDである位置の緯度・経度を補正）】
http://vldb.gsi.go.jp/sokuchi/surveycalc/patchjgd/patchjgd.php?sokuchi=0&chiiki=tokachi2003.par&Place=0&latitude=42.55303010&longitude=143.14591010&outputType=xml
【レスポンス(PatchJGDである位置の緯度・経度を補正）】
<参考：APIの提供開始について>
測量計算APIで予め共通定義されているパラメータ名は以下のとおりです。
各プログラムで処理要求を受け付け、処理結果を応答する際に使用するパラメータ名も、この共通定義されたパラメータに準拠しています。
また、これらのパラメータ名は、XMLおよびJSON出力時のTAG名として出力されます。
■共通定義のパラメータ詳細
各プログラムで処理要求を受け付け、処理結果を応答する際に使用するパラメータ名も、この共通定義されたパラメータに準拠しています。
また、これらのパラメータ名は、XMLおよびJSON出力時のTAG名として出力されます。
■共通定義のパラメータ詳細
| No. | 共通パラメータ名 | 説明 |
| 1 | longitude | 経度(degree) |
| 2 | latitude | 緯度(degree) |
| 3 | publicX | 平面直角座標系のX座標(m) |
| 4 | publicY | 平面直角座標系のY座標(m) |
| 5 | zone | 平面直角座標系の系番号(1〜19) |
| 6 | altitude | 標高(m) |
| 7 | ellipsoidHeight | 楕円体高(m) |
| 8 | geoidHeight | ジオイド高(m) |
| 9 | geocentricX | 地心直交座標系のX座標(m) |
| 10 | geocentricY | 地心直交座標系のY座標(m) |
| 11 | geocentricZ | 地心直交座標系のZ座標(m) |
| 12 | ellipsoid | 楕円体(GRS80 or Bessel) |
| 13 | gridBearing | 方向角(degree) |
| 14 | azimuth | 方位角(degree) |
| 15 | gridConv | 真北方向角(degree) |
| 16 | geoLength | 測地線長(m) |
| 17 | refFrame | 測地系 |
| 18 | coordinateSystem | 座標系 |
| 19 | scaleFactor | 縮尺係数 |
「緯度・経度と地心直交座標の相互換算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/trans.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
▲：緯度・経度から地心直交座標に換算する場合、必須
△：地心直交座標から緯度・経度に換算する場合、必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/trans.pl?[パラメータの指定]
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 変換方法 | cnv_type | =0[地心直交座標を求める]
=1[緯度・経度・楕円体高を求める] |
| ▲ | 緯度 | latitude | degree |
| ▲ | 経度 | longitude | degree |
| ▲ | 標高 | altitude | 小数点以下３桁まで指定可(m) |
| ▲ | ジオイド高 | geoidHeight | 小数点以下３桁まで指定可(m) |
| △ | Ｘ座標（地心直交座標） | geocentricX | 小数点以下３桁まで指定可(m) |
| △ | Ｙ座標（地心直交座標） | geocentricY | 小数点以下３桁まで指定可(m) |
| △ | Ｚ座標（地心直交座標） | geocentricZ | 小数点以下３桁まで指定可(m) |
※●：毎回必須
▲：緯度・経度から地心直交座標に換算する場合、必須
△：地心直交座標から緯度・経度に換算する場合、必須
「距離と方位角の計算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/bl2st_calc.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
※距離が0の場合(出発点と到着点が一致する場合)、出力される距離(geoLength)は空の文字列となりますので、ご注意ください。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/bl2st_calc.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 楕円体 | ellipsoid | =GRS80[世界測地系で計算する]
=bessel[日本測地系で計算する] |
| ● | 出発点緯度 | latitude1 | degree |
| ● | 出発点経度 | longitude1 | degree |
| ● | 到着点緯度 | latitude2 | degree |
| ● | 到着点経度 | longitude2 | degree |
※●：毎回必須
※距離が0の場合(出発点と到着点が一致する場合)、出力される距離(geoLength)は空の文字列となりますので、ご注意ください。
「距離と方向角の計算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/xy2st.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/xy2st.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 測地系 | refFrame | =1[日本測地系]
=2[世界測地系] |
| ● | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| ● | 出発点Ｘ座標 | publicX1 | 小数点以下３桁まで指定可(m) |
| ● | 出発点Ｙ座標 | publicY1 | 小数点以下３桁まで指定可(m) |
| ● | 到着点Ｘ座標 | publicX2 | 小数点以下３桁まで指定可(m) |
| ● | 到着点Ｙ座標 | publicY2 | 小数点以下３桁まで指定可(m) |
※●：毎回必須
「平面直角座標への換算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/bl2xy.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/bl2xy.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 測地系 | refFrame | =1[日本測地系]
=2[世界測地系] |
| ● | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| ● | 緯度 | latitude | degree |
| ● | 経度 | longitude | degree |
※●：毎回必須
「緯度・経度への換算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/xy2bl.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/surveycalc/xy2bl.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 測地系 | refFrame | =1[日本測地系]
=2[世界測地系] |
| ● | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| ● | Ｘ座標 | publicX | 小数点以下３桁まで指定可(m) |
| ● | Ｙ座標 | publicY | 小数点以下３桁まで指定可(m) |
※●：毎回必須
「世界測地系座標変換（TKY2JGD）」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/tky2jgd/tky2jgd.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
▲：緯度・経度で変換する場合、必須
△：平面直角座標で変換する場合、必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/tky2jgd/tky2jgd.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 変換方向 | sokuti | =1[日本測地系→世界測地系]
=2[世界測地系→日本測地系] |
| ● | 変換方法 | Place | =1[緯度・経度で変換する]
=2[平面直角座標で変換する] |
| ▲ | 緯度 | latitude | degree |
| ▲ | 経度 | longitude | degree |
| △ | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| △ | Ｘ座標 | publicX | 小数点以下３桁まで指定可(m) |
| △ | Ｙ座標 | publicY | 小数点以下３桁まで指定可(m) |
※●：毎回必須
▲：緯度・経度で変換する場合、必須
△：平面直角座標で変換する場合、必須
「PatchJGD」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/patchjgd/patchjgd.php?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/patchjgd/patchjgd.php?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 補正パラメータファイル | chiiki | =パラメータファイル名(*.par) |
| ● | 補正方向 | sokuchi | =0[順方向の補正]
=1[逆方向の補正] |
| ● | 補正方法 | Place | =0[緯度・経度で補正する]
=1[平面直角座標で補正する] |
| ▲ | 緯度 | latitude | 小数点以下８桁まで指定可(degree) |
| ▲ | 経度 | longitude | 小数点以下８桁まで指定可(degree) |
| △ | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| △ | Ｘ座標 | publicX | 小数点以下３桁まで指定可(m) |
| △ | Ｙ座標 | publicY | 小数点以下３桁まで指定可(m) |
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
「PatchJGD（標高版）」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/patchjgd_h/patchjgd.php?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/patchjgd_h/patchjgd.php?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 補正パラメータファイル | chiiki | =パラメータファイル名(*.par) |
| ● | 補正方向 | sokuchi | =0[順方向の補正]
=1[逆方向の補正] |
| ● | 補正方法 | Place | =0[緯度・経度で補正する]
=1[平面直角座標で補正する] |
| ▲ | 緯度 | latitude | 小数点以下８桁まで指定可(degree) |
| ▲ | 経度 | longitude | 小数点以下８桁まで指定可(degree) |
| ▲ | 標高 | altitude1 | 小数点以下３桁まで指定可(m) |
| △ | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| △ | Ｘ座標 | publicX | 小数点以下３桁まで指定可(m) |
| △ | Ｙ座標 | publicY | 小数点以下３桁まで指定可(m) |
| △ | 標高 | altitude2 | 小数点以下３桁まで指定可(m) |
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
「SemiDynaEXE」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/semidyna/web/semidyna_r.php?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/semidyna/web/semidyna_r.php?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 補正パラメータファイル | chiiki | =パラメータファイル名(*.par) |
| ● | 補正方向 | sokuchi | =0[元期→今期]
=1[今期→元期] |
| ● | 座標値の入力 | Place | =0[緯度・経度]
=1[平面直角座標系] |
| ● | 補正方法 | Hosei_J | =2[二次元補正]
=3[三次元補正] |
| ▲ | 緯度 | latitude | 小数点以下８桁まで指定可(degree) |
| ▲ | 経度 | longitude | 小数点以下８桁まで指定可(degree) |
| ▲ | 標高 | altitude1 | 小数点以下３桁まで指定可(m) |
| △ | 系番号(平面直角座標系) | zone | 系番号1〜19を指定する |
| △ | Ｘ座標 | publicX | 小数点以下３桁まで指定可(m) |
| △ | Ｙ座標 | publicY | 小数点以下３桁まで指定可(m) |
| △ | 標高 | altitude2 | 小数点以下３桁まで指定可(m) |
※●：毎回必須
▲：緯度・経度で補正する場合、必須
△：平面直角座標で補正する場合、必須
「ジオイド高」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/geoid/calcgh/cgi/geoidcalc.pl?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
■URL指定方法
http://vldb.gsi.go.jp/sokuchi/surveycalc/geoid/calcgh/cgi/geoidcalc.pl?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 出力タイプ | outputType | =xml[XML形式] =json[JSON形式] |
| ● | 緯度 | latitude | 小数点以下８桁まで指定可(degree) |
| ● | 経度 | longitude | 小数点以下８桁まで指定可(degree) |
※●：毎回必須
「重力値推定計算」のAPIを使用するためのURL指定方法、パラメータ文字列は以下のとおりです。出力はJSON形式です。
■URL指定方法
https://vldb.gsi.go.jp/sokuchi/gsigra/calc/api/gravityCalculation?[パラメータの指定]
■パラメータの詳細
※●：毎回必須
■URL指定方法
https://vldb.gsi.go.jp/sokuchi/gsigra/calc/api/gravityCalculation?[パラメータの指定]
■パラメータの詳細
| 項目 | パラメータ名 | 説明 | |
| ● | 緯度・経度の単位 | unit | =DMS[度分秒] =decimal[十進度] |
| ● | 緯度 | lat | DMSの場合は小数点以下4桁、decimalの場合は小数点以下8桁まで指定可 |
| ● | 経度 | lon | DMSの場合は小数点以下4桁、decimalの場合は小数点以下8桁まで指定可 |
| ● | 地表からの高さ | dH | ｍ単位で小数点以下1桁まで指定可 |
※●：毎回必須
国土地理院 (C) 2013- Geospatial Information Authority of Japan. All rights reserved.