En esta página

QGeoRectangle Class

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

Encabezado: #include <QGeoRectangle>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Heredan: 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 mediante un « QGeoCoordinate », que especifica la coordenada superior izquierda del rectángulo, y un « QGeoCoordinate », que especifica la coordenada inferior derecha del rectángulo.

Un rectángulo geográfico se considera inválido si las coordenadas de la esquina superior izquierda o de la esquina inferior derecha son inválidas, o si la coordenada de la esquina superior izquierda se encuentra al sur de la coordenada de la esquina inferior derecha.

Los rectángulos geográficos nunca pueden atravesar los polos.

Varios métodos se comportan como si el rectángulo geográfico se definiera en términos de una coordenada central, la anchura del rectángulo geográfico en grados y la altura del rectángulo geográfico en grados.

Si se ajusta la altura o el centro de un rectángulo geográfico de tal forma que atravesara uno de los polos, la altura se modifica para que el rectángulo geográfico toque el polo sin atravesarlo y para que la coordenada central siga estando en el centro del rectángulo geográfico.

También se puede acceder a esta clase en QML como geoRectangle.

Documentación de propiedades

bottomLeft : QGeoCoordinate

Esta propiedad contiene la coordenada inferior izquierda de este rectángulo geométrico.

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 de la esquina inferior derecha de este rectángulo geométrico.

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 rectángulo geométrico.

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 rectángulo geográfico en grados.

El valor de la propiedad no está definido si este rectángulo geográfico no es válido.

Si la nueva altura es inferior a 0,0 o si este rectángulo geográfico no es válido, la propiedad no se modifica. Para configurar los valores de un rectángulo geográfico no válido en función del centro, la anchura y la altura, debes utilizar primero setCenter() para que el rectángulo geográfico sea válido.

Si el cambio en la altura provocara que el rectángulo geográfico atravesara un polo, la altura se ajusta de tal forma que el rectángulo geográfico solo toque el polo.

Este cambio se realiza de tal forma que la coordenada del centro siga estando en el centro del rectángulo geográfico, lo que puede dar lugar a un rectángulo geográfico con una altura menor de lo esperado.

Se utiliza una altura de 180,0 únicamente 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 rectángulo geográfico.

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 de la esquina superior derecha de este rectángulo geométrico.

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 la anchura de este rectángulo geográfico en grados.

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

Si el nuevo ancho es inferior a 0,0 o si este rectángulo geográfico no es válido, esta función no realiza ninguna acción. Para configurar los valores de un rectángulo geográfico no válido basándose en el centro, el ancho y la altura, debes utilizar primero ` setCenter()` para que el rectángulo geográfico sea válido.

Se utiliza el ancho 360,0 únicamente si el nuevo ancho es igual o superior a 360. En tales casos, la longitud más a la izquierda del rectángulo geográfico se establece en -180,0 grados y la longitud más a la derecha del rectángulo geográfico 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 las funciones miembro

QGeoRectangle::QGeoRectangle()

Crea un nuevo rectángulo geográfico no válido.

QGeoRectangle::QGeoRectangle(const QGeoShape &other)

Crea un rectángulo geográfico a partir del contenido de other.

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

Crea un nuevo rectángulo geográfico, de tamaño mínimo, que contenga todos los elementos de coordinates.

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

Crea un nuevo rectángulo geográfico con la coordenada superior izquierda topLeft y la coordenada inferior derecha bottomRight.

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

Crea un nuevo rectángulo geográfico centrado en center, con una anchura en grados de degreesWidth y una altura en grados de degreesHeight.

Si degreesHeight hiciera que el rectángulo geográfico se extendiera más allá de uno de los polos, la altura del rectángulo geográfico se recortará de tal forma que el rectángulo geográfico solo se extienda hasta el polo. El centro del rectángulo geográfico no se modificará, y la altura se ajustará de manera que el punto central quede en el centro del rectángulo geográfico recortado.

QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)

Crea un rectángulo geográfico a partir del contenido de other.

[noexcept] QGeoRectangle::~QGeoRectangle()

Elimina este rectángulo geométrico.

QGeoCoordinate QGeoRectangle::bottomLeft() const

Devuelve la coordenada inferior izquierda de este rectángulo geométrico.

Nota: Funcióngetter para la propiedad bottomLeft.

Véase también setBottomLeft().

QGeoCoordinate QGeoRectangle::bottomRight() const

