Method
GWeatherLocationfind_nearest_city_full
Declaration [src]
GWeatherLocation*
gweather_location_find_nearest_city_full (
GWeatherLocation* loc,
double lat,
double lon,
GWeatherFilterFunc func,
gpointer user_data,
GDestroyNotify destroy
)
Description [src]
Finds the nearest city to the passed latitude and
longitude, among the descendants of loc.
Supports the use of own filter function to filter out locations.
Geocoding should be done on the application side if needed.
loc must be at most a GWEATHER_LOCATION_ADM1 location.
This restriction may be lifted in a future version.
Parameters
lat |
double |
Latitude, in degrees. |
|
lon |
double |
Longitude, in degrees. |
|
func |
GWeatherFilterFunc |
A function to iterate
over the locations; the function must return |
|
The argument can be NULL. | |
user_data |
gpointer |
For customization. |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
destroy |
GDestroyNotify |
To destroy user_data. |
Return value
| Returns: | GWeatherLocation |
The city closest to ( |
|
| The caller of the method takes ownership of the data, and is responsible for freeing it. |