En esta página

GeocodeModel QML Type

El tipo `GeocodeModel` permite realizar operaciones de búsqueda relacionadas con la información geográfica. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Señales

Métodos

Descripción detallada

El tipo GeocodeModel se utiliza como parte de un grupo de modelos y vistas para asociar direcciones o cadenas de búsqueda con ubicaciones geográficas. El modo en que se utilizan o muestran las ubicaciones geográficas generadas viene determinado por las vistas asociadas al GeocodeModel (por ejemplo, una MapItemView o una ListView).

Al igual que Map y RouteModel, todos los datos necesarios para que un GeocodeModel funcione proceden de un complemento de servicios. Estos se recogen en la propiedad plugin, que debe configurarse antes de que el GeocodeModel pueda realizar ninguna tarea útil.

Una vez configurado el complemento, la propiedad query puede utilizarse para especificar la dirección o la cadena de búsqueda que se desea encontrar. Si autoUpdate está habilitado, el modelo actualizará su salida automáticamente. De lo contrario, se puede utilizar el método update. Por defecto, autoUpdate está deshabilitado.

Los datos almacenados y devueltos en el GeocodeModel consisten en objetos ` Location `, en forma de lista con el nombre de rol «locationData». Consulte la documentación de ` Location ` para obtener más detalles sobre su estructura y contenido.

Ejemplo de uso

El siguiente fragmento de código consta de dos partes: en primer lugar, muestra la declaración de los objetos y, en segundo lugar, un breve fragmento de código procedimental que los utiliza. Establecemos la propiedad ` autoUpdate ` del `geocodeModel` en `false` y llamamos a ` update ` una vez configurada la consulta. En este caso, dado que utilizamos un valor de cadena en ` query`, solo se produciría una actualización, incluso con ` autoUpdate ` habilitado. Sin embargo, si proporcionáramos un objeto ` Address `, podríamos desencadenar inadvertidamente varias solicitudes al establecer sus propiedades.

Plugin {
    id: aPlugin
}

GeocodeModel {
    id: geocodeModel
    plugin: aPlugin
    autoUpdate: false
}
{
    geocodeModel.query = "53 Brandl St, Eight Mile Plains, Australia"
    geocodeModel.update()
}

Documentación de propiedades

autoUpdate : bool

Esta propiedad controla si el modelo se actualiza automáticamente en respuesta a los cambios en la consulta asociada. El valor por defecto de esta propiedad es «false».

Si se establece este valor en «true» y se utiliza una dirección o un geoCoordinate como consulta, ten en cuenta que cualquier cambio, por pequeño que sea, en las propiedades del objeto provocará el envío de una nueva solicitud. Si modificas muchas propiedades del objeto mientras «autoUpdate» está habilitado, esto puede generar un gran número de solicitudes innecesarias (que posteriormente se descartarán).

bounds : geoShape

Esta propiedad contiene el área delimitada que se utiliza para restringir los resultados a aquellos que se encuentran dentro de dicha área. Esto resulta especialmente útil si la consulta solo se ha rellenado parcialmente, ya que el servicio intentará geocodificar (de forma inversa) todas las coincidencias para los datos especificados.

Los tipos aceptados son « geoRectangle » y « geoCircle ».

count : int [read-only]

Esta propiedad indica el número de ubicaciones que tiene actualmente el modelo. Entre otros usos, puedes utilizar este valor al acceder a las ubicaciones mediante el método ` GeocodeModel::get `.

error : enumeration [read-only]

Esta propiedad de solo lectura contiene el último valor de error de la solicitud de geocodificación.

  • GeocodeModel.NoError: no se ha producido ningún error.
  • GeocodeModel.CombinationError: se ha producido un error al combinar los resultados procedentes de varias fuentes.
  • GeocodeModel.CommunicationError: se ha producido un error al comunicarse con el proveedor de servicios.
  • GeocodeModel.EngineNotSetError: la propiedad «plugin» del modelo no se ha establecido o no hay ningún gestor de geocodificación asociado al complemento.
  • GeocodeModel.MissingRequiredParameterError: no se ha especificado un parámetro obligatorio.
  • GeocodeModel.ParseError: la respuesta del proveedor de servicios tenía un formato no reconocible.
  • GeocodeModel.UnknownError: se ha producido un error que no encaja en ninguna de las demás categorías.
  • GeocodeModel.UnknownParameterError: el complemento no ha reconocido uno de los parámetros que se le han proporcionado.
  • GeocodeModel.UnsupportedOptionError: el proveedor de geocodificación no admite la operación solicitada. Esto puede ocurrir cuando el motor cargado no admite una solicitud de geocodificación concreta, como la geocodificación inversa.

