Weather API - Revision history

141.101.68.83 at 11:28, 8 December 2025

2025-12-08T11:28:03Z

← Older revision		Revision as of 13:28, 8 December 2025
Line 47:		Line 47:
	"UTC": "<seeing_utc_time>",		"UTC": "<seeing_utc_time>",
	"SeeingValue": <seeing_value>,		"SeeingValue": <seeing_value>,
	"status": <seeing_monitor_status>,		"status": "<seeing_monitor_status>",
	"avgSeeing": <average_seeing>,		"avgSeeing": <average_seeing>,
	"monitoringSeeingStart": "<seeing_monitoring_start>",		"monitoringSeeingStart": "<seeing_monitoring_start>",

172.71.126.138 at 11:26, 8 December 2025

2025-12-08T11:26:50Z

← Older revision		Revision as of 13:26, 8 December 2025
Line 164:		Line 164:
	"UTC": "2025-05-24 07:35:03",		"UTC": "2025-05-24 07:35:03",
	"SeeingValue": 1.22,		"SeeingValue": 1.22,
			"status": "Idle (Daytime)",
	"avgSeeing": 0.93,		"avgSeeing": 0.93,
	"monitoringSeeingStart": "2025-05-21 14:04:05",		"monitoringSeeingStart": "2025-05-21 14:04:05",

172.71.126.138 at 11:26, 8 December 2025

2025-12-08T11:26:03Z

← Older revision		Revision as of 13:26, 8 December 2025
Line 47:		Line 47:
	"UTC": "<seeing_utc_time>",		"UTC": "<seeing_utc_time>",
	"SeeingValue": <seeing_value>,		"SeeingValue": <seeing_value>,
			"status": <seeing_monitor_status>,
	"avgSeeing": <average_seeing>,		"avgSeeing": <average_seeing>,
	"monitoringSeeingStart": "<seeing_monitoring_start>",		"monitoringSeeingStart": "<seeing_monitoring_start>",
Line 113:		Line 114:
	* '''UTC''' (string): UTC time of the current seeing measurement.		* '''UTC''' (string): UTC time of the current seeing measurement.
	* '''SeeingValue''' (float): Current seeing value in arcseconds (lower = better).		* '''SeeingValue''' (float): Current seeing value in arcseconds (lower = better).
			* '''status''' (string): Operational status of the seeing monitor (e.g., "Monitoring", "Idle (Daytime)").
	* '''avgSeeing''' (float): Average seeing since monitoring began.		* '''avgSeeing''' (float): Average seeing since monitoring began.
	* '''monitoringSeeingStart''' (string): Start timestamp for seeing monitoring (yyyy-mm-dd hh:mm:ss).		* '''monitoringSeeingStart''' (string): Start timestamp for seeing monitoring (yyyy-mm-dd hh:mm:ss).

172.71.232.150 at 07:54, 24 May 2025

2025-05-24T07:54:44Z

Show changes

172.71.123.16 at 13:46, 22 May 2025

2025-05-22T13:46:46Z

← Older revision		Revision as of 15:46, 22 May 2025
Line 175:		Line 175:

	=== Authentication ===		=== Authentication ===
	Currently, the API does not require authentication. Any future r		Currently, the API does not require authentication. Any future requirements will be documented here.

			=== Conclusion ===
			This API provides detailed weather, seeing, and astronomical data to support stargazing, observatory operations, and long-term monitoring at Deep Sky Chile.

			[[Category:User manuals]]

172.71.123.15 at 13:44, 22 May 2025

2025-05-22T13:44:53Z

