Weather API
  1. customer
Weather API
  • customer
    • Weather API - General Information
    • Weather API - Variables
    • Weather API - Timesteps
    • Weather API - /wthr/ endpoints usability improvements
    • Weather API - VariableAlias.json
    • Weather API - WeatherVariablesDefaults.json
    • Weather API - weatherMap - parameters
    • Weather API - weatherTiles - general, zoom
    • Weather API - weatherTiles - weather variables
    • Weather API - weatherTiles - timesteps
    • /
      GET
    • /wthr/list/ForecastModels
      GET
    • /wthr/list/WeatherVariables
      GET
    • /wthr/list/Timesteps
      GET
    • /wthr/list/TileTimesteps
      GET
    • /wthr/svar/NearestGridData
      GET
    • /wthr/svar/InterpolatedData
      GET
    • /wthr/svar/AreaForcast
      GET
    • /wthr/mvar/PointForcast
      POST
    • /wthr/calc/AstroData
      GET
    • /wthr/graphic/Meteogram
      GET
    • /wthr/graphic/WeatherMap
      GET
    • /wthr/graphic/Tile
      GET
  1. customer

/wthr/calc/AstroData

GET
weather.openportguide.org/api/wthr/calc/AstroData
Last modified:2025-07-03 20:22:03
Maintainer:tkws
OperationId:wthr_calc_AstroData
 

Description#

The end point /wthr/calc/AstroData returns
  • Times for various positions of the sun: astronomical dawn, nautical dawn, civil dawn, sunrise, noon, sunset, astronomical dusk, nautical dusk, civil dusk, solar azimuth, solar elevation, solar zenith, blue hour, golden hour, twilight morning, twilight evening, daylight, night and rahukaalam.
  • Moon rise, set, azimuth, elevation and zenith.
  • The phase of the moon.
Astronomical dawn
The time in the morning when the sun is 18 degrees below the horizon.
Nautical dawn
The time in the morning when the sun is 12 degrees below the horizon.
civil dawn
The time in the morning when the sun is 16 degrees below the horizon.
Sunrise
The time in the morning when the top of the sun breaks the horizon (assuming a location with no obscuring features.)
Noon
The time when the sun is at its highest point directly above the observer.
Midnight
The time when the sun is at its lowest point.
Sunset
The time in the evening when the sun is about to disappear below the horizon (asuming a location with no obscuring features.)
Civil dusk
The time in the evening when the sun is 6 degrees below the horizon.
Nautical dusk
The time in the evening when the sun is 12 degrees below the horizon.
Astronomical dusk
The time in the evening when the sun is 18 degrees below the horizon.
Daylight
The time when the sun is up i.e. between sunrise and sunset.
Night
The time between astronomical dusk of one day and astronomical dawn of the next.
Twilight morning and evening
The time between dawn and sunrise or between sunset and dusk.
The Golden Hour
The time when the sun is between 4 degrees below the horizon and 6 degrees above.
The Blue Hour
The time when the sun is between 6 and 4 degrees below the horizon.
Solar Azimuth
The number of degrees clockwise from North at which the sun can be seen.
Solar Elevation
The number of degrees up from the horizon at which the sun can be seen.
Solar Zenith
The angle of the sun down from directly above the observer.
Rahukaalam
“Rahukaalam or the period of Rahu is a certain amount of time every day that is considered inauspicious for any new venture according to Indian Vedic astrology”.
Moonrise and Moonset
Like the Sun but for the moon
Moon Azimuth, Elevation and Zenith
Also like the Sun but for the moon.
Moon Phase
The moon phase returns an number describing the phase of the moon for a specified date, where the value is between 0 and 1. The following lists the mapping of various values to the description of the phase of the moon.
0 .. 0.249
New moon
0.250 .. 0.499
First quarter
0.500 .. 0.749
Full moon
0.750 .. 0.999
Last quarter
 
Moon Phase Duration
The moon phase duration returns the time since beginning of last new moon. One cycle from new moon to the next new moon is about 29.53 days.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'weather.openportguide.org/api/wthr/calc/AstroData?latitude=54.04&longitude=9.075&timestamp=2025-07-12T20:58:51+02:00&apiKey={{api-key}}' \
--header 'Host: {{BASE_URL}}' \
--header 'x-api-key: {{api-key}}'
Response Response Example
200 - Success
{"metadata":{"serviceProvider":"navapi.com","originatingCenter":"navapi.com","requestedParameters":"latitude=54.04, longitude=9.075, timestep=2025-04-13T20:58:51 02:00","model":"astro_data","generatingProcess":"astro_data calculating the times of various aspects of the sun and moon","forecastPosition":[{"latitude":54.04},{"longitude":9.075},{"timestamp":"2025-04-13T20:58:51+02:00"}],"UsedTokens":1},"data":{"sunAzimuth":294.74,"sunElevation":-5.76,"sunZenith":95.76,"astronomicalDawn":"2025-04-13T04:08:28+02:00","nauticalDawn":"2025-04-13T05:02:20+02:00","civilDawn":"2025-04-13T05:49:07+02:00","blueHour":["2025-04-13T05:49:07+02:00","2025-04-13T06:03:43+02:00","0:14:24"],"goldenHour":["2025-04-13T06:03:43+02:00","2025-04-13T07:13:45+02:00","1:10:12"],"twilightMorning":["2025-04-13T05:49:07+02:00","2025-04-13T06:27:26+02:00","0:38:24"],"sunrise":"2025-04-13T06:27:26+02:00","daylight":["2025-04-13T06:27:26+02:00","2025-04-13T20:22:05+02:00","13:54:36"],"noon":"2025-04-13T13:24:16+02:00","rahukaalam":["2025-04-13T18:37:45+02:00","2025-04-13T20:22:05+02:00","1:44:24"],"sunset":"2025-04-13T20:22:05+02:00","twilightEvening":["2025-04-13T20:22:05+02:00","2025-04-13T21:00:37+02:00","0:38:24"],"civilDusk":"2025-04-13T21:00:37+02:00","nauticalDusk":"2025-04-13T21:47:47+02:00","astronomicalDusk":"2025-04-13T22:42:24+02:00","night":["2025-04-13T21:00:37+02:00","2025-04-14T05:46:35+02:00","8:46:12"],"midnight":"2025-04-13T01:24:03+02:00","moonrise":"2025-04-13T21:22:00+02:00","moonset":"2025-04-13T04:18:00+00:00","moonAzimuth":136.97,"moonElevation":10.9,"moonZenith":79.1,"moonPhase":0.515,"moonPhaseDuration":"15 days, 4:59:26"}}

Request

Query Params

Header Params

Responses

🟢200OK
application/json
Body

🟠401Unauthorized
Modified at 2025-07-03 20:22:03
Previous
/wthr/mvar/PointForcast
Next
/wthr/graphic/Meteogram
Built with