libcityinfo Documentation

0.2.0

Author:

Dariusz Wiechecki [email protected]

Copyright

City database and cityinfo library are:
Copyright (C) 2008 Nokia. All rights reserved.

Introduction

Cityinfo library allows to get some informations about set of cities from all over the world. Each city is connected with one timezone (related to standard linux time zone database) so You can get local time in given city by calling functions from libtime (clockd) library.

Database

You can get informations such as:

• city name
• country name (in which the city is placed)
• country code
• time zone
• geographical position
• position on the map*
• locale used in country

All informations You get from library are already localized according to currently set language on the system (city and country names).

ASCII art diagram of database record/fields:

raw data:
"id|city_name|country_code|country_name|linux_timezone|lat|lng|x_position|y_position|locale"

example of raw data from file:
"0|osso_db_city_abu_dhabi|AE|osso_db_country_united_arab_emirates|Asia/Muscat|0|0|0.623333|0.488400|ar_AE"

logic view:
+---+-----+-------------+-------------+---------------+----------+-----------+----------------------+----------------------+-----------------------+
|id |city |country code |country name |linux timezone |latitiude |longtidute |X postion on the map* |Y postion on the map* |locale used in country |
+---+-----+-------------+-------------+---------------+----------+-----------+----------------------+----------------------+-----------------------+

*) positions on the map are in relative coordinates (0.0 - most left/top to 1.0 most right/bottom) and are synchronized with Clock's world map image.

SVN

All source code is stored in subversion repository fmca, subdirectory Clock, component cityinfo.