← Older revision		Revision as of 15:44, 22 May 2025
Line 46:		Line 46:
	"seeing": {		"seeing": {
	"UTC": "<seeing_utc_time>",		"UTC": "<seeing_utc_time>",
	"SeeingValue": <seeing_value>		"SeeingValue": <seeing_value>,
			"avgSeeing": <average_seeing>,
			"monitoringSeeingStart": "<seeing_monitoring_start>"
	},		},
	"average": {		"average": {
Line 91:		Line 93:

	'''ninox (Astronomical Data)'''		'''ninox (Astronomical Data)'''
	* '''UTC''' (string): Current UTC time, format: yy-mm-dd hh:mm:ss.		* '''UTC''' (string): Current UTC time, format: yyyy-mm-dd hh:mm:ss.
	* '''NSBNow''' (float): Current sky brightness (NSB) value. Lower values indicate better observing conditions.		* '''NSBNow''' (float): Current sky brightness (NSB) value. Lower values indicate better observing conditions.
	* '''SunAltitude''' (float): Altitude of the Sun in degrees.		* '''SunAltitude''' (float): Altitude of the Sun in degrees.
Line 105:		Line 107:

	'''seeing (Atmospheric Seeing Conditions)'''		'''seeing (Atmospheric Seeing Conditions)'''
	* '''UTC''' (string): UTC time of the seeing measurement.		* '''UTC''' (string): UTC time of the current seeing measurement.
	* '''SeeingValue''' (float): ~~Seeing~~ value in arcseconds. Lower values indicate better seeing (e.g., 1.0 is excellent, 2.5 is poor).		* '''SeeingValue''' (float): Current seeing value in arcseconds. Lower values indicate better seeing (e.g., 1.0 is excellent, 2.5 is poor).
			* '''avgSeeing''' (float): Average seeing value since monitoring began.
			* '''monitoringSeeingStart''' (string): Start timestamp for seeing monitoring (yyyy-mm-dd hh:mm:ss).

	'''average (Averaged Historical Data)'''		'''average (Averaged Historical Data)'''
Line 119:		Line 123:
	"weather": {		"weather": {
	"cloudwatcher": {		"cloudwatcher": {
	"clouds": -16.13,		"clouds": -12.35,
	"temp": 17.38,		"temp": 34.09,
	"wind": 4,		"wind": 3,
	"gust": 5,		"gust": 3,
	"rain": ~~5248~~,		"rain": 5120,
	"light": ~~57232~~,		"light": 2,
	"switch": 1,		"switch": 1,
	"safe": 1,		"safe": 1,
	"hum": 5,		"hum": 7,
	"dewp": -22.72,		"dewp": -6.56,
	"cloudsState": "Clear",		"cloudsState": "Clear",
	"rainState": "Dry",		"rainState": "Dry",
	"lightState": "~~Dark~~"		"lightState": "Sunny"
	},		},
	"ninox": {		"ninox": {
	"UTC": "2025-05-10 07:04:09",		"UTC": "2025-05-22 10:51:59",
	"NSBNow": 19.45,		"NSBNow": 16.18,
	"SunAltitude": -55.2,		"SunAltitude": -8.3,
	"MoonAltitude": 29,		"MoonAltitude": 51.5,
	"MoonPhase": 94.8,		"MoonPhase": 28.9,
	"ZenithGalacticLatitude": 1.9,		"ZenithGalacticLatitude": -53.7,
	"NightBestNSB": 19.46,		"NightBestNSB": 21.56,
	"NightBestNSBTime": "2025-05-~~10 07~~:02:02",		"NightBestNSBTime": "2025-05-22 01:39:25",
	"NightBestNSBZGL": 1.9,		"NightBestNSBZGL": 32.4,
	"OverallBestNSB": 21.15,		"OverallBestNSB": 21.96,
	"OverallBestNSBTime": "2025-05-~~08 09~~:00:13",		"OverallBestNSBTime": "2025-05-17 23:30:55",
	"OverallBestNSBZGL": ~~-19~~.2		"OverallBestNSBZGL": 23.2
	},		},
	"seeing": {		"seeing": {
	"UTC": "2025-05-10 03:~~16:14~~",		"UTC": "2025-05-22 11:03:25",
	"SeeingValue": 1.48		"SeeingValue": 1.37,
			"avgSeeing": 0.85,
			"monitoringSeeingStart": "2025-05-21 14:04:05"
	},		},
	"average": {		"average": {
	"avgHum": 26.94,		"avgHum": 23.36,
	"avgWind": 6.8,		"avgWind": 3.13,
	"avgTemp": 19.16,		"avgTemp": 16.52,
	"monitoringStart": "2023-05-~~10 09~~:11:02"		"monitoringStart": "2023-05-22 15:41:02"
	}		}
	}		}
Line 169:		Line 175:

	=== Authentication ===		=== Authentication ===
	Currently, the API does not require authentication. Any future ~~requirements will be documented here.~~		Currently, the API does not require authentication. Any future r

	~~=== Conclusion ===~~
	~~This API provides detailed weather, seeing, and astronomical data to support stargazing, observatory operations, and long-term monitoring at Deep Sky Chile.~~

	~~[[Category:User manuals]]~~

172.71.134.129 at 07:11, 10 May 2025

2025-05-10T07:11:54Z

Show changes

172.71.134.86 at 12:29, 15 November 2024

2024-11-15T12:29:01Z

← Older revision		Revision as of 14:29, 15 November 2024
Line 43:		Line 43:
	},		},
	"average": {		"average": {
	"avgHum": "<average_humidity>",		"avgHum": <average_humidity>,
	"avgWind": "<average_wind_speed>",		"avgWind": <average_wind_speed>,
	"avgTemp": "<average_temperature>",		"avgTemp": <average_temperature>,
	"monitoringStart": "<monitoring_start_date>"		"monitoringStart": "<monitoring_start_date>"
	}		}
