gweather_info_new ()

GWeatherInfo *
gweather_info_new (GWeatherLocation *location);

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

Since version 40, this does not automatically call gweather_info_update(). gweather_info_update() must be called manually once all the necessary set up has been made, such as setting the enabled providers.

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.

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.

gweather_info_get_forecast_list ()

GSList *
gweather_info_get_forecast_list (GWeatherInfo *info);

gweather_info_get_enabled_providers ()

GWeatherProvider
gweather_info_get_enabled_providers (GWeatherInfo *info);

Gets the bitmask of enabled GWeatherProvider weather providers.

gweather_info_set_enabled_providers ()

void
gweather_info_set_enabled_providers (GWeatherInfo *info,
                                     GWeatherProvider providers);

Sets the enabled providers for fetching the weather. Note that it is up to the application developer to make sure that the terms of use for each service are respected.

Online providers will not be enabled if the application ID is not set to a valid value.

gweather_info_get_application_id ()

const char *
gweather_info_get_application_id (GWeatherInfo *info);

Get the application ID of the application fetching the weather.

gweather_info_set_application_id ()

void
gweather_info_set_application_id (GWeatherInfo *info,
                                  const char *application_id);

Sets the application ID of the application fetching the weather. It is a requirement for using any of the online weather providers.

If the application uses GApplication, then the application ID will be automatically filled in.

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.

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);

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);

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_speed_unit_to_string ()

const gchar *
gweather_speed_unit_to_string (GWeatherSpeedUnit unit);

Creates a human-readable, localized representation of unit

gweather_info_get_value_update ()

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

Note that value may be 0 if info has not yet been updated.

gweather_info_get_value_sky ()

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

Fills out sky with current sky conditions.

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.

gweather_info_get_value_temp ()

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

gweather_info_get_value_temp_min ()

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

gweather_info_get_value_temp_max ()

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

gweather_info_get_value_dew ()

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

gweather_info_get_value_apparent ()

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

gweather_info_get_value_wind ()

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

gweather_info_get_value_pressure ()

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

gweather_info_get_value_visibility ()

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

gweather_info_get_value_sunrise ()

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

gweather_info_get_value_sunset ()

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

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);

gweather_info_get_upcoming_moonphases ()

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

gweather_info_is_daytime ()

gboolean
gweather_info_is_daytime (GWeatherInfo *info);

enum GWeatherProvider

enum GWeatherConditionPhenomenon

The current or forecasted significant phenomenon.

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

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().

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().

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).

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().

enum GWeatherPressureUnit

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

enum GWeatherSpeedUnit

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

enum GWeatherTemperatureUnit

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

The “application-id” property

  “application-id”           char *

An unique reverse-DNS application ID.

Owner: GWeatherInfo

Flags: Read / Write

Default value: NULL

The “contact-info” property

  “contact-info”             char *

An email address or contact form URL.

Owner: GWeatherInfo

Flags: Read / Write

Default value: NULL

The “enabled-providers” property

  “enabled-providers”        GWeatherProvider

A bitmask of enabled weather service providers.

Owner: GWeatherInfo

Flags: Read / Write

The “location” property

  “location”                 GWeatherLocation *

The location this info represents.

Owner: GWeatherInfo

Flags: Read / Write / Construct

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() .

Flags: Run First