Location QML Type
El tipo Location contiene datos de localización. Más...
| 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 localización representan una "ubicación" geográfica, en sentido humano. Se compone de un coordinate específico, un address y un bounding shape. El bounding shape representa la región recomendada para mostrar cuando se visualiza esta ubicación.
El tipo Location se ve más comúnmente como el contenido de un modelo de búsqueda como el GeocodeModel. Cuando un GeocodeModel devuelve la lista de localizaciones encontradas para una consulta dada, las representa como objetos Location.
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 {
...
}
}Propiedad Documentación
address : Address
Esta propiedad contiene la dirección de la ubicación que se puede utilizar para recuperar los detalles de la dirección de la ubicación.
boundingShape : geoShape [since QtPositioning 6.2]
Esta propiedad contiene la región recomendada para mostrar la ubicación. Por ejemplo, la ubicación de un edificio puede tener una región centrada alrededor del edificio, pero la región es lo suficientemente grande como para mostrar su contexto geográfico circundante inmediato.
Nota: Esta propiedad se introdujo en Qt6 en lugar de la propiedad boundingBox. Devuelve un geoShape en lugar de un geoRectangle. Utilice QGeoShape::boundingGeoRectangle() para obtener un geoRectangle delimitador de la forma.
Si necesita convertir la forma devuelta a un tipo específico, utilice la propiedad type de geoShape junto con métodos de QtPositioning como QtPositioning.shapeToRectangle().
Esta propiedad se introdujo en QtPositioning 6.2.
coordinate : coordinate
Esta propiedad contiene la coordenada geográfica exacta de la ubicación que se puede utilizar para recuperar la latitud, longitud y altitud de la ubicación.
extendedAttributes : VariantMap
Esta propiedad contiene los atributos ampliados de esta Ubicación. Los atributos extendidos dependen del backend y pueden depender de la ubicación.
location : QGeoLocation
Para más detalles sobre cómo utilizar esta propiedad para interactuar entre C++ y QML, véase"Interfaces entre código C++ y QML".
Nota: Esta propiedad actualiza toda la información de geolocalización, por lo que al utilizarla se romperán 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.