Location QML Type
El tipo «Ubicación» contiene datos de ubicación. Más información...
| Import Statement: | import QtPositioning |
Propiedades
- address : Address
- boundingShape : geoShape
(since QtPositioning 6.2) - coordinate : coordinate
- extendedAttributes : VariantMap
- location : QGeoLocation
Descripción detallada
Los tipos de ubicación representan una «ubicación» geográfica, en el sentido humano del término. Consisten en un coordinate específico, un address y un bounding shape. El bounding shape representa la región recomendada que debe mostrarse al visualizar esta ubicación.
El tipo «Ubicación» suele aparecer como contenido de un modelo de búsqueda, como el GeocodeModel. Cuando un GeocodeModel devuelve la lista de ubicaciones encontradas para una consulta determinada, las representa como objetos de tipo «Ubicación».
Ejemplo de uso
El siguiente ejemplo muestra la declaración de un objeto «Location» sencillo:
Location {
coordinate {
latitude: -27.3
longitude: 153.1
}
address: Address {
...
}
}Documentación de las propiedades
address : Address
Esta propiedad contiene la dirección de la ubicación, que se puede utilizar para obtener los datos de la misma.
boundingShape : geoShape [since QtPositioning 6.2]
Esta propiedad contiene la región recomendada que se debe utilizar al mostrar la ubicación. Por ejemplo, la ubicación de un edificio puede tener una región centrada en torno al edificio, pero la región es lo suficientemente amplia como para mostrar el contexto geográfico de su entorno inmediato.
Nota: Esta propiedad se introdujo en Qt6 en sustitución de la propiedad `boundingBox`. Devuelve un objeto ` geoShape ` en lugar de un ` geoRectangle`. Utiliza ` QGeoShape::boundingGeoRectangle()` para obtener un ` geoRectangle ` delimitador para la forma.
Si necesitas convertir la forma devuelta a un tipo específico, utiliza la propiedad type de geoShape junto con los métodos de conveniencia de QtPositioning, como QtPositioning.shapeToRectangle().
Esta propiedad se introdujo en QtPositioning 6.2.
coordinate : coordinate
Esta propiedad contiene las coordenadas geográficas exactas de la ubicación, que pueden utilizarse para obtener la latitud, la longitud y la altitud de la misma.
extendedAttributes : VariantMap
Esta propiedad contiene los atributos extendidos de esta ubicación. Los atributos extendidos dependen del backend y pueden depender de la ubicación.
location : QGeoLocation
Para obtener más información sobre cómo utilizar esta propiedad para establecer una interfaz entre C++ y QML, consulta «Interfaces entre el código C++ y QML».
Nota: Esta propiedad actualiza toda la información de geolocalización, por lo que su uso provocará que se rompan todos los enlaces de las demás propiedades.
© 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.