Devuelve la coordenada de la esquina inferior derecha de este rectángulo geométrico.

Nota: Funcióngetter para la propiedad bottomRight.

Véase también setBottomRight().

QGeoCoordinate QGeoRectangle::center() const

Devuelve el centro de este rectángulo geométrico. Equivalente a ` QGeoShape::center()`.

Nota: Funcióngetter para la propiedad «center».

Véase también setCenter().

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

Devuelve si el rectángulo geográfico rectangle está contenido dentro de este rectángulo geográfico.

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

Amplía el rectángulo geográfico para que también abarque la coordenada coordinate

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

double QGeoRectangle::height() const

Devuelve la altura de este rectángulo geográfico en grados.

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

Nota: Funcióngetter para la propiedad «height».

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

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

Devuelve si el rectángulo geográfico rectangle se cruza con este rectángulo geográfico.

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

Nota: Esta función se puede invocar 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 rectángulo geométrico en bottomLeft.

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

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

void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)

Establece la coordenada inferior derecha de este rectángulo geométrico en bottomRight.

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

Véase también bottomRight().

void QGeoRectangle::setCenter(const QGeoCoordinate &center)

Establece el centro de este rectángulo geométrico en center.

Si esto hace que el rectángulo geométrico atraviese uno de los polos, la altura del rectángulo geométrico se recortará de tal forma que el rectángulo geométrico solo se extienda hasta el polo. El centro del rectángulo geométrico permanecerá sin cambios, y la altura se ajustará de tal forma que el punto central quede en el centro del rectángulo geométrico recortado.

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

Véase también center().

void QGeoRectangle::setHeight(double degreesHeight)

Establece la altura de este rectángulo geométrico en grados en degreesHeight.

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

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

void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)

Establece la coordenada superior izquierda de este rectángulo geográfico en topLeft.

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

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

void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)

Establece la coordenada superior derecha de este rectángulo geométrico en topRight.

Nota: Funciónde asignación para la propiedad ` topRight`.

Véase también topRight().

void QGeoRectangle::setWidth(double degreesWidth)

Establece la anchura de este rectángulo geométrico, expresada en grados, en degreesWidth.

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

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

[invokable] QString QGeoRectangle::toString() const

Devuelve las propiedades del rectángulo 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.

QGeoCoordinate QGeoRectangle::topLeft() const

Devuelve la coordenada superior izquierda de este rectángulo geográfico.

Nota: Funcióngetter para la propiedad topLeft.

Véase también setTopLeft().

QGeoCoordinate QGeoRectangle::topRight() const

Devuelve la coordenada superior derecha de este rectángulo geográfico.

Nota: Funcióngetter para la propiedad topRight.

Véase también setTopRight().

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

Traslada este rectángulo geográfico un valor de degreesLatitude hacia el norte y de degreesLongitude hacia el este.

Los valores negativos de degreesLatitude y degreesLongitude corresponden a un desplazamiento hacia el sur y hacia el oeste, respectivamente.

Si la traslación hubiera provocado que el rectángulo geométrico atravesara un polo, este se trasladará hasta que el borde superior o inferior del rectángulo geométrico toque el polo, pero no más allá.

Nota: Esta función se puede invocar 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 rectángulo geográfico desplazado degreesLatitude hacia el norte y degreesLongitude hacia el este.

Los valores negativos de degreesLatitude y degreesLongitude corresponden a desplazamientos 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().

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

Devuelve el rectángulo geográfico más pequeño que contenga tanto este rectángulo geográfico como rectangle.

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

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

double QGeoRectangle::width() const

Devuelve la anchura de este rectángulo geográfico en grados.

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

Nota: Funcióngetter para la propiedad «width».

Véase también setWidth().

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

Asigna « other » a este rectángulo geográfico y devuelve una referencia a dicho rectángulo.

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

Devuelve el rectángulo geográfico más pequeño que contenga tanto este rectángulo geográfico como rectangle.

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

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

Devuelve el rectángulo geográfico más pequeño que contenga tanto este rectángulo geográfico como rectangle.

Si los centros de los dos rectángulos geográficos están separados exactamente por 180,0 grados, la anchura se establece en 360,0 grados, con la longitud más a la izquierda fijada en -180,0 grados y la longitud más a la derecha fijada en 180,0 grados. Esto se hace para garantizar que el resultado sea 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.