GWeatherInfo: libgweather Reference Manual

## GWeatherInfo GWeatherInfo |

## Functions

GWeatherInfo * | gweather_info_new ()
void | gweather_info_update ()
void | gweather_info_abort ()
gboolean | gweather_info_is_valid ()
gboolean | gweather_info_network_error ()
void | gweather_info_store_cache ()
const GWeatherLocation * | gweather_info_get_location ()
void | gweather_info_set_location ()
gchar * | gweather_info_get_forecast ()
GSList * | gweather_info_get_forecast_list ()
GWeatherProvider | gweather_info_get_enabled_providers ()
void | gweather_info_set_enabled_providers ()
const gchar * | gweather_info_get_attribution ()
gchar * | gweather_info_get_location_name ()
const gchar * | gweather_info_get_icon_name ()
const gchar * | gweather_info_get_symbolic_icon_name ()
gchar * | gweather_info_get_weather_summary ()
gchar * | gweather_info_get_temp_summary ()
gchar * | gweather_info_get_update ()
gchar * | gweather_info_get_sky ()
gchar * | gweather_info_get_conditions ()
gchar * | gweather_info_get_temp ()
gchar * | gweather_info_get_temp_min ()
gchar * | gweather_info_get_temp_max ()
gchar * | gweather_info_get_dew ()
gchar * | gweather_info_get_humidity ()
gchar * | gweather_info_get_wind ()
gchar * | gweather_info_get_pressure ()
gchar * | gweather_info_get_visibility ()
gchar * | gweather_info_get_apparent ()
gchar * | gweather_info_get_sunrise ()
gchar * | gweather_info_get_sunset ()
GdkPixbufAnimation * | gweather_info_get_radar ()
const gchar * | gweather_conditions_to_string ()
const gchar * | gweather_sky_to_string ()
const gchar * | gweather_wind_direction_to_string ()
gboolean | gweather_info_get_value_update ()
gboolean | gweather_info_get_value_sky ()
gboolean | gweather_info_get_value_conditions ()
gboolean | gweather_info_get_value_temp ()
gboolean | gweather_info_get_value_temp_min ()
gboolean | gweather_info_get_value_temp_max ()
gboolean | gweather_info_get_value_dew ()
gboolean | gweather_info_get_value_apparent ()
gboolean | gweather_info_get_value_wind ()
gboolean | gweather_info_get_value_pressure ()
gboolean | gweather_info_get_value_visibility ()
gboolean | gweather_info_get_value_sunrise ()
gboolean | gweather_info_get_value_sunset ()
gint | gweather_info_next_sun_event ()
gboolean | gweather_info_get_value_moonphase ()
gboolean | gweather_info_get_upcoming_moonphases ()
gboolean | gweather_info_is_daytime ()

## Properties

GWeatherProvider | enabled-providers | Read / Write
GWeatherLocation * | location | Read / Write / Construct

## Signals

void | updated | Run First

## Types and Values

enum | GWeatherProvider
enum | GWeatherConditionPhenomenon
enum | GWeatherConditionQualifier
struct | GWeatherConditions
enum | GWeatherSky
enum | GWeatherWindDirection
typedef | GWeatherMoonLatitude
typedef | GWeatherMoonPhase
enum | GWeatherDistanceUnit
enum | GWeatherPressureUnit
enum | GWeatherSpeedUnit
enum | GWeatherTemperatureUnit
enum | GWeatherForecastType

## Object Hierarchy

        GObject
        ╰── GWeatherInfo

## Includes

    #include <libgweather/gweather.h>

## Description

GWeatherInfo provides a handy way to access weather conditions and forecasts from a GWeatherLocation, aggregating multiple different web services.

It includes also astronomical data such as sunrise times and moon phases.

## Functions

### gweather_info_new ()

    GWeatherInfo *
    gweather_info_new (GWeatherLocation *location,
                       GWeatherForecastType type);

Builds a new GWeatherInfo that will provide weather information about `location` .

#### Parameters

location | the desidered GWeatherLocation (`NULL` for default). | [allow-none]
type | deprecated and ignored |

#### Returns

a new GWeatherInfo.

[transfer full]

### gweather_info_update ()

    void
    gweather_info_update (GWeatherInfo *info);

Requests a reload of weather conditions and forecast data from enabled network services. This call does no synchronous IO: rather, the result is delivered by emitting the “updated” signal. Note that if no network services are enabled, the signal will not be emitted. See “enabled-providers” for details.

#### Parameters

info | a GWeatherInfo |

