letturl / satelitetracker Goto Github PK

SateliteTracker
===============

A project for Web API to predict a satelite orbit.
	RESOURCE USAGE: 
		The OrbitTools Libraries 
		URL: http://www.zeptomoby.com/satellites/
		LICENSE: "free of charge for non-commercial applications only")

Plan, Description: http://tsujimotter.info/2013/01/02/iss-api/

Web API example (JSONP script): http://tsujimotter.info/api/SateliteTracker/orbitjsonp.cgi?callback=jsonp 

Created by Junpei Tsuji (@tsujimotter, [email protected]), 2013/1/1

=================================================================

* ISS 軌跡情報API (2013/1/4 現在)


* リクエストURL (Request URL)
JSONP: http://tsujimotter.info/api/SateliteTracker/orbitjsonp.cgi



* リクエストパラメータ (未実装含む) (Request Query Parameters)

 パラメータ 	| 値 		| 説明
 (parameters)	| (value)	| (description)
-------------------------------------------------------------------------------------------
(+ appid)	| string	| アプリケーションID (未実装)
 + callback	| string	| JSONPとして出力する際のコールバック関数名を
		|		| 入力するためのパラメータ。
		|		| UTF-8でエンコードされた文字列を入力する。
 + tleid	| string	| 計算の入力に使われるTLEのIDを
		|		| 入力するためのパラメータ。
		|		| UTF-8でエンコードされた文字列を入力する。
		|		| http://tsujimotter.info/api/SateliteTracker/tle/iss20130102.tle
		|		| を入力する場合 "tleid=iss20130102" とする。
		|		| デフォルトは "tleid=iss"
(+ offset) 	| double 	| 現在時刻からどれだけの時間後方にずらした
		| 		| データを取得するか指定するパラメータ。
		|		| (単位: minites) (未実装)
(+ termination)	| double	| データ開始時刻からどれだけの時間後方までの
		| 		| データを取得するか指定するパラメータ。
		|		| (単位: minites) (未実装)
(+ intervals)	| double 	| データの取得間隔 (単位: mitutes) (未実装)
(+ method)	| string	| 軌道データの予測方式 ("SGP4", "SDP4") (未実装)

実行例  (example of a request query. ):
http://tsujimotter.info/api/SateliteTracker/orbitjsonp.cgi?callback=jsonp&appid=XXXXXXXXXXXXXXX&offset=120.0&intervals=0.2



* レスポンスフィールド (未実装含む) (Response JSONP fields)
JSONP形式で返される。

 フィールド	 (fields)	| 説明 (description)
---------------------------------------------------------------------------------------------
+ sateliteName			| 衛星名 (ISSの場合: "GOSAT (ISS)")
+ currentDate   		| APIアクセス時の日付・時刻 ("YYYY-MM-DD HH:mm:ss")
+ intervalMinutes		| 軌道データの取得間隔 (単位: minutes)
+ dataNum			| 総軌道データ数
+ tleLine1			| 予測の基となったTLE (2行軌道要素形式)　の 1行目
+ tleLine2			| 予測の基となったTLE (2行軌道要素形式)　の 2行目
+ algorithm			| 軌道データの予測方式 ("SGP4", "SDP4")
+ library			| 計算に用いた C++ のライブラリ 
				| (OrbitTools "http://www.zeptomoby.com/satellites/")
+ orbits 			| 予測軌道データの配列. 下記3項目からなる. 
				| 配列のデータ数は dataNum フィールドに一致
+ orbits[i].date		| 軌道データの予測時刻 ("YYYY-MM-DD HH:mm:ss")
+ orbits[i].latitude		| 予測軌道の座標 
				| 緯度. 単位: degree [-90.0<x<90.0] 
				| 値が正のとき 北緯, 負のとき 南緯.
+ orbits[i].longitude		| 予測軌道の座標 
				| 経度. 単位: degree [0<x<360.0] 
				| 値が 180.0 より小さい時      東経, 
				| 180.0 より大きい時 360.0-xが 西経.
+ orbits[i].altitude		| 予測軌道の高度 
				| 単位: km 


レスポンステキスト例 (example of a response text. ):
---------------------------------------------------------------------------------------------
jsonp.handler({
	"sateliteName" : "GOSAT (ISS)",
	"currentDate" : "2013-01-05 04:42:20",
	"intervalMinutes" : "0.2",
	"dataNum" : "5",
	"tleLine1" : "1 25544U 98067A   13001.52012361  .00016717  00000-0  10270-3 0  9002",
	"tleLine2" : "2 25544  51.6441 216.2888 0015668 109.9671 250.3170 15.51850049  8742",
	"algorithm" : "SGP4",
	"library" : "OrbitTools (http://www.zeptomoby.com/satellites/)",
	"orbits" : [
		{"date" : "2013-01-05 04:42:20", 
			"latitude" : "51.633563", 
			"longitude" : "255.983587", 
			"altitude" : "407.859503" },
		{"date" : "2013-01-05 04:42:32", 
			"latitude" : "51.560441", 
			"longitude" : "257.177805", 
			"altitude" : "407.775546" },
		{"date" : "2013-01-05 04:42:44", 
			"latitude" : "51.474186", 
			"longitude" : "258.367712", 
			"altitude" : "407.690333" },
		{"date" : "2013-01-05 04:42:56", 
			"latitude" : "51.374887", 
			"longitude" : "259.552628", 
			"altitude" : "407.603894" },
		{"date" : "2013-01-05 04:43:08", 
			"latitude" : "51.262644", 
			"longitude" : "260.731897", 
			"altitude" : "407.516262" }
	]
})