errorString : string [read-only]

Esta propiedad de solo lectura contiene la representación textual del último error de geocodificación. Si no se ha producido ningún error o se ha reiniciado el modelo, se devuelve una cadena vacía.

También puede devolverse una cadena vacía si se ha producido un error que no tiene una representación textual asociada.

limit : int

Esta propiedad indica el número máximo de resultados. Los valores de «limit» y « offset » solo son aplicables en el caso de la geocodificación de cadenas libres (es decir, no se tienen en cuenta cuando se utilizan direcciones o coordenadas en la consulta de búsqueda).

Si el valor de «limit» es -1, se devolverá el conjunto completo de resultados; en caso contrario, se devolverán como máximo «limit» resultados. Los valores de «limit» y « offset » pueden utilizarse conjuntamente para implementar la paginación.

offset : int

Esta propiedad indica que no se devuelva el primer número de resultados especificado por el parámetro «offset». Los valores de « limit » y «offset» solo son aplicables en la geocodificación de cadenas libres (es decir, no se tienen en cuenta cuando se utilizan direcciones o coordenadas en la consulta de búsqueda).

Los resultados de « limit » y «offset» pueden utilizarse conjuntamente para implementar la paginación.

plugin : Plugin

Esta propiedad contiene el complemento que proporciona el servicio de geocodificación propiamente dicho. Ten en cuenta que no todos los complementos ofrecen necesariamente geocodificación (por ejemplo, podrían ofrecer únicamente cálculo de rutas o mapas).

Véase también Plugin.

query : QVariant

Esta propiedad contiene los datos de la solicitud de geocodificación. La propiedad admite tres tipos de consultas que determinan tanto los datos como el tipo de acción que se va a realizar:

  • Dirección - Geocodificación (de dirección a coordenadas)
  • geoCoordinate - Geocodificación inversa (de coordenadas a dirección)
  • cadena de caracteres - Geocodificación (de dirección a coordenadas)

status : enumeration [read-only]

Esta propiedad de solo lectura contiene el estado actual del modelo.

  • GeocodeModel.Null: no se ha enviado ninguna solicitud de geocodificación ni se ha llamado a reset.
  • GeocodeModel.Ready: las solicitudes de geocodificación se han completado con éxito.
  • GeocodeModel.Loading: se ha enviado una solicitud de geocodificación, pero aún no ha finalizado
  • GeocodeModel.Error: se ha producido un error de geocodificación; los detalles se encuentran en error y errorString

la documentación de Signal.

locationsChanged()

Esta señal se emite cuando se han producido cambios en las ubicaciones del modelo.

Nota: El controlador correspondiente es onLocationsChanged.

Véase también count.

Documentación del método

void cancel()

Cancela cualquier solicitud pendiente y corrige los errores. El estado del modelo se establecerá como « GeocodeModel.Null» o « GeocodeModel.Ready».

Location get(int index)

Devuelve el objeto ` Location ` en la posición indicada ` index`. Utiliza la propiedad ` count ` para comprobar el número de posiciones disponibles. Las posiciones se indexan a partir de cero, por lo que el rango accesible es 0...(count - 1).

Si se accede fuera de los límites, se devuelve un cero (objeto nulo) y se emite una advertencia.

void reset()

Restablece el modelo. Se borran todos los datos de ubicación, se cancelan las solicitudes pendientes y se eliminan los posibles errores. El estado del modelo se establecerá en « GeocodeModel.Null».

void update()

Indica a la base de datos « GeocodeModel » que actualice sus datos. Esto resulta especialmente útil cuando la opción « autoUpdate » está desactivada, para forzar una actualización cuando se ha modificado la consulta.

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