Class Location

Initialise a new Location object

>>> Location(2636782, "Stotfold", "Stotfold", None, 52.0, -0.2166667,
...          "P", "PPL", "GB", None, "F8", None, None, None, 6245,
...          None, 77, "Europe/London", datetime.date(2007, 6, 15), 0)
Location(2636782, 'Stotfold', 'Stotfold', None, 52.0, -0.2166667, 'P',
         'PPL', 'GB', None, 'F8', None, None, None, 6245, None, 77,
         'Europe/London', datetime.date(2007, 6, 15), 0)

Parameters:

• geonameid (int) - ID of record in geonames database
• name (Unicode str) - Name of geographical location
• asciiname (str) - Name of geographical location in ASCII encoding
• alt_names (list of Unicode str) - Alternate names for the location
• latitude (float) - Location's latitude
• longitude (float) - Location's longitude
• feature_class (str) - Location's type
• feature_code (str) - Location's code
• country (str) - Location's country
• alt_country (str) - Alternate country codes for location
• admin1 (str) - FIPS code (subject to change to ISO code), ISO code for the US and CH
• admin2 (str) - Code for the second administrative division, a county in the US
• admin3 (str) - Code for third level administrative division
• admin4 (str) - Code for fourth level administrative division
• population (int) - Location's population, if applicable
• altitude (int) - Location's elevation
• gtopo30 (int) - Average elevation of 900 square metre region, if available
• tzname (str) - The timezone identifier using POSIX timezone names
• modified_date (datetime.date) - Location's last modification date in the geonames databases
• timezone (int) - The non-DST timezone offset from UTC in minutes

Raises:

• ValueError - Unknown value for angle
• ValueError - Unknown value for units
• ValueError - Invalid value for latitude or longitude

Overrides: object.__init__

Pretty printed location string

>>> Stotfold = Location(2636782, "Stotfold", "Stotfold", None, 52.0,
...                     -0.2166667, "P", "PPL", "GB", None, "F8", None,
...                     None, None, 6245, None, 77, "Europe/London",
...                     datetime.date(2007, 6, 15))
>>> print(Stotfold)
Stotfold (N52.000°; W000.217°)
>>> print(Stotfold.__str__(mode="dms"))
Stotfold (52°00'00"N, 000°13'00"W)
>>> print(Stotfold.__str__(mode="dm"))
Stotfold (52°00.00'N, 000°13.00'W)
>>> Stotfold.alt_names = ["Home", "Target"]
>>> print(Stotfold)
Stotfold (Home, Target - N52.000°; W000.217°)

Parameters:

• mode (str) - Coordinate formatting system to use

Returns: str

Human readable string representation of Location object

Raises:

• ValueError - Unknown value for mode

Overrides: object.__str__