Getting Astronomical Information for an Address

You can pass the address of a location as query parameters to get the astronomical information. Here is a curl example:

# Get astronomical information for address 'New York, US'
    $ curl --location --request GET 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&location=New%20York,%20US'

1
2    "location": {
3        "country": "United States of America",
4        "state": "New York",
5        "city": "",
6        "latitude": 41.3558443,
7        "longitude": -74.00776718841271
8    },
9    "date": "2020-12-21",
10    "current_time": "06:54:35.901",
11    "sunrise": "07:18",
12    "sunset": "16:30",
13    "sun_status": "-",
14    "solar_noon": "11:54",
15    "day_length": "09:12",
16    "sun_altitude": -4.811160884765326,
17    "sun_distance": 1.4717185206455985E8,
18    "sun_azimuth": 117.23599031322385,
19    "moonrise": "12:12",
20    "moonset": "23:58",
21    "moon_status": "-",
22    "moon_altitude": -52.075439497726244,
23    "moon_distance": 398627.6792531222,
24    "moon_azimuth": 29.97617258900459,
25    "moon_parallactic_angle": -26.12246297084847
26}

Location details like country name, state/province name, and city are provided in the response for the provided location that can be used for multiple purposes.

Getting Astronomical Information for Location Coordinates

You can pass the latitude and longitude of a location as query parameters to get the astronomical information. Here is a curl example:

# Get astronomical information for -27.4748, 153.017 coordinates
    $ curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&lat=-27.4748&long=153.017'

1
2{
3  "location": {
4      "latitude": -27.4748,
5      "longitude": 153.017
6  },
7  "date": "2020-12-21",
8  "current_time": "21:55:42.198",
9  "sunrise": "04:49",
10  "sunset": "18:42",
11  "sun_status": "-",
12  "solar_noon": "11:46",
13  "day_length": "13:53",
14  "sun_altitude": -32.52181803389665,
15  "sun_distance": 1.4717185206455985E8,
16  "sun_azimuth": 210.3191424893586,
17  "moonrise": "10:56",
18  "moonset": "23:51",
19  "moon_status": "-",
20  "moon_altitude": 25.112485813391366,
21  "moon_distance": 398630.7670989189,
22  "moon_azimuth": 275.28650130894704,
23  "moon_parallactic_angle": 122.50665265321304
24}
25                  

Getting Astronomical Information for an IPv4 or IPv6 Address

You can pass any IPv4 or IPv6 address as a query parameter to get the astronomical information. Here is a curl example:

# Get astronomical information for an IP address '1.1.1.1'
    $ curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&ip=1.1.1.1'

1
2  {
3    "location": {
4    "country": "United States of America",
5    "state": "New York",
6    "city": "",
7    "latitude": 41.3558443,
8    "longitude": -74.00776718841271
9    },
10    "date": "2020-12-21",
11    "current_time": "06:54:35.901",
12    "sunrise": "07:18",
13    "sunset": "16:30",
14    "sun_status": "-",
15    "solar_noon": "11:54",
16    "day_length": "09:12",
17    "sun_altitude": -4.811160884765326,
18    "sun_distance": 1.4717185206455985E8,
19    "sun_azimuth": 117.23599031322385,
20    "moonrise": "12:12",
21    "moonset": "23:58",
22    "moon_status": "-",
23    "moon_altitude": -52.075439497726244,
24    "moon_distance": 398627.6792531222,
25    "moon_azimuth": 29.97617258900459,
26    "moon_parallactic_angle": -26.12246297084847
27                    
28} 

Note: When you get the astronomical information through an IP address, API will also return the extra fields about place information along with the astronomical information.

Using Client or Machine IP Address

You can call the astronomy API without passing any coordinates or IP address as well. It will use the calling machine's IP address to return the regional astronomical information. Here is a curl example:

$ curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY'

Note:In above example, we used API Key everywhere. Astronomy API can be called from client side JavaScript with Request Origin authentication as well on paid plans.

Response in Multiple Languages

The astronomy information lookup using an IP address can include geolocation information the following languages:s

• English (en)
• German (de)
• Russian (ru)
• Japanese (ja)
• French (fr)
• Chinese Simplified (cn)
• Spanish (es)
• Czech (cs)
• Italian (it)

By default, the API responds in English. But you can change the response language by passing the language code as a query parameter lang. Here is an example:

# Get astronomical information for an IPv4 IP Address = 1.1.1.1 in Chinese language
    $ curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&ip=1.1.1.1&lang=cn'

Only the paid plan subscriptions can get the response in languages other than English. All the other subscriptions will only get the response in English.

Getting Astronomical Information for a Specific Date

Along with the above two variations, there is a third variation that you can get the astronomical information for a specific date. You can pass date query parameter with the date value. Here are the curl example calls:

    # Get astronomical information for -27.4748, 153.017 coordinates
    $ curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&lat=-27.4748&long=153.017&date=2018-01-01'

Along with the above two variations, there is a third variation that you can get the astronomical information for a specific date. You can pass date query parameter with the date value. Here are the curl example calls: