地殻変動補正計算 API 機能説明
1 機能一覧
機能補正計算仕様

1 点計算

１点毎に座標値および計算条件等を指定したパラメータを送信(GET)することで補正結果が JSON 形式で出力される。

一括計算

入力ファイル等を指定したパラメータを送信(POST)することで補正結果のファイルの内容が出力される。

2 機能説明2.1 1 点計算
（１）
URL
https://positions.gsi.go.jp/cdcs/api/calc_one?[パラメータ指定]（２）
リクエスト(GET)
ブラウザのアドレスバーにパラメータを付与した URL を入力する。
(例)
https://positions.gsi.go.jp/cdcs/api/calc_one?
UserId=UserId&Password=Password&CalcDirection=1&InputXLat=165381.2527&InputYLon=12559
4.8204&InputZHeight=2.34&ZoneNum=8&ObservationDate=2020-0601&ParamType=geonetF3&CoordinateType=Planar
項目

パラメータ名説明

ログイン ID

UserId

国土地理院のアカウントのユーザーID

パスワード

Password

国土地理院のアカウントのパスワード
1：測位結果を国家座標に合わせる

補正の内容

CalcDirection(2：地図で指定した国家座標を測位に合わせる)
3：国家座標を測位に合わせる

緯度(X 座標)

InputXLat

緯度(X 座標)を入力する。

経度(Y 座標)

InputYLon

経度(Y 座標)を入力する。

高さ(Z 座標)

InputZHeight

高さ(Z 座標)を入力する。

系番号

ZoneNum

系番号 1～19 を指定する。※平面直角座標のみ必要

測位実施日

ObservationDate

測位実施日を入力する。

パラメータ種別

ParamTypegeonetF3 or ITRF2014

座標種類

CoordinateType

DMS

：度分秒

D：度単位

Planar：平面直角座標

Geocentric：地心直交座標

1（３）

レスポンス

項目

パラメータ名説明パラメータファイル名

ParamFile

パラメータファイル名が返る。

パラメータファイルバージョン

ParamFileVer

パラメータファイルバージョンが返る。

システム情報Program

システム名、バージョンが返る。

補正方向

CalcDirection

補正方向が返る。

測位実施日

ObservationDate

測位実施日が返る。

測位(今期)の測地基準系

PositioningDatum

測位(今期)の測地基準系が返る。

座標種類

CoordinateType

座標種類が返る。

系番号

ZoneNum

平面直角座標の系番号が返る。

緯度(X 座標)

InputXLat

緯度(X 座標)が返る。

経度(Y 座標)

InputYLon

経度(Y 座標)が返る。

高さ(Z 座標)

InputZHeight

高さ(Z 座標)が返る。

補正後の緯度(X 座標)

ResultXLat

補正後の緯度(X 座標)が返る。

補正後の経度(Y 座標)

ResultYLon

補正後の緯度(Y 座標)が返る。

補正後の高さ(Z 座標)

ResultZHeight

補正後の緯度(Z 座標)が返る。

補正量 dB(補正量 dX)

Delta1

補正量 dB(補正量 dX)が返る。

補正量 dL(補正量 dY)

Delta2

補正量 dL(補正量 dY)が返る。

補正量 dH(補正量 dZ)

Delta3

補正量 dH(補正量 dZ)が返る。

22.2 1 点計算(NMEA)（１）
URL
https://positions.gsi.go.jp/cdcs/api/calc_one?[パラメータ指定]（２）
リクエスト(GET)
ブラウザのアドレスバーにパラメータを付与した URL を入力する。
(例)
http://positions.gsi.go.jp /cdcs/api/calc_one? UserId=UserId&Password=Password&CalcDir
ection=ToPos&ObservationDate=010620&ParamType=geonetF3&NmeaMsgType=gga&NmeaSente
nce=$GPGGA,022842.00,3729.69442,N,13955.78692,E,5,06,2.7,220.3627,M,39.01651,M,2.0,0000*75&OutputType=2
項目

パラメータ名説明

ログイン ID

UserId

国土地理院のアカウントのユーザーID

パスワード

Password

国土地理院のアカウントのパスワード

補正方向

CalcDirection

