RouteModel QML Type
El tipo RouteModel permite acceder a las rutas. Más información...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
Propiedades
- autoUpdate : bool
- count : int
- error : enumeration
- errorString : string
- measurementSystem : Locale::MeasurementSystem
- plugin : Plugin
- query : RouteQuery
- status : enumeration
Métodos
Descripción detallada
El tipo RouteModel se utiliza como parte de un grupo de modelo/vista para recuperar rutas geográficas de un proveedor de fondo. Las rutas incluyen datos sobre indicaciones para llegar en coche entre dos puntos, indicaciones a pie con varios puntos de paso y otros conceptos similares. Funciona de forma muy similar a otros tipos de modelo en QML (véase, por ejemplo, ListModel) e interactúa con vistas como MapItemView y ListView.
Al igual que Map y GeocodeModel, todos los datos necesarios para que un RouteModel funcione proceden de un complemento de servicios. Estos se encuentran en la propiedad plugin, que debe configurarse antes de que el RouteModel pueda realizar ninguna tarea útil.
Una vez configurado el complemento, crea un ` RouteQuery ` con los puntos de ruta adecuados y el resto de ajustes, y establece la propiedad ` query ` del `RouteModel`. Si ` autoUpdate ` está habilitado, la actualización se iniciará automáticamente. De lo contrario, se puede utilizar el método ` update `. Por defecto, ` autoUpdate ` está deshabilitado.
Los datos almacenados y devueltos en el RouteModel consisten en objetos ` route `, en forma de lista con el nombre de rol «routeData». Consulte la documentación de ` route ` para obtener más detalles sobre su estructura y contenido.
Ejemplo de uso
El siguiente fragmento de código consta de dos partes: en primer lugar, muestra la declaración de los objetos y, en segundo lugar, un breve fragmento de código procedimental que los utiliza. Establecemos la propiedad ` autoUpdate ` del `routeModel` en `false` y llamamos a ` update ` una vez configurada la consulta, para evitar solicitudes adicionales innecesarias durante la configuración de la misma.
Plugin {
id: aPlugin
name: "osm"
}
RouteQuery {
id: aQuery
}
RouteModel {
id: routeModel
plugin: aPlugin
query: aQuery
autoUpdate: false
}{
aQuery.addWaypoint(...)
aQuery.addWaypoint(...)
aQuery.travelModes = ...
routeModel.update()
}Documentación de la propiedad
autoUpdate : bool
Esta propiedad controla si el modelo se actualiza automáticamente en respuesta a los cambios que se produzcan en el objeto « RouteQuery » asociado. El valor por defecto de esta propiedad es «false».
Si se establece este valor en «true», hay que tener en cuenta que cualquier cambio, por pequeño que sea, en el objeto ` RouteQuery ` definido en la propiedad ` query ` provocará el envío de una nueva solicitud. Si se modifican muchas propiedades de ` RouteQuery ` con la opción `autoUpdate` activada, esto puede generar un gran número de solicitudes innecesarias (que posteriormente se descartarán).
count : int [read-only]
Esta propiedad indica cuántas rutas tiene actualmente el modelo. Entre otros usos, puedes utilizar este valor al acceder a las rutas mediante el método QtLocation::RouteModel::get.
error : enumeration [read-only]
Esta propiedad de solo lectura contiene el último valor de error de la solicitud de enrutamiento.
- RouteModel.NoError: no se ha producido ningún error.
- RouteModel.CommunicationError: se ha producido un error al comunicarse con el proveedor de servicios.
- RouteModel.EngineNotSetError: la propiedad «plugin» del modelo no se ha establecido o no hay ningún gestor de enrutamiento asociado al complemento.
- RouteModel.MissingRequiredParameterError: no se ha especificado un parámetro obligatorio.
- RouteModel.ParseError: la respuesta del proveedor de servicios tenía un formato irreconocible.
- RouteModel.UnknownError - Se ha producido un error que no encaja en ninguna de las otras categorías.
- RouteModel.UnknownParameterError: el complemento no ha reconocido uno de los parámetros que se le han proporcionado.
- RouteModel.UnsupportedOptionError: el proveedor de enrutamiento no admite la operación solicitada. Esto puede ocurrir cuando el motor cargado no admite un tipo concreto de solicitud de enrutamiento.
errorString : string [read-only]
Esta propiedad de solo lectura contiene la representación textual del último error de enrutamiento. Si no se ha producido ningún error o si se ha restablecido el modelo, se devuelve una cadena vacía.
También se puede devolver una cadena vacía si se ha producido un error que no tiene una representación textual asociada.
measurementSystem : Locale::MeasurementSystem
Esta propiedad contiene el sistema de medidas que se utilizará al calcular la ruta. Esta propiedad cambia cuando se modifica la propiedad « Plugin::locales » de « plugin ».
Si se configura esta propiedad, debe hacerse después de haber configurado la propiedad « plugin ».
plugin : Plugin
Esta propiedad contiene el complemento que proporciona el servicio de cálculo de rutas propiamente dicho. Ten en cuenta que no todos los complementos proporcionan necesariamente el cálculo de rutas (por ejemplo, podrían ofrecer únicamente geocodificación o mapas).
Es necesario configurar un complemento válido antes de que RouteModel pueda realizar cualquier operación útil.
Véase también Plugin.
query : RouteQuery
Esta propiedad contiene los datos de la solicitud de ruta. Los datos principales son las coordenadas de los puntos de paso y otras posibles preferencias (medio de transporte, elementos que hay que evitar en la ruta, etc.).
status : enumeration [read-only]
Esta propiedad de solo lectura contiene el estado actual del modelo.
- RouteModel.Null: no se ha enviado ninguna solicitud de ruta ni se ha llamado a ` reset `.
- RouteModel.Ready: las solicitudes de ruta se han completado correctamente.
- RouteModel.Loading: se ha enviado una solicitud de ruta, pero aún no ha finalizado
- RouteModel.Error: se ha producido un error de enrutamiento; los detalles se encuentran en error y errorString
la documentación del método.
void cancel()
Cancela cualquier solicitud pendiente y corrige los errores. El estado del modelo se establecerá como « RouteModel.Null» o « RouteModel.Ready».
route get(int index)
Devuelve la ruta en el index especificado. Utiliza la propiedad count para comprobar el número de rutas disponibles. Las rutas se indexan a partir de cero, por lo que el rango accesible es 0...(count - 1).
Si se accede fuera de este rango, se devuelve una ruta vacía y se emite una advertencia.
void reset()
Restablece el modelo. Se borran todos los datos de la ruta, se cancelan las solicitudes pendientes y se eliminan los posibles errores. El estado del modelo se establecerá en « RouteModel.Null».
void update()
Indica a la base de datos « RouteModel » que actualice sus datos. Esto resulta especialmente útil cuando la opción « autoUpdate » está desactivada, para forzar una actualización cuando se ha modificado la consulta.
© 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.