Line 136:		Line 136:
	},		},
	"average": {		"average": {
	"avgHum": "26.43",		"avgHum": 26.43,
	"avgWind": "6.81",		"avgWind": 6.81,
	"avgTemp": "19.21",		"avgTemp": 19.21,
	"monitoringStart": "2023-01-03 22:41:01"		"monitoringStart": "2023-01-03 22:41:01"
	}		}

172.71.122.104 at 12:24, 15 November 2024

2024-11-15T12:24:46Z

← Older revision		Revision as of 14:24, 15 November 2024
Line 41:		Line 41:
	"OverallBestNSBTime": "<overall_best_NSB_time>",		"OverallBestNSBTime": "<overall_best_NSB_time>",
	"OverallBestNSBZGL": <overall_best_ZGL>		"OverallBestNSBZGL": <overall_best_ZGL>
			},
			"average": {
			"avgHum": "<average_humidity>",
			"avgWind": "<average_wind_speed>",
			"avgTemp": "<average_temperature>",
			"monitoringStart": "<monitoring_start_date>"
	}		}
	}		}
Line 47:		Line 53:
	=== Fields ===		=== Fields ===
	weather		weather
	The main object containing weather data from ~~two~~ sources: cloudwatcher and ~~ninox~~.		The main object containing weather data from three sources: cloudwatcher, ninox, and average.

	cloudwatcher (General Weather Data)		cloudwatcher (General Weather Data)
Line 90:		Line 96:
	* '''OverallBestNSBTime''' (string): The timestamp of when the overall best NSB conditions occur.		* '''OverallBestNSBTime''' (string): The timestamp of when the overall best NSB conditions occur.
	* '''OverallBestNSBZGL''' (float): The Zenith Galactic Latitude associated with the overall best NSB value.		* '''OverallBestNSBZGL''' (float): The Zenith Galactic Latitude associated with the overall best NSB value.

			average (Averaged Historical Data)
			* '''avgHum''' (float): The average relative humidity in percentage since monitoring began.
			* '''avgWind''' (float): The average wind speed in kilometer per hour (km/h) since monitoring began.
			* '''avgTemp''' (float): The average temperature in degrees Celsius since monitoring began.
			* '''monitoringStart''' (string): The timestamp marking the start of monitoring, formatted as yyyy-mm-dd hh:mm:ss.

	=== Example Response ===		=== Example Response ===