ToPos or ToJGD 空欄の場合、ToJGD となる。
測位実施日(ddmmyy 形式)を入力する。空欄の場合、
NMEA
メッセージタイプによって以下のように入力される。

測位実施日

ObservationDate

基準座標系

ParamTypegeonetF3 or ITRF2014 空欄の場合、geonetF3 となる。

NMEA メッセージタイプ

NmeaMsgType

gga or rmc

NMEA センテンス

NmeaSentence

NMEA メッセージタイプと同形式の NMEA センテンス

gga：リクエスト日rmc：NEMA センテンスの日付

出力レイアウトの変更
0：補正内容、測位実施日、NMEA センテンス(補正結果)
出力内容

OutputType

1：補正内容、測位実施日、補正量(緯度・経度・高さ)
2：補正内容、測位実施日、NMEA センテンス(補正結果)、補正量(緯度、経度、高さ)

3

（３）

レスポンス

項目
パラメータファイル名
パラメータファイル
バージョン

パラメータ名ParamFile
ParamFileVer

説明
パラメータファイル名が返る。
パラメータファイルバージョンが返る。

システム情報Program

システム名、バージョンが返る。

補正方向

CalcDirection

補正方向が返る。

測位実施日

ObservationDate

測位実施日が返る。

測位(今期)の測地基準系

PositioningDatum

測位(今期)の測地基準系が返る。

NMEA センテンス(補正結果)

ResultNMEA センテンス(補正結果)が返る。

緯度方向の補正量

DB

緯度方向の補正量が返る。

経度方向の補正量

DL

経度方向の補正量が返る。

高さ方向の補正量DH

高さ方向の補正量が返る。

42.3 一括計算
（１）
URL
https://positions.gsi.go.jp/cdcs/api/calc_mult?[パラメータ指定]（２）
リクエスト(POST)
POST 送信ができるツール(Advanced REST client)を使用した例

項目

パラメータ名説明

ログイン ID

UserId

国土地理院のアカウントのユーザーID

パスワード

Password

国土地理院のアカウントのパスワード

パラメータ種別

ParamTypegeonetF3 or ITRF2014

エンコードフラグ

EncodeFlg

0,未指定：エンコード有、1：エンコード無入力ファイル

InputFile

入力ファイルを選択する。

5

（３）

レスポンス(『EncodeFlg』が指定なし、または、0)

項目

パラメータ名説明

パラメータファイル名

ParamFile

パラメータファイル名が返る。

パラメータファイルバージョン

ParamFileVer

パラメータファイルバージョンが返る。

入力ファイル

InFile

入力ファイル名が返る。

システム情報Program

システム名、バージョンが返る。

補正方向CalcDirection

補正方向が返る。

計算結果

OutFile

計算結果(エンコード有)Base64 デコード

②

①

③

④

⑤

⑥
項目
計算結果

パラメータ名OutFile

説明
補正結果のファイルの内容が返る。
Base64 デコードすることで内容を確認できる。

データ部
No

説明

①

入力値：緯度(X 座標)、経度(Y 座標)、高さ(Z 座標)、系番号(平面直角座標のみ)②

出力値：補正後の緯度(X 座標)、補正後の経度(Y 座標)、補正後の高さ(Z 座標)、系番号(平面直角座標のみ)③

出力値：補正量 dB(補正量 dX)、補正量 dL(補正量 dY)、補正量 dH(補正量 dZ)④

コメント：#から始まる文はコメントとして扱う⑤

データ部に数値以外の不正な文字が存在した場合にエラー行として出力される。

⑥

計算エラーが発生した場合に出力される。

6

（４）

レスポンス(『EncodeFlg』が 1)

7

項目

パラメータ名説明

パラメータファイル名

ParamFile

パラメータファイル名が返る。

パラメータファイルバージョンParamFileVer

パラメータファイルバージョンが返る。

入力ファイル

InFile

入力ファイル名が返る。

システム情報Program

システム名、バージョンが返る。

補正方向

CalcDirection

補正方向が返る。

測位実施日

ObservationDate

測位実施日が返る。

測位(今期)の測地基準系

PositioningDatum

測位(今期)の測地基準系が返る。

座標種類

CoordinateType

座標種類が返る。