### gweather_info_abort ()

    void
    gweather_info_abort (GWeatherInfo *info);

### gweather_info_is_valid ()

    gboolean
    gweather_info_is_valid (GWeatherInfo *info);

### gweather_info_network_error ()

    gboolean
    gweather_info_network_error (GWeatherInfo *info);

### gweather_info_store_cache ()

    void
    gweather_info_store_cache (void);

Ensures that any data cached from the network is stored to disk. Calling this is not necessary, as the cache will be saved when the last reference to a GWeatherInfo will be dropped. On the other hand, it must be called if there is any chance that the application will be closed without unreffing all objects, such as when using a language binding that employs a GC.

### gweather_info_get_location ()

    const GWeatherLocation *
    gweather_info_get_location (GWeatherInfo *info);

### gweather_info_set_location ()

    void
    gweather_info_set_location (GWeatherInfo *info,
                                GWeatherLocation *location);

Changes `info` to report weather for `location` . Note that this will clear any forecast or current conditions from `info` , you must call `gweather_info_update()` to obtain the new data.

#### Parameters

info | a GWeatherInfo |
location | a location for which weather is desired. | [allow-none]

### gweather_info_get_forecast ()

    gchar *
    gweather_info_get_forecast (GWeatherInfo *info);

`gweather_info_get_forecast` has been deprecated since version 3.10 and should not be used in newly-written code.

Use `gweather_info_get_forecast_list()` instead.

#### Parameters

info | a GWeatherInfo |

### gweather_info_get_forecast_list ()

    GSList *
    gweather_info_get_forecast_list (GWeatherInfo *info);

#### Parameters

info | a GWeatherInfo |

#### Returns

list of GWeatherInfo* objects for the forecast. The list is owned by the 'info' object thus is alive as long as the 'info'. This list is filled only when requested with type FORECAST_LIST and if available for given location. The 'update' property is the date/time when the forecast info is used for.

[transfer none][element-type GWeather.Info]

### gweather_info_get_enabled_providers ()

    GWeatherProvider
    gweather_info_get_enabled_providers (GWeatherInfo *info);

### gweather_info_set_enabled_providers ()

    void
    gweather_info_set_enabled_providers (GWeatherInfo *info,
                                         GWeatherProvider providers);

### gweather_info_get_attribution ()

    const gchar *
    gweather_info_get_attribution (GWeatherInfo *info);

Some weather services require the application showing the data to include an attribution text, possibly including links to the service website. This must be shown prominently toghether with the data.

#### Parameters

info | a GWeatherInfo |

#### Returns

the required attribution text, in Pango markup form, or `NULL` if not required.

[transfer none]

### gweather_info_get_location_name ()

    gchar *
    gweather_info_get_location_name (GWeatherInfo *info);

### gweather_info_get_icon_name ()

    const gchar *
    gweather_info_get_icon_name (GWeatherInfo *info);

### gweather_info_get_symbolic_icon_name ()

    const gchar *
    gweather_info_get_symbolic_icon_name (GWeatherInfo *info);

### gweather_info_get_weather_summary ()

    gchar *
    gweather_info_get_weather_summary (GWeatherInfo *info);

#### Parameters

info | a GWeatherInfo |

#### Returns

a summary for current weather conditions.

[transfer full]

### gweather_info_get_temp_summary ()

    gchar *
    gweather_info_get_temp_summary (GWeatherInfo *info);

### gweather_info_get_update ()

    gchar *
    gweather_info_get_update (GWeatherInfo *info);

### gweather_info_get_sky ()

    gchar *
    gweather_info_get_sky (GWeatherInfo *info);

### gweather_info_get_conditions ()

    gchar *
    gweather_info_get_conditions (GWeatherInfo *info);

### gweather_info_get_temp ()

    gchar *
    gweather_info_get_temp (GWeatherInfo *info);

### gweather_info_get_temp_min ()

    gchar *
    gweather_info_get_temp_min (GWeatherInfo *info);

### gweather_info_get_temp_max ()

    gchar *
    gweather_info_get_temp_max (GWeatherInfo *info);

### gweather_info_get_dew ()

    gchar *
    gweather_info_get_dew (GWeatherInfo *info);

### gweather_info_get_humidity ()

    gchar *
    gweather_info_get_humidity (GWeatherInfo *info);

### gweather_info_get_wind ()

    gchar *
    gweather_info_get_wind (GWeatherInfo *info);

### gweather_info_get_pressure ()

    gchar *
    gweather_info_get_pressure (GWeatherInfo *info);

