En esta página

QGeoRectangle Class

La clase QGeoRectangle define un área geográfica rectangular. Más...

Cabecera: #include <QGeoRectangle>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Hereda: QGeoShape

Propiedades

Funciones públicas

QGeoRectangle()
QGeoRectangle(const QGeoShape &other)
QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
QGeoRectangle(const QGeoCoordinate &center, double degreesWidth, double degreesHeight)
QGeoRectangle(const QGeoRectangle &other)
~QGeoRectangle()
QGeoCoordinate bottomLeft() const
QGeoCoordinate bottomRight() const
QGeoCoordinate center() const
bool contains(const QGeoRectangle &rectangle) const
void extendRectangle(const QGeoCoordinate &coordinate)
double height() const
bool intersects(const QGeoRectangle &rectangle) const
void setBottomLeft(const QGeoCoordinate &bottomLeft)
void setBottomRight(const QGeoCoordinate &bottomRight)
void setCenter(const QGeoCoordinate &center)
void setHeight(double degreesHeight)
void setTopLeft(const QGeoCoordinate &topLeft)
void setTopRight(const QGeoCoordinate &topRight)
void setWidth(double degreesWidth)
QString toString() const
QGeoCoordinate topLeft() const
QGeoCoordinate topRight() const
void translate(double degreesLatitude, double degreesLongitude)
QGeoRectangle translated(double degreesLatitude, double degreesLongitude) const
QGeoRectangle united(const QGeoRectangle &rectangle) const
double width() const
QGeoRectangle &operator=(const QGeoRectangle &other)
QGeoRectangle operator|(const QGeoRectangle &rectangle) const
QGeoRectangle &operator|=(const QGeoRectangle &rectangle)

Descripción detallada

El rectángulo se define en términos de un QGeoCoordinate que especifica la coordenada superior izquierda del rectángulo y un QGeoCoordinate que especifica la coordenada inferior derecha del rectángulo.

Un georrectángulo se considera inválido si las coordenadas superior izquierda o inferior derecha no son válidas o si la coordenada superior izquierda está al sur de la coordenada inferior derecha.

Los georrectángulos nunca pueden cruzar los polos.

Varios métodos se comportan como si el georrectángulo estuviera definido en términos de una coordenada central, la anchura del georrectángulo en grados y la altura del georrectángulo en grados.

Si la altura o el centro de un georrectángulo se ajusta de forma que cruce uno de los polos, la altura se modifica de forma que el georrectángulo toque pero no cruce el polo y que la coordenada central siga estando en el centro del georrectángulo.

Esta clase también es accesible en QML como geoRectangle.

Documentación de propiedades

bottomLeft : QGeoCoordinate

Esta propiedad contiene la coordenada inferior izquierda de este geo rectángulo.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

QGeoCoordinate bottomLeft() const
void setBottomLeft(const QGeoCoordinate &bottomLeft)

bottomRight : QGeoCoordinate

Esta propiedad contiene la coordenada inferior derecha de este geo rectángulo.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

QGeoCoordinate bottomRight() const
void setBottomRight(const QGeoCoordinate &bottomRight)

center : QGeoCoordinate

Esta propiedad contiene el centro de este geo rectángulo.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

QGeoCoordinate center() const
void setCenter(const QGeoCoordinate &center)

Véase también QGeoShape::center.

height : double

Esta propiedad contiene la altura de este geo rectángulo en grados.

El valor de la propiedad es indefinido si este geo rectángulo no es válido.

Si la nueva altura es menor que 0.0 o si este geo rectángulo no es válido, la propiedad no se modifica. Para establecer los valores de un geo rectángulo inválido basándose en el centro, la anchura y la altura, primero debe utilizar setCenter() para que el geo rectángulo sea válido.

Si el cambio en la altura provocara que el georrectángulo cruzara un poste, la altura se ajusta de forma que el georrectángulo sólo toque el poste.

Este cambio se realiza de forma que la coordenada central siga estando en el centro del georrectángulo, lo que puede dar como resultado un georrectángulo con una altura menor de la esperada.

180.0 es la altura utilizada sólo si la nueva altura es mayor o igual que 180.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

double height() const
void setHeight(double degreesHeight)

topLeft : QGeoCoordinate

Esta propiedad contiene la coordenada superior izquierda de este geo rectángulo.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

QGeoCoordinate topLeft() const
void setTopLeft(const QGeoCoordinate &topLeft)

topRight : QGeoCoordinate

Esta propiedad contiene la coordenada superior derecha de este geo rectángulo.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

QGeoCoordinate topRight() const
void setTopRight(const QGeoCoordinate &topRight)

width : double

Esta propiedad contiene el ancho de este geo rectángulo en grados.

El valor de la propiedad es indefinido si este geo rectángulo no es válido.

Si la nueva anchura es menor que 0.0 o si este geo rectángulo no es válido, esta función no hace nada. Para establecer los valores de un geo rectángulo inválido basado en el centro, anchura y altura, debe utilizar setCenter() primero para hacer que el geo rectángulo sea válido.

360.0 es la anchura utilizada sólo si la nueva anchura es igual o mayor que 360. En tales casos, la longitud más a la izquierda del geo rectángulo se establece en -180,0 grados y la longitud más a la derecha del geo rectángulo se establece en 180,0 grados.

Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

double width() const
void setWidth(double degreesWidth)

Documentación de funciones miembro

