SDSP SERVICES
The regional overflight service returns regions which are overflown by a satellite or aircraft. Regions can be either country borders or user defined regional boundaries. This service can be used to determine which of all the countries are overflown, or which are overflown from a specified set, including user-defined regions.
The service returns the country or region overflown, with the times of entry and exit and optionally, the object's path while over the country or region.
Country IDs used in this service are found here.
{
"Path": {},
"IncludePath": true,
"Regions":
[{
"Name":"Region1",
"Positions":
[
{"Latitude":39.000000,"Longitude":-104.770000,"Altitude":0.0},
{"Latitude":39.019731,"Longitude":-104.789370,"Altitude":0.0},
{"Latitude":39.228765,"Longitude":-104.634980,"Altitude":0.0},
...,
]
},
{
"Name":"Region2",
"Positions":
[
{"Latitude":39.000000,"Longitude":-104.770000,"Altitude":0.0},
{"Latitude":39.019731,"Longitude":-104.789370,"Altitude":0.0},
{"Latitude":39.228765,"Longitude":-104.634980,"Altitude":0.0},
...,
]
},
...,
]
"CountryIds": ["CT1","CT2",...]
}
Determines all countries overflown by the ISS in 30 minutes, returning path data as cartesians in the Earth-Fixed frame
{
"Path": {
"Start": "2014-02-10T00:00:00",
"Stop": "2014-02-10T00:30:00",
"SSC": 25544,
"OutputSettings": {
"Step": 300,
"TimeFormat": "UTC",
"CoordinateFormat": {
"Coord": "XYZ",
"Frame": "Fixed"
}
}
},
"IncludePath": true
}
Note that path data is not returned if the time over the country or region is less than the step in the OutputSettings.
[
{
"CountryId": "USA",
"Name": "United States",
"Entry": {
"Position": {
"X": 451211.61291815806,
"Y": -5040730.157393117,
"Z": 4522633.583559763
},
"SensorStates": [],
"Time": "2014-02-10T00:00:00.0000000Z"
},
"Exit": {
"Position": {
"X": 664776.3181581937,
"Y": -4911615.16783213,
"Z": 4636463.043620629
},
"SensorStates": [],
"Time": "2014-02-10T00:00:37.2620753Z"
},
"Path": [ {
"Position": {
"X": 451211.61291815713,
"Y": -5040730.157393117,
"Z": 4522633.583559761
},
"SensorStates": [],
"Time": "2014-02-10T00:00:00.0000000Z"
}]
},
{
"CountryId": "CAN",
"Name": "Canada",
"Entry": {
"Position": {
"X": 664787.0902718992,
"Y": -4911608.4594098255,
"Z": 4636468.583941981
},
"SensorStates": [],
"Time": "2014-02-10T00:00:37.2639562Z"
},
"Exit": {
"Position": {
"X": 1574629.121298026,
"Y": -4273578.561593361,
"Z": 5030376.949074198
},
"SensorStates": [],
"Time": "2014-02-10T00:03:17.6357273Z"
},
"Path": []
},
{
"CountryId": "CAN",
"Name": "Canada",
"Entry": {
"Position": {
"X": 1621492.3751215215,
"Y": -4236763.335925284,
"Z": 5046539.138958015
},
"SensorStates": [],
"Time": "2014-02-10T00:03:26.0247205Z"
},
"Exit": {
"Position": {
"X": 1870648.750310144,
"Y": -4034253.540603794,
"Z": 5125338.6261610165
},
"SensorStates": [],
"Time": "2014-02-10T00:04:10.9455096Z"
},
"Path": []
},
{
"CountryId": "CAN",
"Name": "Canada",
"Entry": {
"Position": {
"X": 1957993.7389270533,
"Y": -3960511.0473642545,
"Z": 5150063.110098762
},
"SensorStates": [],
"Time": "2014-02-10T00:04:26.8356505Z"
},
"Exit": {
"Position": {
"X": 2004350.6564108292,
"Y": -3920781.717668061,
"Z": 5162560.141538771
},
"SensorStates": [],
"Time": "2014-02-10T00:04:35.3025390Z"
},
"Path": []
},
{
"CountryId": "CAN",
"Name": "Canada",
"Entry": {
"Position": {
"X": 2326922.7517750347,
"Y": -3632643.6003696253,
"Z": 5237153.044857722
},
"SensorStates": [],
"Time": "2014-02-10T00:05:34.9461141Z"
},
"Exit": {
"Position": {
"X": 2408307.268144484,
"Y": -3556618.787571732,
"Z": 5252444.141452221
},
"SensorStates": [],
"Time": "2014-02-10T00:05:50.2198970Z"
},
"Path": []
},
{
"CountryId": "ESP",
"Name": "Spain",
"Entry": {
"Position": {
"X": 4945388.103284249,
"Y": -163668.41682823002,
"Z": 4643375.9831656385
},
"SensorStates": [],
"Time": "2014-02-10T00:15:41.8703762Z"
},
"Exit": {
"Position": {
"X": 4965091.318495776,
"Y": -123032.88639888866,
"Z": 4623613.132624641
},
"SensorStates": [],
"Time": "2014-02-10T00:15:48.5652648Z"
},
"Path": []
},
{
"CountryId": "ESP",
"Name": "Spain",
"Entry": {
"Position": {
"X": 4970417.768150125,
"Y": -111963.12947385898,
"Z": 4618182.518834168
},
"SensorStates": [],
"Time": "2014-02-10T00:15:50.3893896Z"
},
"Exit": {
"Position": {
"X": 5108794.708577075,
"Y": 189744.713135147,
"Z": 4462421.5483634835
},
"SensorStates": [],
"Time": "2014-02-10T00:16:40.1895016Z"
},
"Path": []
},
{
"CountryId": "TUN",
"Name": "Tunisia",
"Entry": {
"Position": {
"X": 5362744.296517645,
"Y": 843726.7722725302,
"Z": 4072807.9780261926
},
"SensorStates": [],
"Time": "2014-02-10T00:18:29.2224101Z"
},
"Exit": {
"Position": {
"X": 5431628.120712715,
"Y": 1057652.149399204,
"Z": 3929509.053371384
},
"SensorStates": [],
"Time": "2014-02-10T00:19:05.4142051Z"
},
"Path": []
},
{
"CountryId": "LBY",
"Name": "Libya",
"Entry": {
"Position": {
"X": 5545294.714163531,
"Y": 1477669.9063317517,
"Z": 3624375.4602255872
},
"SensorStates": [],
"Time": "2014-02-10T00:20:17.5850057Z"
},
"Exit": {
"Position": {
"X": 5556591.75089069,
"Y": 1526556.0688618694,
"Z": 3586747.249826403
},
"SensorStates": [],
"Time": "2014-02-10T00:20:26.0992307Z"
},
"Path": []
},
{
"CountryId": "LBY",
"Name": "Libya",
"Entry": {
"Position": {
"X": 5579863.872095257,
"Y": 1633585.156662424,
"Z": 3502778.8870242415
},
"SensorStates": [],
"Time": "2014-02-10T00:20:44.8353776Z"
},
"Exit": {
"Position": {
"X": 5690308.953378705,
"Y": 2653570.311730146,
"Z": 2583524.242897287
},
"SensorStates": [],
"Time": "2014-02-10T00:23:52.1422546Z"
},
"Path": []
},
{
"CountryId": "EGY",
"Name": "Egypt",
"Entry": {
"Position": {
"X": 5690308.91694007,
"Y": 2653587.120743675,
"Z": 2583507.138827269
},
"SensorStates": [],
"Time": "2014-02-10T00:23:52.1455094Z"
},
"Exit": {
"Position": {
"X": 5689856.437392841,
"Y": 2706199.222431821,
"Z": 2529620.21229081
},
"SensorStates": [],
"Time": "2014-02-10T00:24:02.3674442Z"
},
"Path": []
},
{
"CountryId": "SDN",
"Name": "Sudan",
"Entry": {
"Position": {
"X": 5689856.280040008,
"Y": 2706209.658919928,
"Z": 2529609.4528065925
},
"SensorStates": [],
"Time": "2014-02-10T00:24:02.3694787Z"
},
"Exit": {
"Position": {
"X": 5505497.730094319,
"Y": 3772440.526964331,
"Z": 1259018.9014119254
},
"SensorStates": [],
"Time": "2014-02-10T00:27:49.4459681Z"
},
"Path": [ {
"Position": {
"X": 5674642.85775013,
"Y": 2995971.0804069843,
"Z": 2219689.384427544
},
"SensorStates": [],
"Time": "2014-02-10T00:25:00.0000000Z"
}]
},
{
"CountryId": "ETH",
"Name": "Ethiopia",
"Entry": {
"Position": {
"X": 5505492.723933691,
"Y": 3772454.2168556326,
"Z": 1258999.9450342555
},
"SensorStates": [],
"Time": "2014-02-10T00:27:49.4492135Z"
},
"Exit": {
"Position": {
"X": 5250413.711135622,
"Y": 4282717.841826335,
"Z": 485537.05958480906
},
"SensorStates": [],
"Time": "2014-02-10T00:30:00.0000000Z"
},
"Path": [ {
"Position": {
"X": 5250413.711135623,
"Y": 4282717.841826336,
"Z": 485537.059584809
},
"SensorStates": [],
"Time": "2014-02-10T00:30:00.0000000Z"
}]
}
]