Marble.MarbleRunnerManager

KDE 4.9 PyKDE API Reference

- KDE's Python API

# MarbleRunnerManager Class Reference

`from PyKDE4.marble import *`

Inherits: QObject
Namespace: Marble

## Detailed Description

## Signals
| parsingFinished (Marble.GeoDataDocument document, QString error=QString())
| parsingFinished ()
| placemarkSearchFinished ()
| reverseGeocodingFinished (Marble.GeoDataCoordinates coordinates, Marble.GeoDataPlacemark placemark)
| reverseGeocodingFinished ()
| routeRetrieved (Marble.GeoDataDocument route)
| routingFinished ()
| searchFinished (QString searchTerm)
| searchResultChanged (QAbstractItemModel model)
## Methods
| findPlacemarks (self, QString searchTerm, Marble.GeoDataLatLonAltBox preferred=Marble.GeoDataLatLonAltBox())
Marble.GeoDataDocument | openFile (self, QString fileName, Marble.DocumentRole role=Marble.UserDocument)
| parseFile (self, QString fileName, Marble.DocumentRole role=Marble.UserDocument)
| retrieveRoute (self, Marble.RouteRequest request)
| reverseGeocoding (self, Marble.GeoDataCoordinates coordinates)
QString | searchReverseGeocoding (self, Marble.GeoDataCoordinates coordinates)
| setModel (self, Marble.MarbleModel model)

## Signal Documentation

parsingFinished | ( | Marble.GeoDataDocument | document,
|  | QString | error=QString()
| ) |  |  |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("parsingFinished(Marble::GeoDataDocument*, const QString&)"), target_slot)`

parsingFinished | ( |  | ) |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("parsingFinished()"), target_slot)`

placemarkSearchFinished | ( |  | ) |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("placemarkSearchFinished()"), target_slot)`

reverseGeocodingFinished | ( | Marble.GeoDataCoordinates | coordinates,
|  | Marble.GeoDataPlacemark | placemark
| ) |  |  |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("reverseGeocodingFinished(const Marble::GeoDataCoordinates&, const Marble::GeoDataPlacemark&)"), target_slot)`

reverseGeocodingFinished | ( |  | ) |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("reverseGeocodingFinished()"), target_slot)`

routeRetrieved | ( | Marble.GeoDataDocument | route
| ) |  |  |

A route was retrieved

Signal syntax:
  `QObject.connect(source, SIGNAL("routeRetrieved(Marble::GeoDataDocument*)"), target_slot)`

routingFinished | ( |  | ) |

signal emitted whenever all runners are finished for the query

Signal syntax:
  `QObject.connect(source, SIGNAL("routingFinished()"), target_slot)`

searchFinished | ( | QString | searchTerm
| ) |  |  |

The search request for the given search term has finished, i.e. all runners are finished and reported their results via the

See also:
  searchResultChanged signal

Signal syntax:
  `QObject.connect(source, SIGNAL("searchFinished(const QString&)"), target_slot)`

searchResultChanged | ( | QAbstractItemModel | model
| ) |  |  |

Placemarks were added to or removed from the model To do: FIXME: this sounds like a duplication of QAbstractItemModel signals

Signal syntax:
  `QObject.connect(source, SIGNAL("searchResultChanged(QAbstractItemModel*)"), target_slot)`

## Method Documentation

findPlacemarks | ( | self, |
|  | QString | searchTerm,
|  | Marble.GeoDataLatLonAltBox | preferred=Marble.GeoDataLatLonAltBox()
| ) |  |  |

Search for placemarks matching the given search term.

See also:
  findPlacemark is asynchronous with results returned using the

See also:
  searchResultChanged signal.

See also:
  searchPlacemark is blocking.

See also:
  searchFinished signal indicates all runners are finished.

Marble.GeoDataDocument openFile | ( | self, |
|  | QString | fileName,
|  | Marble.DocumentRole | role=Marble.UserDocument
| ) |  |  |

parseFile | ( | self, |
|  | QString | fileName,
|  | Marble.DocumentRole | role=Marble.UserDocument
| ) |  |  |

Parse the file using the runners for various formats

See also:
  parseFile is asynchronous with results returned using the

See also:
  parsingFinished signal.

See also:
  openFile is blocking.

See also:
  parsingFinished signal indicates all runners are finished.

retrieveRoute | ( | self, |
|  | Marble.RouteRequest | request
| ) |  |  |

Download routes traversing the stopover points in the given route request

See also:
  retrieveRoute is asynchronous with results returned using the

See also:
  routeRetrieved signal.

See also:
  searchRoute is blocking.

See also:
  routingFinished signal indicates all runners are finished.

reverseGeocoding | ( | self, |
|  | Marble.GeoDataCoordinates | coordinates
| ) |  |  |

Find the address and other meta information for a given geoposition.

See also:
  reverseGeocoding is asynchronous with currently one result returned using the
  See also:
    reverseGeocodingFinished signal.
  See also:
    searchReverseGeocoding is blocking.
  See also:
    reverseGeocodingFinished signal indicates all runners are finished.

QString searchReverseGeocoding | ( | self, |
|  | Marble.GeoDataCoordinates | coordinates
| ) |  |  |

setModel | ( | self, |
|  | Marble.MarbleModel | model
| ) |  |  |

Set a pointer to the model instance to be passed to MarbleAbstractRunner instances or to use model specific information like planet parameters