KDE 4.9 PyKDE API Reference
GeoDataPlacemark Class Reference
from PyKDE4.marble import *
Inherits: Marble.GeoDataFeature → Marble.GeoDataObject → Marble.GeoNode
Namespace: Marble
Detailed Description
a class representing a point of interest on the map
This class represents a point of interest, e.g. a city or a mountain. It is filled with data by the KML or GPX loader and the PlacemarkModel makes use of it.
A Placemark can have an associated geometry which will be rendered to the map along with the placemark's point icon. If you would like to render more than one geometry for any one placemark than use
- See also:
- setGeometry() to set add a
- See also:
- MultiGeometry.
This is more or less only a GeoDataFeature with a geographic position and a country code attached to it. The country code is not provided in a KML file.
Methods | |
| __init__ (self) | |
| __init__ (self, Marble.GeoDataPlacemark placemark) | |
| __init__ (self, QString name) | |
| float | area (self) |
| Marble.GeoDataCoordinates | coordinate (self, QDateTime dateTime=QDateTime(), bool iconAtCoordinates=0) |
| QString | countryCode (self) |
| Marble.GeoDataGeometry | geometry (self) |
| Marble.GeoDataLookAt | lookAt (self) |
| QXmlStreamWriter | operator << (self, QXmlStreamWriter stream) |
| bool | operator == (self, Marble.GeoDataPlacemark other) |
| pack (self, QDataStream stream) | |
| QXmlStreamWriter | pack (self, QXmlStreamWriter stream) |
| long | population (self) |
| setArea (self, float area) | |
| setCoordinate (self, float longitude, float latitude, float altitude=0, Marble.GeoDataCoordinates.Unit _unit=Marble.GeoDataPoint.Radian) | |
| setCoordinate (self, Marble.GeoDataPoint point) | |
| setCountryCode (self, QString code) | |
| setGeometry (self, Marble.GeoDataGeometry entry) | |
| setLookAt (self, Marble.GeoDataLookAt lookAt) | |
| setPopulation (self, long population) | |
| setState (self, QString state) | |
| QString | state (self) |
| unpack (self, QDataStream stream) | |
Method Documentation
| __init__ | ( | self ) |
Create a new placemark.
| __init__ | ( | self, | ||
| Marble.GeoDataPlacemark | placemark | |||
| ) |
Create a new placemark from existing placemark placemark
| __init__ | ( | self, | ||
| QString | name | |||
| ) |
Create a new placemark with the given name.
| float area | ( | self ) |
Return the area size of the feature in square km.
FIXME: Once we make Marble more area-aware we need to move this into the GeoDataArea class which will get inherited from GeoDataPlacemark (or GeoDataFeature).
| Marble.GeoDataCoordinates coordinate | ( | self, | ||
| QDateTime | dateTime=QDateTime(), | |||
| bool | iconAtCoordinates=0 | |||
| ) |
Return the coordinates of the placemark as longitude, latitude and altitude.
| QString countryCode | ( | self ) |
Return the country code of the placemark.
| Marble.GeoDataGeometry geometry | ( | self ) |
The geometry of the GeoDataPlacemark is to be rendered to the marble map along with the icon at the coordinate associated with this Placemark.
- Returns:
- a pointer to the current Geometry object
| Marble.GeoDataLookAt lookAt | ( | self ) |
Returns GeoDataLookAt object if lookAt is setup earlier otherwise It will convert GeoDataCoordinates of Placemark to GeoDataLookAt with range equals to altitude of GeoDataCoordinate
| QXmlStreamWriter operator << | ( | self, | ||
| QXmlStreamWriter | stream | |||
| ) |
| bool operator == | ( | self, | ||
| Marble.GeoDataPlacemark | other | |||
| ) |
comparison operator is implemented slightly different than one would expect. Only Placemarks that are copies of each other are assumed to be equal.
| pack | ( | self, | ||
| QDataStream | stream | |||
| ) |
Serialise this Placemark to a XML stream writer
- See also:
- QXmlStreamWriter in the Qt documentation for more info. This will output the XML representation of this Placemark. The default XML format is KML, to have other formats supported you need to create a subclass and override this method.
- Parameters:
-
stream the XML Stream Reader to output to.
| QXmlStreamWriter pack | ( | self, | ||
| QXmlStreamWriter | stream | |||
| ) |
Serialise this Placemark to a XML stream writer
- See also:
- QXmlStreamWriter in the Qt documentation for more info. This will output the XML representation of this Placemark. The default XML format is KML, to have other formats supported you need to create a subclass and override this method.
- Parameters:
-
stream the XML Stream Reader to output to.
| long population | ( | self ) |
Return the population of the placemark.
| setArea | ( | self, | ||
| float | area | |||
| ) |
Set the area size of the feature in square km.
| setCoordinate | ( | self, | ||
| float | longitude, | |||
| float | latitude, | |||
| float | altitude=0, | |||
| Marble.GeoDataCoordinates.Unit | _unit=Marble.GeoDataPoint.Radian | |||
| ) |
Set the coordinate of the placemark with an GeoDataPoint.
| setCoordinate | ( | self, | ||
| Marble.GeoDataPoint | point | |||
| ) |
Set the coordinate of the placemark with an GeoDataPoint.
| setCountryCode | ( | self, | ||
| QString | code | |||
| ) |
Set the country code of the placemark.
| setGeometry | ( | self, | ||
| Marble.GeoDataGeometry | entry | |||
| ) |
Sets the current Geometry of this Placemark.
- See also:
- geometry() and the class
overview for description of the geometry concept. The geometry can be set
to any
- See also:
- GeoDataGeometry like
- See also:
- GeoDataPoint,@see GeoDataLineString,
- See also:
- GeoDataLinearRing and
- See also:
- GeoDataMultiGeometry
| setLookAt | ( | self, | ||
| Marble.GeoDataLookAt | lookAt | |||
| ) |
Set lookAt GeoDataLookAt
| setPopulation | ( | self, | ||
| long | population | |||
| ) |
Sets the population of the placemark.
- Parameters:
-
population the new population value
| setState | ( | self, | ||
| QString | state | |||
| ) |
Set the state state of the placemark.
| QString state | ( | self ) |
Return the state of the placemark.
| unpack | ( | self, | ||
| QDataStream | stream | |||
| ) |
Deserialize the Placemark from a data stream. This has the opposite effect from
- See also:
- pack()
- Parameters:
-
stream the QDataStream to deserialise from.
