Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
150 lines (140 sloc) 5.66 KB

Positions

This endpoint will return the position of Solar System bodies for a given range of dates, for the given Earth coordinates.

GET /positions 

The following parameters are required to be sent in the request.

Observer Parameters

Date Range Parameters

Sample Response

{
    "data": {
        "dates": {
            "from": "2016-12-20T00:00:00",
            "list": [
                "2016-12-20T00:00:00"
            ],
            "to": "2016-12-20T23:59:59"
        },
        "observer": {
            "geo": {
                "lat": "33.775867",
                "lon": "-84.39733"
            }
        },
        "rows": [
            {
                "columns": [
                    {
                        "date": "2016-12-20T00:00:00",
                        "dist": {
                            "earth": {
                                "au": 0.98382376714112019,
                                "km": 147177940.70836419
                            },
                            "sun": {
                                "au": 0,
                                "km": 0
                            }
                        },
                        "id": "sun",
                        "meta": {
                            "elong": 0,
                            "mag": -26.8,
                            "radi": 0.004601224197882966,
                            "sz": 1898.1412353515625
                        },
                        "name": "Sun",
                        "pos": {
                            "altaz": {
                                "alt": {
                                    "deg": -17.676677205653913,
                                    "str": "-17deg 40' 36.0\""
                                },
                                "az": {
                                    "deg": 253.20953205863395,
                                    "str": "253deg 12' 34.3\""
                                }
                            },
                            "const": {
                                "abbr": "Leo",
                                "id": "leo",
                                "name": "Leo"
                            },
                            "radec": {
                                "dec": {
                                    "deg": -23.427243017367854,
                                    "str": "-23deg 25' 38.1\""
                                },
                                "ra": {
                                    "hr": 17.875687472812032,
                                    "str": "17h 52m 32.47s"
                                }
                            }
                        }
                    }
                ],
                "id": "sun",
                "name": "Sun"
            },
            {
                "columns": [
                    {
                        "date": "2016-12-20T00:00:00",
                        "dist": {
                            "earth": {
                                "au": 0.79518336244444721,
                                "km": 118957737.83775564
                            },
                            "sun": {
                                "au": 0.4070223867893219,
                                "km": 60889682.39091436
                            }
                        },
                        "id": "mercury",
                        "meta": {
                            "elong": 0.12851867808223255,
                            "mag": 3.38,
                            "radi": 0.000026483396276688,
                            "sz": 10.925185203552246
                        },
                        "name": "Mercury",
                        "pos": {
                            "altaz": {
                                "alt": {
                                    "deg": -3.3902502011998239,
                                    "str": "-03deg 23' 24.9\""
                                },
                                "az": {
                                    "deg": 244.62816986540426,
                                    "str": "244deg 37' 41.4\""
                                }
                            },
                            "const": {
                                "abbr": "Sex",
                                "id": "sex",
                                "name": "Sextans"
                            },
                            "radec": {
                                "dec": {
                                    "deg": -22.885117161385157,
                                    "str": "-22deg 53' 06.4\""
                                },
                                "ra": {
                                    "hr": 19.077950188242596,
                                    "str": "19h 04m 40.62s"
                                }
                            }
                        }
                    }
                ],
                "id": "mercury",
                "name": "Mercury"
            }
            
            ...
            ...
            ...
            ...
            ...
            ...
        ]
    }
}
You can’t perform that action at this time.