### gweather_info_get_visibility ()

    gchar *
    gweather_info_get_visibility (GWeatherInfo *info);

### gweather_info_get_apparent ()

    gchar *
    gweather_info_get_apparent (GWeatherInfo *info);

### gweather_info_get_sunrise ()

    gchar *
    gweather_info_get_sunrise (GWeatherInfo *info);

### gweather_info_get_sunset ()

    gchar *
    gweather_info_get_sunset (GWeatherInfo *info);

### gweather_info_get_radar ()

    GdkPixbufAnimation *
    gweather_info_get_radar (GWeatherInfo *info);

#### Parameters

info | a GWeatherInfo |

#### Returns

what?.

[transfer none]

### gweather_conditions_to_string ()

    const gchar *
    gweather_conditions_to_string (GWeatherConditions *conditions);

### gweather_sky_to_string ()

    const gchar *
    gweather_sky_to_string (GWeatherSky sky);

### gweather_wind_direction_to_string ()

    const gchar *
    gweather_wind_direction_to_string (GWeatherWindDirection wind);

### gweather_info_get_value_update ()

    gboolean
    gweather_info_get_value_update (GWeatherInfo *info,
                                    time_t *value);

#### Parameters

info | a GWeatherInfo |
value | the time `info` was last updated. | [out][type glong]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_sky ()

    gboolean
    gweather_info_get_value_sky (GWeatherInfo *info,
                                 GWeatherSky *sky);

Fills out `sky` with current sky conditions.

#### Parameters

info | a GWeatherInfo |
sky | a location for a GWeatherSky. | [out]

#### Returns

TRUE is `sky` is valid, FALSE otherwise.

### gweather_info_get_value_conditions ()

    gboolean
    gweather_info_get_value_conditions (GWeatherInfo *info,
                                        GWeatherConditionPhenomenon *phenomenon,
                                        GWeatherConditionQualifier *qualifier);

Fills out `phenomenon` and `qualifier` with current weather conditions.

#### Parameters

info | a GWeatherInfo |
phenomenon | a location for a GWeatherConditionPhenomenon. | [out]
qualifier | a location for a GWeatherConditionQualifier. | [out]

#### Returns

TRUE is out arguments are valid, FALSE otherwise.