QGeoRectangle::QGeoRectangle()

Construye un nuevo georrectángulo no válido.

QGeoRectangle::QGeoRectangle(const QGeoShape &other)

Construye un georrectángulo a partir del contenido de other.

QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)

Construye un nuevo georrectángulo, de tamaño mínimo, que contiene todos los coordinates.

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)

Construye un nuevo geo rectángulo con una coordenada superior izquierda topLeft y una coordenada inferior derecha bottomRight.

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &center, double degreesWidth, double degreesHeight)

Construye un nuevo georrectángulo centrado en center con una anchura en grados de degreesWidth y una altura en grados de degreesHeight.

Si degreesHeight llevara el georrectángulo más allá de uno de los polos, la altura del georrectángulo se truncará de forma que el georrectángulo sólo se extienda hasta el polo. El centro del georrectángulo no cambiará y la altura se ajustará de forma que el punto central se encuentre en el centro del georrectángulo truncado.

QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)

Construye un georrectángulo a partir del contenido de other.

[noexcept] QGeoRectangle::~QGeoRectangle()

Destruye este geo rectángulo.

QGeoCoordinate QGeoRectangle::bottomLeft() const

Devuelve la coordenada inferior izquierda de este geo rectángulo.

Nota: Función Getter para la propiedad bottomLeft.

Véase también setBottomLeft().

QGeoCoordinate QGeoRectangle::bottomRight() const

Devuelve la coordenada inferior derecha de este geo rectángulo.

Nota: Función Getter para la propiedad bottomRight.

Véase también setBottomRight().

QGeoCoordinate QGeoRectangle::center() const

Devuelve el centro de este geo rectángulo. Equivalente a QGeoShape::center().

Nota: Función Getter para la propiedad center.

Véase también setCenter().

bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const

Devuelve si el georrectángulo rectangle está contenido en este georrectángulo.

[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)

Extiende el geo rectángulo para cubrir también la coordenada coordinate

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

double QGeoRectangle::height() const

Devuelve la altura de este georrectángulo en grados.

El valor devuelto es indefinido si este geo rectángulo no es válido.

Nota: Función Getter para la propiedad height.

Véase también setHeight().

[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const

Devuelve si el georrectángulo rectangle interseca este georrectángulo.

Si los bordes superior o inferior de ambos geo rectángulos están en uno de los polos, se considera que los geo rectángulos se intersecan, ya que la longitud es irrelevante cuando los bordes están en el polo.

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

void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)

Establece la coordenada inferior izquierda de este georrectángulo en bottomLeft.

Nota: Función Setter para la propiedad bottomLeft.

Véase también bottomLeft().

void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)

Establece la coordenada inferior derecha de este georrectángulo en bottomRight.

Nota: Función Setter para la propiedad bottomRight.

Véase también bottomRight().

void QGeoRectangle::setCenter(const QGeoCoordinate &center)

Establece el centro de este georrectángulo en center.

Si esto hace que el georrectángulo cruce uno de los polos, la altura del georrectángulo se truncará de forma que el georrectángulo sólo se extienda hasta el polo. El centro del georrectángulo no cambiará y la altura se ajustará de forma que el punto central se encuentre en el centro del georrectángulo truncado.

Nota: Función Setter para la propiedad center.

Véase también center().

void QGeoRectangle::setHeight(double degreesHeight)

Establece la altura de este geo rectángulo en grados a degreesHeight.

Nota: Función Setter para la propiedad height.

Véase también height().

void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)

Establece la coordenada superior izquierda de este georrectángulo en topLeft.

Nota: Función Setter para la propiedad topLeft.

Véase también topLeft().

void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)

Establece la coordenada superior derecha de este georrectángulo en topRight.

Nota: Función Setter para la propiedad topRight.

Véase también topRight().

void QGeoRectangle::setWidth(double degreesWidth)

Establece la anchura de este geo rectángulo en grados a degreesWidth.

Nota: Función Setter para la propiedad width.

Véase también width().

[invokable] QString QGeoRectangle::toString() const

Devuelve las propiedades del geo rectángulo como una cadena.

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

QGeoCoordinate QGeoRectangle::topLeft() const

Devuelve la coordenada superior izquierda de este geo rectángulo.

Nota: Función Getter para la propiedad topLeft.

Véase también setTopLeft().

QGeoCoordinate QGeoRectangle::topRight() const

Devuelve la coordenada superior derecha de este geo rectángulo.

Nota: Función Getter para la propiedad topRight.

Véase también setTopRight().

[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)

Traslada este georrectángulo 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.

Si la traslación hubiera provocado que el georrectángulo cruzara un polo, el georrectángulo se trasladará hasta que el borde superior o inferior del georrectángulo toque el polo, pero no más allá.

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

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

Devuelve una copia de este geo rectángulo trasladado 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().

[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const

Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.

Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para asegurar que el resultado es independiente del orden de los operandos.

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

double QGeoRectangle::width() const

Devuelve la anchura de este georrectángulo en grados.

El valor devuelto es indefinido si este geo rectángulo no es válido.

Nota: Función Getter para la propiedad width.

Véase también setWidth().

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

Asigna other a este geo rectángulo y devuelve una referencia a este geo rectángulo.

QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const

Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.

Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para garantizar que el resultado es independiente del orden de los operandos.

QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)

Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.

Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para garantizar que el resultado es independiente del orden de los operandos.

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