GodotNWS Observations: fetch_current_observations() API

Current observations provide real-time conditions reported by the nearest NWS observation station for your configured location. Unlike forecast data, observations reflect what is actually happening right now: temperature, wind, pressure, humidity, precipitation, and cloud cover. Requires location_setup_complete to have fired before calling.

Method

`fetch_current_observations(fetch_icon: bool)`

Fetches the latest observation from the NWS zone observation feed and emits observations_fetched with an ObservationPacket resource. Not all fields in ObservationPacket are guaranteed to be present — the NWS API omits measurements that are not available at the reporting station.

fetch_icon

bool

required

When true, the current condition icon is fetched and stored in ObservationPacket.icon as an ImageTexture. The signal fires only after the icon has loaded. When false, ObservationPacket.icon is null but ObservationPacket.iconUrl is still populated if an icon URL was returned by the API.

Signal

`observations_fetched(observations: ObservationPacket)`

Emitted when the observation data — and the condition icon, if requested — is ready.

This signal emits null when the NWS observation feed returns no data for the zone. Always null-check the observations argument before accessing any of its properties.

observations

ObservationPacket

An ObservationPacket resource containing current conditions, or null if observations are unavailable. The packet exposes the following fields:

Show ObservationPacket fields

raw

Dictionary

The complete raw JSON properties dictionary from the NWS API observation response.

station

String

The URL identifier of the reporting observation station.

timestamp

String

ISO 8601 timestamp string of when the observation was recorded.

rawMessage

String

Raw METAR or observation string as transmitted by the station.

textDescription

String

Human-readable description of current conditions, such as "Mostly Cloudy".

icon

ImageTexture

Current condition icon as an ImageTexture, or null if fetch_icon was false or no icon URL was provided.

iconUrl

String

Direct URL to the condition icon PNG, if provided by the API.

presentWeather

String

Short present-weather code string from the first reported weather phenomenon, if any.

temperature

float

Current temperature in degrees Celsius.

dewpoint

float

Dewpoint temperature in degrees Celsius, if reported.

windDirection

float

Wind direction in degrees (0–360), if reported.

windSpeed

float

Wind speed in meters per second, if reported.

windGust

float

Wind gust speed in meters per second, if reported.

barometricPressure

float

Station barometric pressure in Pascals, if reported.

seaLevelPressure

float

Sea-level pressure in Pascals, if reported.

visibility

float

Horizontal visibility in meters, if reported.

maxTempLast24

float

Maximum temperature in the last 24 hours in degrees Celsius, if reported.

minTempLast24

float

Minimum temperature in the last 24 hours in degrees Celsius, if reported.

precipitationLastHour

float

Liquid precipitation accumulation in the last hour in meters, if reported.

precipitationLast3Hours

float

Liquid precipitation accumulation in the last 3 hours in meters, if reported.

precipitationLast6Hours

float

Liquid precipitation accumulation in the last 6 hours in meters, if reported.

relativeHumidity

float

Relative humidity as a percentage (0–100), if reported.

windChill

float

Wind chill temperature in degrees Celsius, if reported.

heatIndex

float

Heat index temperature in degrees Celsius, if reported.

cloudLayers

String

Sky coverage code for the lowest cloud layer (e.g. "BKN", "OVC"), if reported.

baseCloudHeight

float

Height of the lowest cloud layer base in meters, if reported.

All measurements use metric units as returned directly by the NWS API: temperature in Celsius, wind speed in m/s, pressure in Pascals, precipitation in meters, visibility in meters, and cloud height in meters. Convert as needed before displaying to users.

Code Example

extends Node

func _ready() -> void:
    Nws.location_setup_complete.connect(_on_ready)
    Nws.setup(39.7456, -97.0892)

func _on_ready() -> void:
    Nws.observations_fetched.connect(_on_observations)
    Nws.fetch_current_observations(true)

func _on_observations(obs: ObservationPacket) -> void:
    if obs == null:
        print("Observations unavailable for this location.")
        return

    print("Station: ", obs.station)
    print("Conditions: ", obs.textDescription)
    print("Temperature: %.1f°C" % obs.temperature)

    if obs.windSpeed > 0.0:
        print("Wind: %.1f m/s from %d°" % [obs.windSpeed, obs.windDirection])

    if obs.icon:
        $WeatherIcon.texture = obs.icon

Singleton (Nws)

Data Classes

GodotNWS Observations: fetch_current_observations() API

Method

`fetch_current_observations(fetch_icon: bool)`

Signal

`observations_fetched(observations: ObservationPacket)`

Code Example

Build docs developers (and LLMs) love

Singleton (Nws)

Data Classes

Documentation Index

​Method

​fetch_current_observations(fetch_icon: bool)

​Signal

​observations_fetched(observations: ObservationPacket)

​Code Example

Build docs developers (and LLMs) love

Method

`fetch_current_observations(fetch_icon: bool)`

Signal

`observations_fetched(observations: ObservationPacket)`

Code Example