Line 95:		Line 107:
	"weather": {		"weather": {
	"cloudwatcher": {		"cloudwatcher": {
	"clouds": -14.1,		"clouds": -17.18,
	"temp": 31.25,		"temp": 36.33,
	"wind": 11,		"wind": 3,
	"gust": 17,		"gust": 5,
	"rain": ~~5120~~,		"rain": 5094,
	"light": 2,		"light": 2,
	"switch": 1,		"switch": 1,
	"safe": 1,		"safe": 1,
	"hum": 8,		"hum": 14,
	"dewp": -6.9,		"dewp": 4.6,
	"cloudsState": "Clear",		"cloudsState": "Clear",
	"rainState": "Dry",		"rainState": "Dry",
Line 110:		Line 122:
	},		},
	"ninox": {		"ninox": {
	"UTC": "24-11-12 09:04:42",		"UTC": "24-11-15 09:05:52",
	"NSBNow": 16.29,		"NSBNow": 15.96,
	"SunAltitude": -8.3,		"SunAltitude": -8,
	"MoonAltitude": ~~-22~~.3,		"MoonAltitude": 0.3,
	"MoonPhase": 83.1,		"MoonPhase": 99.5,
	"ZenithGalacticLatitude": -3,		"ZenithGalacticLatitude": -0.9,
	"NightBestNSB": 21.23,		"NightBestNSB": 19.43,
	"NightBestNSBTime": "24-11-~~12 07~~:33:14",		"NightBestNSBTime": "24-11-15 08:28:44",
	"NightBestNSBZGL": -~~20.3~~,		"NightBestNSBZGL": -7,
	"OverallBestNSB": 24.1,		"OverallBestNSB": 24.1,
	"OverallBestNSBTime": "24-05-07 23:17:28",		"OverallBestNSBTime": "24-05-07 23:17:28",
	"OverallBestNSBZGL": 16.2		"OverallBestNSBZGL": 16.2
			},
			"average": {
			"avgHum": "26.43",
			"avgWind": "6.81",
			"avgTemp": "19.21",
			"monitoringStart": "2023-01-03 22:41:01"
	}		}
	}		}

Cedric: Created page with "== Deep Sky Chile Weather API User Manual == The Deep Sky Chile Weather API provides real-time weather and astronomical data, including cloud cover, temperature, wind speed, rain, light levels, and key astronomical measurements. === Base URL === The base URL for accessing the API is: http://api.deepskychile.com/weather === Endpoint === * '''GET /weather''': Retrieves the current weather and astronomical data, including cloud, rain, light states, and important astronom..."

2024-11-13T21:21:08Z

Created page with "== Deep Sky Chile Weather API User Manual == The Deep Sky Chile Weather API provides real-time weather and astronomical data, including cloud cover, temperature, wind speed, rain, light levels, and key astronomical measurements. === Base URL === The base URL for accessing the API is: http://api.deepskychile.com/weather === Endpoint === * '''GET /weather''': Retrieves the current weather and astronomical data, including cloud, rain, light states, and important astronom..."

New page

== Deep Sky Chile Weather API User Manual ==

The Deep Sky Chile Weather API provides real-time weather and astronomical data, including cloud cover, temperature, wind speed, rain, light levels, and key astronomical measurements.

=== Base URL ===
The base URL for accessing the API is: http://api.deepskychile.com/weather

=== Endpoint ===
* '''GET /weather''': Retrieves the current weather and astronomical data, including cloud, rain, light states, and important astronomical metrics.

=== Response Format ===
The API returns the data in JSON format with the following structure:
{
"weather": {
"cloudwatcher": {
"clouds": <clouds_value>,
"temp": <temperature_value>,
"wind": <wind_speed>,
"gust": <wind_gust>,
"rain": <rain_value>,
"light": <light_level>,
"switch": <switch_state>,
"safe": <safe_state>,
"hum": <humidity>,
"dewp": <dew_point>,
"cloudsState": "<clouds_state>",
"rainState": "<rain_state>",
"lightState": "<light_state>"
},
"ninox": {
"UTC": "<utc_time>",
"NSBNow": <current_NSB_value>,
"SunAltitude": <sun_altitude>,
"MoonAltitude": <moon_altitude>,
"MoonPhase": <moon_phase>,
"ZenithGalacticLatitude": <galactic_latitude>,
"NightBestNSB": <best_NSB_value>,
"NightBestNSBTime": "<night_best_NSB_time>",
"NightBestNSBZGL": <night_best_ZGL>,
"OverallBestNSB": <overall_best_NSB_value>,
"OverallBestNSBTime": "<overall_best_NSB_time>",
"OverallBestNSBZGL": <overall_best_ZGL>
}
}
}

=== Fields ===
weather
The main object containing weather data from two sources: cloudwatcher and ninox.

