The format of Locations.xml[.in] is something like this: <_name>North America <_name>United States US <_name>Alabama America/Chicago <_name>Alabaster KEET ALZ019 bhm 33-10-42N 086-46-54W <_name>Mobile <_name>Mobile Downtown Airport KBFM ALZ061 bix 30-36-50N 088-03-48W ... Most of the data in the file appears inside entries. However, various larger geographic divisions exist to make things easier for both users and maintainers. At the top level are s. These mostly correspond to continents, but not entirely. They are arbitrary, and could be changed in the future if we wanted. Each is divided into s. Every internationally- recognized country for which at least one is defined should have its own . For the most part, "dependencies", "territories", "protectorates" and the like are listed as s within their ruling country if they are in the same , but separately if they are in a different . This is not followed 100% consistently. Every must have an tag giving its ISO 3166-1 alpha-2 code. Sub-country s can also specify their own if they have one. A MAY specify a , giving the default time zone name for the country. Countries that only have one timezone (or where the majority of the country is covered by a single timezone) should list it at the level. Countries with multiple timezones and no obvious "default" should not list anything here. (See README.timezones for more information about timezones in Locations.xml.) A can contain s and s directly, or can be split into s which contain s and s. The name "state" comes from the US states, but it can be used to represent any sort of well-defined sub-country region that has a name which will be familiar to local users. A may specify a which will override the 's for s within the state. is an optional element used to group together multiple s within the same city. Finally, a represents a location for which weather data can be retrieved. Its fields are: <_name> - required, the name of the location - optional, the ISO 3166 code of the location, if not the same as its parent - optional, the timezone of the location, if not the same as its parent or - required, the METAR code identifying this location - optional, secondary weather source information: US: the NOAA IWIN zone UK: the Met Office region name, prefixed with ":" AU: the BOM forecast name, prefixed with "@" - optional, the Weather.com radar map name for the location (North America only) - optional, the latitude and longitude of the location, as "[-]ddd.dddddd [-]ddd.dddddd" Positive values are North and East respectively, negative values are South and West.