En esta página

QGeoPolygon Class

La clase QGeoPolygon define un polígono geográfico. Más información...

Encabezado: #include <QGeoPolygon>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Heredado de: QGeoShape

Propiedades

Funciones públicas

QGeoPolygon()
QGeoPolygon(const QGeoShape &other)
QGeoPolygon(const QList<QGeoCoordinate> &path)
QGeoPolygon(const QGeoPolygon &other)
~QGeoPolygon()
void addCoordinate(const QGeoCoordinate &coordinate)
void addHole(const QList<QGeoCoordinate> &holePath)
void addHole(const QVariant &holePath)
bool containsCoordinate(const QGeoCoordinate &coordinate) const
QGeoCoordinate coordinateAt(qsizetype index) const
const QVariantList hole(qsizetype index) const
const QList<QGeoCoordinate> holePath(qsizetype index) const
qsizetype holesCount() const
void insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
double length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
(since QtPositioning 5.12) const QList<QGeoCoordinate> &perimeter() const
void removeCoordinate(const QGeoCoordinate &coordinate)
void removeCoordinate(qsizetype index)
void removeHole(qsizetype index)
void replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
(since QtPositioning 5.12) void setPerimeter(const QList<QGeoCoordinate> &path)
qsizetype size() const
QString toString() const
void translate(double degreesLatitude, double degreesLongitude)
QGeoPolygon translated(double degreesLatitude, double degreesLongitude) const
QGeoPolygon &operator=(const QGeoPolygon &other)

Descripción detallada

El polígono se define mediante una lista ordenada de objetos « QGeoCoordinate » que representan su perímetro.

Se considera que cada par de elementos adyacentes de esta lista 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 internacional 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 geoPolygon.

Documentación de la propiedad

perimeter : QList<QGeoCoordinate>

Esta propiedad contiene las coordenadas del perímetro del polígono.

Funciones de acceso:

const QList<QGeoCoordinate> &perimeter() const
void setPerimeter(const QList<QGeoCoordinate> &path)

Documentación de las funciones de miembro

QGeoPolygon::QGeoPolygon()

Crea un nuevo polígono geométrico vacío.

QGeoPolygon::QGeoPolygon(const QGeoShape &other)

Crea un nuevo polígono geográfico a partir del contenido de other.

QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)

Crea un nuevo polígono geográfico a partir de las coordenadas especificadas en path.

QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)

Crea un nuevo polígono geográfico a partir del contenido de other.

[noexcept] QGeoPolygon::~QGeoPolygon()

Elimina este polígono.

[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)

Añade « coordinate » al polígono.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)

Método sobrecargado. Establece el « holePath » de un agujero dentro del polígono. El agujero es un « QList » <QGeoCoordinate>.

[invokable] void QGeoPolygon::addHole(const QVariant &holePath)

Establece el ` holePath ` para un agujero dentro del polígono. El agujero es un ` QVariant ` que contiene un ` QList` <QGeoCoordinate>.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const

Devuelve «true» si el perímetro del polígono 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 QGeoPolygon::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] const QVariantList QGeoPolygon::hole(qsizetype index) const

Devuelve un objeto ` QVariant ` que contiene un ` QList` <QGeoCoordinate>, el cual representa el agujero en index.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const

Devuelve un objeto de tipo « QList » <QGeoCoordinate>, que representa el agujero de index.

[invokable] qsizetype QGeoPolygon::holesCount() const

Devuelve el número de agujeros.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QGeoPolygon::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 QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const

Devuelve la longitud del perímetro del polígono, en metros, desde el elemento indexFrom hasta el elemento indexTo. Se considera que dicha longitud es la suma de las distancias más cortas entre cada par de puntos adyacentes.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const

Devuelve todos los elementos del perímetro del polígono.

Nota: Funciónde lectura para la propiedad «perimeter».

Esta función se introdujo en QtPositioning 5.12.

Véase también setPerimeter().

[invokable] void QGeoPolygon::removeCoordinate(const QGeoCoordinate &coordinate)

Elimina la última aparición de « coordinate » del polígono.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QGeoPolygon::removeCoordinate(qsizetype index)

Elimina el elemento situado en la posición index del polígono.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QGeoPolygon::removeHole(qsizetype index)

Elimina el elemento situado en la posición index de la lista de agujeros.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QGeoPolygon::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)

Sustituye el elemento «path» en la ruta 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.

[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)

Establece el perímetro del polígono a partir de una lista de coordenadas path.

Nota: Funciónde asignación para la propiedad perimeter.

Esta función se introdujo en QtPositioning 5.12.

Véase también ` perimeter()`.

[invokable] qsizetype QGeoPolygon::size() const

Devuelve el número de elementos del polígono.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QString QGeoPolygon::toString() const

Devuelve las propiedades del polígono geográfico 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 QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)

Traslada este geopolígono hacia el norte en degreesLatitude y hacia el este en 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.

[invokable] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const

Devuelve una copia de este geopolígono desplazado 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 se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también translate().

QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)

Asigna « other » a este geopolígono y devuelve una referencia a dicho geopolígono.

© 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.