Stellarium  0.17.0
Public Member Functions | Static Public Member Functions | Data Fields | Static Public Attributes
StelLocation Class Reference

Store the informations for a location on a planet.

#include <StelLocation.hpp>

Public Member Functions

QString getID () const
 Return a short string which can be used in a list view.
bool isValid () const
QString serializeToLine () const
 Output the location as a string ready to be stored in the user_location file.

Static Public Member Functions

static StelLocation createFromLine (const QString &line)
 Parse a location from a line serialization.
static float distanceDegrees (const float long1, const float lat1, const float long2, const float lat2)
 Compute great-circle distance between two locations.

Data Fields

QString name
 Location/city name.
QString country
 English country name or empty string.
QString state
 State/region name (useful if 2 locations of the same country have the same name)
QString planetName
 English planet name.
float longitude
 Longitude in degree.
float latitude
 Latitude in degree.
int altitude
 Altitude in meter.
float bortleScaleIndex
 Light pollution index following Bortle scale.
QString landscapeKey
 A hint for associating a landscape to the location.
int population
 Population in number of inhabitants.
QChar role
 Location role code. More...
QString ianaTimeZone
 IANA identificator of time zone. More...
bool isUserLocation
 Used privately by the StelLocationMgr.

Static Public Attributes


Field Documentation

QString StelLocation::ianaTimeZone

Note that timezone names under various OSes may be different than those used in Stellarium's location database (e.g. Ubuntu:Asia/Kolkata=Windows:Asia/Calcutta), which requires some translation effort during the loading process.

QChar StelLocation::role

Possible values:

  • C or B is a capital city
  • R is a regional capital
  • N is a normal city (any other type of settlement)
  • O is an observatory
  • L is a spacecraft lander
  • I is a spacecraft impact
  • A is a spacecraft crash
  • X is an unknown or user-defined location (the default value).
  • ! is an invalid location.