### gweather_info_get_value_temp ()

    gboolean
    gweather_info_get_value_temp (GWeatherInfo *info,
                                  GWeatherTemperatureUnit unit,
                                  gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherTemperatureUnit |
value | the temperature value. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_temp_min ()

    gboolean
    gweather_info_get_value_temp_min (GWeatherInfo *info,
                                      GWeatherTemperatureUnit unit,
                                      gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherTemperatureUnit |
value | the minimum temperature value. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_temp_max ()

    gboolean
    gweather_info_get_value_temp_max (GWeatherInfo *info,
                                      GWeatherTemperatureUnit unit,
                                      gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherTemperatureUnit |
value | the maximum temperature value. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_dew ()

    gboolean
    gweather_info_get_value_dew (GWeatherInfo *info,
                                 GWeatherTemperatureUnit unit,
                                 gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherTemperatureUnit |
value | the dew point. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_apparent ()

    gboolean
    gweather_info_get_value_apparent (GWeatherInfo *info,
                                      GWeatherTemperatureUnit unit,
                                      gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherTemperatureUnit |
value | the apparent temperature. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_wind ()

    gboolean
    gweather_info_get_value_wind (GWeatherInfo *info,
                                  GWeatherSpeedUnit unit,
                                  gdouble *speed,
                                  GWeatherWindDirection *direction);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherSpeedUnit |
speed | forecasted wind speed. | [out]
direction | forecasted wind direction. | [out]

#### Returns

TRUE if `speed` and `direction` are valid, FALSE otherwise.

### gweather_info_get_value_pressure ()

    gboolean
    gweather_info_get_value_pressure (GWeatherInfo *info,
                                      GWeatherPressureUnit unit,
                                      gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherPressureUnit |
value | forecasted pressure, expressed in `unit` . | [out]

#### Returns

TRUE if `value` is valid, FALSE otherwise.

### gweather_info_get_value_visibility ()

    gboolean
    gweather_info_get_value_visibility (GWeatherInfo *info,
                                        GWeatherDistanceUnit unit,
                                        gdouble *value);

#### Parameters

info | a GWeatherInfo |
unit | the desired unit, as a GWeatherDistanceUnit |
value | forecasted visibility, expressed in `unit` . | [out]

#### Returns

TRUE if `value` is valid, FALSE otherwise.

### gweather_info_get_value_sunrise ()

    gboolean
    gweather_info_get_value_sunrise (GWeatherInfo *info,
                                     time_t *value);

#### Parameters

info | a GWeatherInfo |
value | the time of sunrise. | [out][type gulong]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_value_sunset ()

    gboolean
    gweather_info_get_value_sunset (GWeatherInfo *info,
                                    time_t *value);

#### Parameters

info | a GWeatherInfo |
value | the time of sunset. | [out][type gulong]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_next_sun_event ()

    gint
    gweather_info_next_sun_event (GWeatherInfo *info);

### gweather_info_get_value_moonphase ()

    gboolean
    gweather_info_get_value_moonphase (GWeatherInfo *info,
                                       GWeatherMoonPhase *value,
                                       GWeatherMoonLatitude *lat);

#### Parameters

info | a GWeatherInfo |
value | the current moon phase. | [out]
lat | the moon declension. | [out]

#### Returns

TRUE is `value` is valid, FALSE otherwise.

### gweather_info_get_upcoming_moonphases ()

    gboolean
    gweather_info_get_upcoming_moonphases (GWeatherInfo *info,
                                           time_t *phases);

#### Parameters

info | a GWeatherInfo containing the time_t of interest |
phases | An array of four time_t values that will hold the returned values. The values are estimates of the time of the next new, quarter, full and three-quarter moons. | [out][array fixed-size=4][element-type gulong]

#### Returns

gboolean indicating success or failure

### gweather_info_is_daytime ()

    gboolean
    gweather_info_is_daytime (GWeatherInfo *info);

#### Parameters

info | a GWeatherInfo |

#### Returns

Whether it is daytime (that is, if the sun is visible) or not at the location and the point of time referred by `info` . This is mostly equivalent to comparing the return value of `gweather_info_get_value_sunrise()` and `gweather_info_get_value_sunset()`, but it accounts also for midnight sun and polar night, for locations within the Artic and Antartic circles.

## Types and Values

### enum GWeatherProvider

#### Members

GWEATHER_PROVIDER_NONE | no provider, no weather information available |
GWEATHER_PROVIDER_METAR | METAR office, providing current conditions worldwide |
GWEATHER_PROVIDER_IWIN | US weather office, providing 7 days of forecast |
GWEATHER_PROVIDER_YAHOO | Yahoo Weather Service, worldwide but non commercial only |
GWEATHER_PROVIDER_YR_NO | Yr.no service, worldwide but requires attribution |
GWEATHER_PROVIDER_OWM | OpenWeatherMap, worldwide and possibly more reliable, but requires attribution and is limited in the number of queries |
GWEATHER_PROVIDER_ALL | enable all available providers |

### enum GWeatherConditionPhenomenon

The current or forecasted significant phenomenon.

#### Members

GWEATHER_PHENOMENON_INVALID | value not available |
GWEATHER_PHENOMENON_NONE | no significant phenomenon |
GWEATHER_PHENOMENON_DRIZZLE |  |
GWEATHER_PHENOMENON_RAIN |  |
GWEATHER_PHENOMENON_SNOW |  |
GWEATHER_PHENOMENON_SNOW_GRAINS |  |
GWEATHER_PHENOMENON_ICE_CRYSTALS |  |
GWEATHER_PHENOMENON_ICE_PELLETS |  |
GWEATHER_PHENOMENON_HAIL |  |
GWEATHER_PHENOMENON_SMALL_HAIL |  |
GWEATHER_PHENOMENON_UNKNOWN_PRECIPITATION |  |
GWEATHER_PHENOMENON_MIST |  |
GWEATHER_PHENOMENON_FOG |  |
GWEATHER_PHENOMENON_SMOKE |  |
GWEATHER_PHENOMENON_VOLCANIC_ASH |  |
GWEATHER_PHENOMENON_SAND |  |
GWEATHER_PHENOMENON_HAZE |  |
GWEATHER_PHENOMENON_SPRAY |  |
GWEATHER_PHENOMENON_DUST |  |
GWEATHER_PHENOMENON_SQUALL |  |
GWEATHER_PHENOMENON_SANDSTORM |  |
GWEATHER_PHENOMENON_DUSTSTORM |  |
GWEATHER_PHENOMENON_FUNNEL_CLOUD |  |
GWEATHER_PHENOMENON_TORNADO |  |
GWEATHER_PHENOMENON_DUST_WHIRLS |  |
GWEATHER_PHENOMENON_LAST |  |

### enum GWeatherConditionQualifier

An additional modifier applied to a GWeatherConditionPhenomenon to describe the current or forecasted weather conditions. The exact meaning of each qualifier is described at http://www.weather.com/glossary/ and http://www.crh.noaa.gov/arx/wx.tbl.php

#### Members

GWEATHER_QUALIFIER_INVALID | value not available |
GWEATHER_QUALIFIER_NONE | no qualifier for the phenomenon |
GWEATHER_QUALIFIER_VICINITY | phenomenon happening in the proximity of the location, not in the actual location |
GWEATHER_QUALIFIER_LIGHT | phenomenon is light or predicted to be light |
GWEATHER_QUALIFIER_MODERATE | phenomenon is moderate or predicted to be moderate |
GWEATHER_QUALIFIER_HEAVY | phenomenon is heavy or predicted to be heavy |
GWEATHER_QUALIFIER_SHALLOW | shallow fog (only valid with `GWEATHER_PHENOMENON_FOG`) |
GWEATHER_QUALIFIER_PATCHES | patches of fog (only valid with `GWEATHER_PHENOMENON_FOG`) |
GWEATHER_QUALIFIER_PARTIAL | partial fog (only valid with `GWEATHER_PHENOMENON_FOG`) |
GWEATHER_QUALIFIER_THUNDERSTORM | phenomenon will be a thunderstorm and/or will include lightning |
GWEATHER_QUALIFIER_BLOWING | phenomenon is blowing (valid with `GWEATHER_PHENOMENON_SNOW`, `GWEATHER_PHENOMENON_SAND`, `GWEATHER_PHENOMENON_SPRAY`, `GWEATHER_PHENOMENON_DUST`) |
GWEATHER_QUALIFIER_SHOWERS | phenomenon is heavy and involves showers |
GWEATHER_QUALIFIER_DRIFTING | phenomenon is moving across (valid with `GWEATHER_PHENOMENON_SAND` and `GWEATHER_PHENOMENON_DUST`) |
GWEATHER_QUALIFIER_FREEZING | phenomenon is freezing and involves ice |
GWEATHER_QUALIFIER_LAST | maximum value of the enumeration. |

### struct GWeatherConditions

    struct GWeatherConditions {
        gboolean significant;
        GWeatherConditionPhenomenon phenomenon;
        GWeatherConditionQualifier qualifier;
    };

A convenient way to describe the current or forecast weather phenomenon, if significant, and its associated modifier. If the value is not significant, the weather conditions are described by `gweather_info_get_sky()` instead.

In general it is discouraged to use this value directly to compute the forecast icon: applications should instead use `gweather_info_get_icon_name()` or `gweather_info_get_symbolic_icon_name()`.

#### Members

gboolean `significant`; | `TRUE` if the struct contains usable data, `FALSE` otherwise |
GWeatherConditionPhenomenon `phenomenon`; | the main weather phenomenon |
GWeatherConditionQualifier `qualifier`; | a modifier for `phenomenon` |

### enum GWeatherSky

The sky and cloud visibility. In general it is discouraged to use this value directly to compute the forecast icon: applications should instead use `gweather_info_get_icon_name()` or `gweather_info_get_symbolic_icon_name()`.

#### Members

GWEATHER_SKY_INVALID | value not available |
GWEATHER_SKY_CLEAR | sky completely clear, no clouds visible |
GWEATHER_SKY_BROKEN | sky mostly clear, few clouds |
GWEATHER_SKY_SCATTERED | sky mostly clear, patches of clouds |
GWEATHER_SKY_FEW | few clouds, sky cloudy but patches of sky visible |
GWEATHER_SKY_OVERCAST | sky completely clouded, sun not visible |
GWEATHER_SKY_LAST | the maximum value for the enumeration |

### enum GWeatherWindDirection

The direction of the prevailing wind. Composite values such as north-north-east indicate a direction between the two component value (north and north-east).

#### Members

GWEATHER_WIND_INVALID | value not available |
GWEATHER_WIND_VARIABLE | variable throughout the day |
GWEATHER_WIND_N | north |
GWEATHER_WIND_NNE | north-north-east |
GWEATHER_WIND_NE | north-east |
GWEATHER_WIND_ENE | east-north-east |
GWEATHER_WIND_E | east |
GWEATHER_WIND_ESE | east-south-east |
GWEATHER_WIND_SE | south-east |
GWEATHER_WIND_SSE | south-south-east |
GWEATHER_WIND_S | south |
GWEATHER_WIND_SSW | south-south-west |
GWEATHER_WIND_SW | south-west |
GWEATHER_WIND_WSW | west-south-west |
GWEATHER_WIND_W | west |
GWEATHER_WIND_WNW | west-north-west |
GWEATHER_WIND_NW | north-west |
GWEATHER_WIND_NNW | north-north-west |
GWEATHER_WIND_LAST | maximum value for the enumeration |

### GWeatherMoonLatitude

    typedef gdouble GWeatherMoonLatitude;

The moon declension, in degrees.

### GWeatherMoonPhase

    typedef gdouble GWeatherMoonPhase;

The current phase of the moon, represented as degrees, where 0 is the new moon, 90 is the first quarter, etc.

### enum GWeatherDistanceUnit

The measure unit to use for sky visibility values, when retrieved by `gweather_info_get_value_visibility()`.

#### Members

GWEATHER_DISTANCE_UNIT_INVALID | invalid unit |
GWEATHER_DISTANCE_UNIT_DEFAULT | the user preferred distance unit |
GWEATHER_DISTANCE_UNIT_METERS | meters |
GWEATHER_DISTANCE_UNIT_KM | kilometers (= 1000 meters) |
GWEATHER_DISTANCE_UNIT_MILES | miles |

### enum GWeatherPressureUnit

The measure unit to use for atmospheric pressure values, when retrieved by `gweather_info_get_value_pressure()`.

#### Members

GWEATHER_PRESSURE_UNIT_INVALID | invalid unit |
GWEATHER_PRESSURE_UNIT_DEFAULT | the user preferred pressure unit |
GWEATHER_PRESSURE_UNIT_KPA | kiloPascal (* 10^3 Pa) |
GWEATHER_PRESSURE_UNIT_HPA | hectoPascal (* 10^2 Pa); also known as millibars, but formatted differently |
GWEATHER_PRESSURE_UNIT_MB | millibars; same as `GWEATHER_PRESSURE_UNIT_HPA` |
GWEATHER_PRESSURE_UNIT_MM_HG | millimiters of mercury |
GWEATHER_PRESSURE_UNIT_INCH_HG | inches of mercury |
GWEATHER_PRESSURE_UNIT_ATM | atmospheres |

### enum GWeatherSpeedUnit

The measure unit to use for wind speed values, when retrieved by `gweather_info_get_value_wind()`.

#### Members

GWEATHER_SPEED_UNIT_INVALID | invalid unit |
GWEATHER_SPEED_UNIT_DEFAULT | the user preferred speed unit |
GWEATHER_SPEED_UNIT_MS | meters per second |
GWEATHER_SPEED_UNIT_KPH | kilometers per hour |
GWEATHER_SPEED_UNIT_MPH | miles per hour |
GWEATHER_SPEED_UNIT_KNOTS | knots |
GWEATHER_SPEED_UNIT_BFT | Beaufort scale |

### enum GWeatherTemperatureUnit

The measure unit to use for temperature values, when retrieved by the `gweather_info_get_value_temp()` family of functions.

#### Members

GWEATHER_TEMP_UNIT_INVALID | invalid unit |
GWEATHER_TEMP_UNIT_DEFAULT | the user preferred temperature unit |
GWEATHER_TEMP_UNIT_KELVIN | Kelvin (absolute) temperature scale |
GWEATHER_TEMP_UNIT_CENTIGRADE | Celsius temperature scale |
GWEATHER_TEMP_UNIT_FAHRENHEIT | Fahrenheit temperature scale |

### enum GWeatherForecastType

#### Members

GWEATHER_FORECAST_STATE |  |
GWEATHER_FORECAST_ZONE |  |
GWEATHER_FORECAST_LIST |  |

## Property Details

### The `“enabled-providers”` property

      “enabled-providers”        GWeatherProvider

A bitmask of enabled weather service providers.

Flags: Read / Write

Default value: GWEATHER_PROVIDER_METAR | GWEATHER_PROVIDER_IWIN

### The `“location”` property

      “location”                 GWeatherLocation *

The location this info represents.

Flags: Read / Write / Construct

## Signal Details

### The `“updated”` signal

    void
    user_function (GWeatherInfo *object,
                   gpointer      user_data)

This signal is emitted after the initial fetch of the weather data from upstream services, and after every successful call to ``gweather_info_update()`` .

#### Parameters

object | the emitter of the signal. |
user_data | user data set when the signal handler was connected. |

Flags: Run First