水平座標単位Unit

水平座標単位が返る。

高さ座標単位

AltUnit

高さ座標単位が返る。

計算結果

Result

計算結果

入力値(X 座標,緯度)InputXLat

入力値(X 座標,緯度)が返る。

入力値(Y 座標,経度)

InputYLon

入力値(Y 座標,経度)が返る。

入力値(Z 座標,高さ)

InputZHeight

入力値(Z 座標,高さ)が返る。

系番号

ZoneNum

系番号が返る。

計算結果(X 座標,緯度)ResultXLat

計算結果(X 座標,緯度)が返る。

計算結果(Y 座標,経度)

ResultYLon

計算結果(Y 座標,経度)が返る。

計算結果(Z 座標,高さ)

ResultZHeight

計算結果(Z 座標,高さ)が返る。

補正量(dX,dB)

DeltaXLat

補正量(dX,dB)が返る。

補正量(dY,dL)

DeltaYLon

補正量(dY,dL)が返る。

補正量(dZ,dH)

DeltaZHeight

補正量(dZ,dH)が返る。

コメント

Comment

コメントがある場合は、コメントが返る。

エラーメッセージ

Error

エラー発生時、エラーメッセージが返る。

8

2.4 一括計算(NMEA)（１）
URL
https://positions.gsi.go.jp/cdcs/api/calc_mult?[パラメータ指定]（２）
リクエスト(POST)
POST 送信ができるツール(Advanced REST client)を使用した例

項目

パラメータ名説明

ログイン ID

UserId

国土地理院のアカウントのユーザーID

パスワードPassword

国土地理院のアカウントのパスワード

補正方向

CalcDirection

ToPos or ToJGD

空欄の場合、ToJGD となる。

測位実施日(ddmmyy 形式)を入力する。空欄の場合、以下のようになる。
RMC メッセージが含まれる ：RMC メッセージの日付
RMC メッセージが含まれない：リクエスト日
測位実施日

ObservationDate※GGA メッセージの補正は、以下のようになる。
RMC メッセージの間に GGA メッセージがある：直前のRMC メッセージの日付
最初の RMC メッセージ前に GGA メッセージがある：最初の RMC メッセージの日付

基準座標系

ParamTypegeonetF3 or ITRF2014 空欄の場合、geonetF3 となる。

エンコードフラグ

EncodeFlg

0,未指定：エンコード有、1：エンコード無入力ファイル

InputFile

入力ファイルを選択する。

9

（３）

レスポンス(『EncodeFlg』が指定なし、または、0)aa

パラメータ名説明パラメータファイル名ParamFile

パラメータファイル名が返る。

パラメータファイルバージョン

ParamFileVer

パラメータファイルバージョンが返る。

入力ファイル名

InFile

入力ファイル名が返る。

システム情報Program

システム名、バージョンが返る。

補正方向

CalcDirection

補正方向が返る。

測位実施日

ObservationDate

測位実施日が返る。

計算結果

OutFileBase64 でエンコードされた補正結果ファイルが返る。

Base64 デコード
①

②
項目
計算結果

パラメータ名OutFile

説明
補正結果のファイルの内容が返る。
Base64 デコードすることで内容を確認できる。

データ部
No

説明

①

NMEA センテンスの補正結果②

計算エラーが発生した場合に出力される。

10

（４）

レスポンス(『EncodeFlg』が 1)

項目

パラメータ名説明

パラメータファイル名

ParamFile

パラメータファイル名が返る。

パラメータファイルバージョン

ParamFileVer

パラメータファイルバージョンが返る。

入力ファイル名

InFile

入力ファイル名が返る。

システム情報Program

システム名、バージョンが返る。

補正方向

CalcDirection補正方向が返る。

測位実施日

ObservationDate

測位実施日が返る。

測位(今期)の測地基準系

PositioningDatum

測位(今期)の測地基準系が返る。

計算結果

Result

計算結果

NMEA センテンス

NmeaSentence

コメント

Commet

エラーメッセージ

Error

NMEA センテンス(補正結果)が返る。
コメントがある場合、コメントが返る。
※NMEA センテンス後のコメントは計算時に削除
エラー発生時、エラーメッセージが返る。

11