cloudwatcher (General Weather Data)
* '''clouds''' (float): The current sky temperature in degrees Celsius.
* '''temp''' (float): The current temperature in degrees Celsius.
* '''wind''' (float): The current wind speed in kilometer per hour (km/h).
* '''gust''' (float): The current wind gust speed in kilometer per hour (km/h).
* '''rain''' (float): The amount of rain, no unit.
* '''light''' (float): The ambient light level, no unit.
* '''switch''' (integer): Lock switch status value. Possible values:
* 1: Observatories are unlocked.
* 0: Observatories are locked.
* '''safe''' (integer): Safety status value. Possible values:
* 1: Safe.
* 0: Unsafe.
* '''hum''' (float): The relative humidity in percentage.
* '''dewp''' (float): The dew point temperature in degrees Celsius.
* '''cloudsState''' (string): Determined based on the clouds value. Possible values:
* "Clear": Cloud coverage is low.
* "Cloudy": Moderate cloud cover.
* "Overcast": High cloud cover or fully covered skies.
* '''rainState''' (string): Determined based on the rain value. Possible values:
* "Dry": No significant rain detected (rain value greater than 2000).
* "Wet": Light rain (rain value between 1700 and 2000).
* "Raining": Moderate to heavy rain (rain value less than 1700).
* '''lightState''' (string): Determined based on the light value. Possible values:
* "Dark": Light intensity above 8000.
* "Bright": Light intensity between 6 and 8000.
* "Sunny": Light intensity below 6.

ninox (Astronomical Data)
* '''UTC''' (string): The current UTC time, formatted as yy-mm-dd hh:mm:ss.
* '''NSBNow''' (float): The current NSB (Sky Brightness) value. It represents the visibility of the night sky. Lower values indicate better observing conditions.
* '''SunAltitude''' (float): The altitude of the Sun in degrees. Negative values indicate the Sun is below the horizon.
* '''MoonAltitude''' (float): The altitude of the Moon in degrees. Negative values indicate the Moon is below the horizon.
* '''MoonPhase''' (float): The phase of the Moon, measured as a percentage (0-100%).
* '''ZenithGalacticLatitude''' (float): The galactic latitude at the zenith, used to describe the position relative to the galactic plane.
* '''NightBestNSB''' (float): The best NSB value for the night.
* '''NightBestNSBTime''' (string): The timestamp of when the best NSB conditions occur during the night.
* '''NightBestNSBZGL''' (float): The Zenith Galactic Latitude associated with the best NSB value.
* '''OverallBestNSB''' (float): The overall best NSB value over a longer period, representing the best observing conditions overall.
* '''OverallBestNSBTime''' (string): The timestamp of when the overall best NSB conditions occur.
* '''OverallBestNSBZGL''' (float): The Zenith Galactic Latitude associated with the overall best NSB value.

=== Example Response ===
{
"weather": {
"cloudwatcher": {
"clouds": -14.1,
"temp": 31.25,
"wind": 11,
"gust": 17,
"rain": 5120,
"light": 2,
"switch": 1,
"safe": 1,
"hum": 8,
"dewp": -6.9,
"cloudsState": "Clear",
"rainState": "Dry",
"lightState": "Sunny"
},
"ninox": {
"UTC": "24-11-12 09:04:42",
"NSBNow": 16.29,
"SunAltitude": -8.3,
"MoonAltitude": -22.3,
"MoonPhase": 83.1,
"ZenithGalacticLatitude": -3,
"NightBestNSB": 21.23,
"NightBestNSBTime": "24-11-12 07:33:14",
"NightBestNSBZGL": -20.3,
"OverallBestNSB": 24.1,
"OverallBestNSBTime": "24-05-07 23:17:28",
"OverallBestNSBZGL": 16.2
}
}
}

=== Error Handling ===
If an error occurs while fetching the data, the API will return a generic HTTP error response (e.g., 500 Internal Server Error).

=== Example Request ===
To retrieve the current weather and astronomical data, make a simple GET request to the following endpoint:
GET http://api.deepskychile.com/weather

=== Authentication ===
Currently, the API does not require authentication. Any future authentication requirements will be detailed here.

=== Conclusion ===
This API provides both weather and astronomical data to help with sky observations and general weather monitoring at Deep Sky Chile. It allows users to track cloud coverage, temperature, rain, light levels, and other important factors for stargazing, as well as obtain detailed astronomical conditions such as NSB, Sun and Moon altitudes, and phase data.

If you need further assistance or have additional questions about using the API, feel free to reach out.

[[Category:User manuals]]