QGeoPath Class
La clase QGeoPath define una ruta geográfica. Más...
| Cabecera: | #include <QGeoPath> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Hereda: | QGeoShape |
Propiedades
Funciones públicas
| QGeoPath() | |
| QGeoPath(const QGeoShape &other) | |
| QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0) | |
| QGeoPath(const QGeoPath &other) | |
| ~QGeoPath() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | clearPath() |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
| const QList<QGeoCoordinate> & | path() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| void | setPath(const QList<QGeoCoordinate> &path) |
| void | setWidth(const qreal &width) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPath | translated(double degreesLatitude, double degreesLongitude) const |
| qreal | width() const |
| QGeoPath & | operator=(const QGeoPath &other) |
Descripción detallada
El camino está definido por una lista ordenada de objetos QGeoCoordinate.
Se pretende que cada dos elementos adyacentes de la trayectoria estén conectados entre sí por el segmento de línea más corto de rumbo constante que pase por ambos elementos. Este tipo de conexión puede cruzar la línea de referencia en la dirección longitudinal, pero nunca cruza los polos.
Esto es relevante para el cálculo del cuadro delimitador devuelto por QGeoShape::boundingGeoRectangle() para esta forma, que tendrá la latitud de la esquina superior izquierda fijada en la latitud máxima en el conjunto de puntos de la trayectoria. Del mismo modo, la latitud de la esquina inferior derecha será la latitud mínima del conjunto de puntos del recorrido.
Esta clase también es accesible en QML como geoPath.
Un QGeoPath es inválido y vacío si no contiene ninguna coordenada.
Nota: Un QGeoPath construido por defecto es tanto inválido como vacío ya que no contiene ninguna coordenada.
Documentación de propiedades
path : QVariantList
Esta propiedad contiene la lista de coordenadas de la ruta geográfica.
Nota: Las coordenadas no se pueden procesar in situ. Para cambiar el valor de esta propiedad, recupere la lista completa de coordenadas, procéselas y asigne el nuevo valor a la propiedad.
width : qreal
Esta propiedad contiene la anchura del camino en metros.
Funciones de acceso:
| qreal | width() const |
| void | setWidth(const qreal &width) |
Documentación de las funciones miembro
QGeoPath::QGeoPath()
Crea una nueva ruta geográfica vacía.
QGeoPath::QGeoPath(const QGeoShape &other)
Crea una nueva ruta geográfica a partir del contenido de other.
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
Construye una nueva ruta geográfica a partir de una lista de coordenadas (path y width).
QGeoPath::QGeoPath(const QGeoPath &other)
Crea una nueva ruta geográfica a partir del contenido de other.
[noexcept] QGeoPath::~QGeoPath()
Destruye este camino.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Añade coordinate a la ruta.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QGeoPath::clearPath()
Despeja el camino.
[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const
Devuelve true si la ruta contiene coordinate como uno de los elementos.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPath::coordinateAt(qsizetype index) const
Devuelve la coordenada en index.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Inserta coordinate en el index especificado.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Devuelve la longitud del camino, en metros, desde el elemento indexFrom hasta el elemento indexTo. La longitud pretende ser la suma de las distancias más cortas para cada par de puntos adyacentes.
Si indexTo es -1 (el valor por defecto), la longitud incluirá la distancia entre la última coordenada y la primera (bucle cerrado). Para obtener la longitud de la trayectoria, utilice 0 para indexFrom y QGeoPath::size() - 1 para indexTo.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
const QList<QGeoCoordinate> &QGeoPath::path() const
Devuelve todos los elementos de la ruta.
Véase también setPath().
[invokable] void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)
Elimina la última aparición de coordinate de la ruta.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
Elimina el elemento en la posición index de la ruta.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Sustituye el elemento path en la dirección index especificada por coordinate.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QGeoPath::setPath(const QList<QGeoCoordinate> &path)
Establece todos los elementos de path.
Véase también path().
[invokable] qsizetype QGeoPath::size() const
Devuelve el número de elementos de la ruta.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QString QGeoPath::toString() const
Devuelve las propiedades de la ruta geográfica como una cadena.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Traslada esta geo ruta degreesLatitude hacia el norte y degreesLongitude hacia el este.
Los valores negativos de degreesLatitude y degreesLongitude corresponden a una traslación hacia el sur y hacia el oeste respectivamente.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
Devuelve una copia de esta geo ruta trasladada por degreesLatitude hacia el norte y degreesLongitude hacia el este.
Los valores negativos de degreesLatitude y degreesLongitude corresponden a una traslación hacia el sur y hacia el oeste respectivamente.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también translate().
qreal QGeoPath::width() const
Devuelve la anchura de la ruta, en metros. Esta información se utiliza en el método contains. El valor por defecto es 0.
Nota: Función Getter para la propiedad anchura.
Véase también setWidth().
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
Asigna other a esta ruta geográfica y devuelve una referencia a la misma.
© 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.
