QGeoPath Class
La clase QGeoPath define una ruta geográfica. Más información...
| Encabezado: | #include <QGeoPath> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Heredado de: | 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
La ruta se define mediante una lista ordenada de objetos « QGeoCoordinate ».
Se considera que cada par de elementos adyacentes de la ruta están conectados entre sí mediante el segmento de línea más corto de rumbo constante que pasa por ambos elementos. Este tipo de conexión puede cruzar la línea de cambio de fecha en dirección longitudinal, pero nunca cruza los polos.
Esto es relevante para el cálculo del rectángulo delimitador devuelto por QGeoShape::boundingGeoRectangle() para esta forma, cuya latitud de la esquina superior izquierda se establecerá en la latitud máxima del conjunto de puntos de la ruta. Del mismo modo, la latitud de la esquina inferior derecha será la latitud mínima del conjunto de puntos de la ruta.
También se puede acceder a esta clase en QML como ` geoPath`.
Un `QGeoPath` es inválido y está vacío si no contiene ninguna coordenada.
Nota: Un QGeoPath creado de forma predeterminada es inválido y está 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, recupera la lista completa de coordenadas, procésalas y asigna 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 de miembro
QGeoPath::QGeoPath()
Crea una nueva ruta geométrica 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)
Crea 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()
Elimina esta ruta.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Añade « coordinate » a la ruta.
Nota: Esta función se puede invocar 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 sus elementos.
Nota: Esta función se puede invocar 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 se puede invocar 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 la dirección especificada index.
Nota: Esta función se puede invocar 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 de la ruta, en metros, desde el elemento indexFrom hasta el elemento indexTo. Se considera que la longitud es la suma de las distancias más cortas entre 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 ruta, utilice 0 para indexFrom y QGeoPath::size() - 1 para indexTo.
Nota: Esta función se puede invocar 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 se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
Elimina del trazado el elemento situado en la posición index.
Nota: Esta función se puede invocar 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 especificada index por coordinate.
Nota: Esta función se puede invocar 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 la clase ` path`.
Véase también path().
[invokable] qsizetype QGeoPath::size() const
Devuelve el número de elementos de la ruta.
Nota: Esta función se puede invocar 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 de caracteres.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Traslada esta ruta geográfica mediante 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 se puede invocar 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 ruta geográfica desplazada hacia el norte mediante degreesLatitude y hacia el este mediante degreesLongitude.
Los valores negativos de degreesLatitude y degreesLongitude corresponden a una traslación hacia el sur y hacia el oeste, respectivamente.
Nota: Esta función se puede invocar 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óngetter para la propiedad width.
Véase también setWidth().
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
Asigna « other » a esta ruta geográfica y devuelve una referencia a dicha ruta.
© 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.