QGeoRoutingManager Class
La clase QGeoRoutingManager permite realizar operaciones de cálculo de rutas geográficas. Más información...
| Header: | #include <QGeoRoutingManager> |
| qmake: | QT += location |
| Inherits: | QObject |
Funciones públicas
| virtual | ~QGeoRoutingManager() |
| QGeoRouteReply * | calculateRoute(const QGeoRouteRequest &request) |
| QLocale | locale() const |
| QString | managerName() const |
| int | managerVersion() const |
| QLocale::MeasurementSystem | measurementSystem() const |
| void | setLocale(const QLocale &locale) |
| void | setMeasurementSystem(QLocale::MeasurementSystem system) |
| QGeoRouteRequest::FeatureTypes | supportedFeatureTypes() const |
| QGeoRouteRequest::FeatureWeights | supportedFeatureWeights() const |
| QGeoRouteRequest::ManeuverDetails | supportedManeuverDetails() const |
| QGeoRouteRequest::RouteOptimizations | supportedRouteOptimizations() const |
| QGeoRouteRequest::SegmentDetails | supportedSegmentDetails() const |
| QGeoRouteRequest::TravelModes | supportedTravelModes() const |
| QGeoRouteReply * | updateRoute(const QGeoRoute &route, const QGeoCoordinate &position) |
Señales
| void | errorOccurred(QGeoRouteReply *reply, QGeoRouteReply::Error error, const QString &errorString = QString()) |
| void | finished(QGeoRouteReply *reply) |
Descripción detallada
Los métodos ` calculateRoute()` y ` updateRoute()` operan c QGeoRouteReply, que gestionan estas operaciones e informan del resultado de las mismas y de cualquier error que pueda haberse producido.
La función calculateRoute() se utiliza para encontrar una ruta (o rutas) que siga un conjunto de puntos de ruta y cumpla con otros criterios diversos. La clase QGeoRouteRequest se utiliza para especificar esta información.
Si supportsRouteUpdates() devuelve true, entonces QGeoRoutingManager admite la actualización de la información de la ruta en función de las actualizaciones de posición. Esto provocará que se actualicen las estimaciones del tiempo de viaje y la distancia, y que cualquier QGeoRouteSegment ya recorrido se elimine de la ruta.
Las actualizaciones pueden activarse con la función ` updateRoute()`, que utiliza las instancias de ` QGeoPositionInfo ` emitidas como actualizaciones de posición por ` QGeoPositionInfoSource`.
Se puede acceder a las instancias de `QGeoRoutingManager` mediante ` QGeoServiceProvider::routingManager()`.
A continuación se muestra un pequeño ejemplo del uso de QGeoRoutingManager y QGeoRouteRequests:
class RouteHandler : public QObject
{
Q_OBJECT
public:
RouteHandler(QGeoRoutingManager *routingManager,
const QGeoCoordinate &origin,
const QGeoCoordinate &destination) {
QGeoRouteRequest request(origin, destination);
// The request defaults to the fastest route by car, which is
// equivalent to:
// request.setTravelMode(QGeoRouteRequest::CarTravel);
// request.setRouteOptimization(QGeoRouteRequest::FastestRoute);
request.setAvoidFeatureTypes(QGeoRouteRequest::AvoidTolls);
request.setAvoidFeatureTypes(QGeoRouteRequest::AvoidMotorPoolLanes);
QGeoRouteRequest::AvoidFeaturesTypes avoidableFeatures = routingManager->supportedAvoidFeatureTypes();
if (!(avoidableFeatures & request.avoidFeatureTypes())) {
// ... inform the user that the routing manager does not
// provide support for avoiding tolls and/or motor pool lanes ...
return;
}
QGeoRouteReply *reply = routingManager->calculateRoute(request);
if (reply->isFinished()) {
if (reply->error() == QGeoRouteReply::NoError) {
routeCalculated(reply);
} else {
routeError(reply, reply->error(), reply->errorString());
}
return;
}
connect(routingManager, &QGeoRoutingManager::finished,
this, &RouteHandler::routeCalculated);
connect(routingManager, &QGeoRoutingManager::errorOccurred,
this, &RouteHandler::routeError);
}
private slots:
void routeCalculated(QGeoRouteReply *reply)
{
// A route request can ask for several alternative routes ...
if (reply->routes().size() != 0) {
// ... but by default it will only get a single route
QGeoRoute route = reply->routes().at(0);
//... now we have to make use of the route ...
}
reply->deleteLater();
}
void routeError(QGeoRouteReply *reply, QGeoRouteReply:Error error, const QString &errorString)
{
// ... inform the user that an error has occurred ...
reply->deleteLater();
}
};Documentación de las funciones miembro
[virtual noexcept] QGeoRoutingManager::~QGeoRoutingManager()
Elimina a este responsable.
QGeoRouteReply *QGeoRoutingManager::calculateRoute(const QGeoRouteRequest &request)
Inicia el cálculo de la ruta especificada por ` request`.
Se devolverá un objeto ` QGeoRouteReply `, que se puede utilizar para gestionar la operación de cálculo de ruta y para obtener los resultados de la misma.
Este gestor y el objeto ` QGeoRouteReply ` devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.
Una vez finalizada la operación, se puede utilizar QGeoRouteReply::routes para recuperar la ruta o rutas calculadas.
Si ` request ` incluye características que no son compatibles con este gestor, tal y como indican los métodos de este gestor, se producirá una excepción de tipo ` QGeoRouteReply::UnsupportedOptionError `.
El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en la ranura conectada a ` QGeoRoutingManager::finished()`, ` QGeoRoutingManager::errorOccurred()`, ` QGeoRouteReply::finished()` o ` QGeoRouteReply::errorOccurred()` mediante ` deleteLater()`.
[signal] void QGeoRoutingManager::errorOccurred(QGeoRouteReply *reply, QGeoRouteReply::Error error, const QString &errorString = QString())
Esta señal se emite cuando se ha detectado un error en el procesamiento de ` reply`. Probablemente le seguirá la señal ` QGeoRoutingManager::finished()`.
El error se describirá mediante el código de error error. Si errorString no está vacío, contendrá una descripción textual del error.
Esta señal y QGeoRouteReply::errorOccurred() se emitirán al mismo tiempo.
Nota: No elimines el objeto reply en la ranura conectada a esta señal. Utiliza deleteLater() en su lugar.
[signal] void QGeoRoutingManager::finished(QGeoRouteReply *reply)
Esta señal se emite cuando « reply » ha finalizado el procesamiento.
Si reply::error() es igual a QGeoRouteReply::NoError, el procesamiento ha finalizado correctamente.
Esta señal y QGeoRouteReply::finished() se emitirán al mismo tiempo.
Nota: No elimines el objeto ` reply ` en la ranura conectada a esta señal. Utiliza en su lugar ` deleteLater()`.
QLocale QGeoRoutingManager::locale() const
Devuelve la configuración regional que se utiliza para indicar a este gestor de enrutamiento qué idioma debe emplearse en las direcciones y las instrucciones.
Véase también setLocale().
QString QGeoRoutingManager::managerName() const
Devuelve el nombre del motor que implementa el comportamiento de este gestor de enrutamiento.
La combinación de `managerName()` y ` managerVersion()` debe ser única entre las implementaciones del complemento.
int QGeoRoutingManager::managerVersion() const
Devuelve la versión del motor que implementa el comportamiento de este gestor de rutinas.
La combinación de ` managerName()` y `managerVersion()` debe ser única entre las implementaciones del complemento.
QLocale::MeasurementSystem QGeoRoutingManager::measurementSystem() const
Devuelve el sistema de unidades utilizado por este gestor.
Si se ha llamado a setMeasurementSystem(), el valor devuelto por esta función puede ser diferente al devuelto por locale() omeasurementSystem(). En tal caso, el valor devuelto por esta función es el que utilizará el gestor.
Véanse también setMeasurementSystem() y setLocale().
void QGeoRoutingManager::setLocale(const QLocale &locale)
Establece la configuración regional que utilizará este gestor en locale.
Si este gestor de rutas admite la devolución de direcciones e instrucciones en diferentes idiomas, estas se mostrarán en el idioma de locale.
Si no se ha establecido, la configuración regional utilizada será, por defecto, la del sistema.
Véase también locale().
void QGeoRoutingManager::setMeasurementSystem(QLocale::MeasurementSystem system)
Establece el sistema de medidas utilizado por este gestor en system.
El sistema de medidas se puede configurar independientemente de la configuración regional. Tanto setLocale() como esta función establecen el sistema de medidas. Se utilizará el valor establecido por la última función llamada.
Véanse también measurementSystem(), locale() y setLocale().
QGeoRouteRequest::FeatureTypes QGeoRoutingManager::supportedFeatureTypes() const
Devuelve los tipos de elementos que este gestor puede tener en cuenta durante la planificación de rutas.
QGeoRouteRequest::FeatureWeights QGeoRoutingManager::supportedFeatureWeights() const
Devuelve las ponderaciones que este gestor puede aplicar a diferentes características durante la planificación de la ruta.
QGeoRouteRequest::ManeuverDetails QGeoRoutingManager::supportedManeuverDetails() const
Devuelve los niveles de detalle de las maniobras de navegación que puede solicitar este gestor.
QGeoRouteRequest::RouteOptimizations QGeoRoutingManager::supportedRouteOptimizations() const
Devuelve las optimizaciones de ruta compatibles con este gestor.
QGeoRouteRequest::SegmentDetails QGeoRoutingManager::supportedSegmentDetails() const
Devuelve los niveles de detalle de los segmentos de trazado que se pueden solicitar a través de este gestor.
QGeoRouteRequest::TravelModes QGeoRoutingManager::supportedTravelModes() const
Devuelve los modos de desplazamiento compatibles con este gestor.
QGeoRouteReply *QGeoRoutingManager::updateRoute(const QGeoRoute &route, const QGeoCoordinate &position)
Inicia el proceso de actualización de ` route ` en función de la posición actual ` position`.
Se devolverá un objeto ` QGeoRouteReply `, que se puede utilizar para gestionar la operación de enrutamiento y para devolver los resultados de la misma.
Este gestor y el objeto ` QGeoRouteReply ` devuelto emitirán señales que indicarán si la operación se completa o si se producen errores.
Si supportsRouteUpdates() devuelve «false», se producirá un QGeoRouteReply::UnsupportedOptionError.
Una vez completada la operación, se puede utilizar ` QGeoRouteReply::routes ` para recuperar la ruta actualizada.
La ruta devuelta podría ser totalmente diferente a la ruta original, especialmente si ` position ` se encuentra muy lejos de la ruta inicial. En caso contrario, la ruta será similar, aunque se actualizarán el tiempo restante y la distancia, y se eliminarán los segmentos de la ruta original que ya se hayan recorrido.
El usuario es responsable de eliminar el objeto de respuesta devuelto, aunque esto puede hacerse en el slot asociado a QGeoRoutingManager::finished(), QGeoRoutingManager::errorOccurred(), QGeoRouteReply::finished() o QGeoRouteReply::errorOccurred() mediante deleteLater().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.