Overflight Services

Regional Overflight

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.

API Paths
overflight/sgp4
overflight/pointToPoint
overflight/simpleFlight
overflight/greatArc
HTTP Method
POST
Input Format
{
    "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",...]
}
Notes:
Path
JSON object defining the location point(s) on which overflight will be calculated.
IncludePath
If true, the results will include the path of the object during the country or region overflight times.
Regions
An array of user-defined regions, each of which includes points defining the boundary for the region, and a name for the region. Optional.
CountryIDs
An array of country code strings. Country codes are defined here. Optional.
Input Sample

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
}
Output Sample

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"
        }]
    }
]