File	Doc	Category	Size	Date	Package
City.java	API Doc	Android 1.5 API	7627	Wed May 06 22:41:08 BST 2009	com.android.globaltime

City

• java.lang.Object

Fields Summary
private static Map	cities
private static City[]	citiesByRawOffset
private String	name
private String	timeZoneID
private TimeZone	timeZone
private int	rawOffset
private float	latitude
private float	longitude
private float	x
private float	y
private float	z

Constructors Summary

public City(String name, String timeZoneID, int rawOffset, float latitude, float longitude, float x, float y, float z) Constructs a city with the given name, time zone name, raw offset, latitude, longitude, and 3D (X, Y, Z) coordinate. this.name = name; this.timeZoneID = timeZoneID; this.rawOffset = rawOffset; this.latitude = latitude; this.longitude = longitude; this.x = x; this.y = y; this.z = z;

Methods Summary
public int	compareTo(com.android.globaltime.City o) Compares this city to another by name. return name.compareTo(o.name);
public static com.android.globaltime.City[]	getCitiesByName() Returns the cities, ordered by name. City[] ocities = new City[cities.size()]; Iterator<City> iter = cities.values().iterator(); int idx = 0; while (iter.hasNext()) { ocities[idx++] = iter.next(); } Arrays.sort(ocities); return ocities;
public static com.android.globaltime.City[]	getCitiesByOffset() Returns the cities, ordered by offset, accounting for summer/daylight savings time. This requires reading the entire time zone database behind the scenes. City[] ocities = new City[cities.size()]; Iterator<City> iter = cities.values().iterator(); int idx = 0; while (iter.hasNext()) { ocities[idx++] = iter.next(); } Arrays.sort(ocities, new Comparator() { public int compare(Object o1, Object o2) { long now = System.currentTimeMillis(); City c1 = (City)o1; City c2 = (City)o2; TimeZone tz1 = c1.getTimeZone(); TimeZone tz2 = c2.getTimeZone(); int off1 = tz1.getOffset(now); int off2 = tz2.getOffset(now); if (off1 == off2) { float dlat = c2.getLatitude() - c1.getLatitude(); if (dlat < 0.0f) return -1; if (dlat > 0.0f) return 1; return 0; } return off1 - off2; } }); return ocities;
public static com.android.globaltime.City[]	getCitiesByRawOffset() Returns the cities, ordered by offset, accounting for summer/daylight savings time. This does not require reading the time zone database since the cities are pre-sorted. return citiesByRawOffset;
public float	getLatitude() return latitude;
public float	getLongitude() return longitude;
public java.lang.String	getName() return name;
public float	getOffset() Returns this city's offset from UTC, taking summer/daylight savigns time into account. long now = System.currentTimeMillis(); if (timeZone == null) { timeZone = TimeZone.getTimeZone(timeZoneID); } return timeZone.getOffset(now) / 3600000.0f;
public float	getRawOffset() return rawOffset / 3600000.0f;
public int	getRawOffsetMillis() return rawOffset;
public java.util.TimeZone	getTimeZone() if (timeZone == null) { timeZone = TimeZone.getTimeZone(timeZoneID); } return timeZone;
public float	getX() return x;
public float	getY() return y;
public float	getZ() return z;
public static java.util.Iterator	iterator() Returns an Iterator over all cities, in raw offset order. return cities.values().iterator();
public static void	loadCities(java.io.InputStream is) Loads the city database. The cities must be stored in order by raw offset from UTC. DataInputStream dis = new DataInputStream(is); int numCities = dis.readInt(); citiesByRawOffset = new City[numCities]; byte[] buf = new byte[24]; for (int i = 0; i < numCities; i++) { String name = dis.readUTF(); String tzid = dis.readUTF(); dis.read(buf); // The code below is a faster version of: // int rawOffset = dis.readInt(); // float latitude = dis.readFloat(); // float longitude = dis.readFloat(); // float cx = dis.readFloat(); // float cy = dis.readFloat(); // float cz = dis.readFloat(); int rawOffset = (buf[ 0] << 24) | ((buf[ 1] & 0xff) << 16) | ((buf[ 2] & 0xff) << 8) | (buf[ 3] & 0xff); int ilat = (buf[ 4] << 24) | ((buf[ 5] & 0xff) << 16) | ((buf[ 6] & 0xff) << 8) | (buf[ 7] & 0xff); int ilon = (buf[ 8] << 24) | ((buf[ 9] & 0xff) << 16) | ((buf[10] & 0xff) << 8) | (buf[11] & 0xff); int icx = (buf[12] << 24) | ((buf[13] & 0xff) << 16) | ((buf[14] & 0xff) << 8) | (buf[15] & 0xff); int icy = (buf[16] << 24) | ((buf[17] & 0xff) << 16) | ((buf[18] & 0xff) << 8) | (buf[19] & 0xff); int icz = (buf[20] << 24) | ((buf[21] & 0xff) << 16) | ((buf[22] & 0xff) << 8) | (buf[23] & 0xff); float latitude = Float.intBitsToFloat(ilat); float longitude = Float.intBitsToFloat(ilon); float cx = Float.intBitsToFloat(icx); float cy = Float.intBitsToFloat(icy); float cz = Float.intBitsToFloat(icz); City city = new City(name, tzid, rawOffset, latitude, longitude, cx, cy, cz); cities.put(name, city); citiesByRawOffset[i] = city; }
public static int	numCities() Returns the total number of cities. return cities.size();