Comienza a usar QFieldCloud

Qué es QFieldCloud

QFieldCloud is the cloud service that allows smoothless synchronization of your data between your mobile device for fieldwork and your desktop working station. You can further manage teams, work in organizations, assign different editing permissions and much more.

Register to QFieldCloud

Preparación en escritorio

Flujo

1. Go to the Sign up page, enter your details and create a new QFieldCloud account.
2. (Optionable) If you have received a referral code, please enter it in the according field.

   

   Registration form

Descripción general de QFieldCloud

Once registered, your personal QFieldCloud landing page will show all the projects that you have access to in the center of the window. In case that you have many projects, you can search in the search bar at the top of the page. It is also possible to create a new empty project from this menu. All further configuration of that project, however, needs to be done inside QGIS. Under your profile name, you are able to edit and manage your account details and get an overview of what organizations you are a member of, as well as what collaborations you have. Finally, if you have subscribed to a plan through QFieldCloud, you can manage it from here.

Before you get started, we recommend to familiarize yourself with the basic concepts of QFieldCloud.

Tip

In the project overview page, the two names indicate the "Owner" of the project and the "Name" of the project.

QFieldCloud projects overview

Filtering Projects

:monitor-material: Escritorio

When managing a large number of cloud projects, you can refine your project list using the Filters dropdown button located next to the search bar.

The dropdown menu allows you to filter projects by three primary criteria:

• Ownership: (User accounts only):

  • My own projects: Displays only projects where your account is the primary owner.
  • Shared with me: Displays projects owned by collaborators or organizations where you have been granted access.

• Project type:

  • Regular projects: Standard QGIS mapping projects created for field data collection.
  • Shared datasets: Centralized datasets stored in the dedicated shared_datasets project repository.
  • Template Projects: Projects that are locked for fieldworkers and only used as project templates.

When any filter option is active, clicking Clear button immediately resets all active filter parameters and restores the full project view.

Project Creation

There are several ways to create and initialize a new project in QFieldCloud depending on your workflow. You can convert an existing QGIS project, start from a blank template on the web, or even clone an existing project.

Click here to read more about project creation

De QFieldCloud a QGIS Desktop

Preparación en escritorio

Para conectarte a QFieldCloud, necesitas el plugin QFieldSync en QGIS. Los siguientes pasos le muestran cómo puede instalar y sincronizar sus datos hacia y desde QFieldCloud.

Flujo

1. Open the QGIS plugin manager by going to Plugins > Manage and Install Plugins...
2. Under "All", find QFieldSync in the list and install the latest version by clicking the "Install Plugin" button.

   

   Successful installation

   After successful installation, a new toolbar appears:

   

   Toolbar

3. Click the cloud icon in the QFieldSync toolbar and a new login screen will appear:

   

4. Enter your credentials previously created during account registration.

Warning

If you use a password in QGIS for the first time, it will ask you to set a master password that manages all the other passwords used in QGIS. More information about the master password here: QGIS documentation

Descripción general del proyecto en QFieldSync

La vista general de proyectos muestra los diferentes proyectos a los que tiene acceso su cuenta. La pantalla está organizada de la siguiente manera:

• Usuario actual subrayado en azul
• The avatar on the top right leading to the sign out page.
• Un botón en la nube para crear un nuevo proyecto
• Un botón de actualización a la derecha permite actualizar la vista general del proyecto a la etapa actual.

Ejemplo de resumen de proyectos en QFieldSync

Los usuarios recién registrados verán una tabla vacía. Al hacer doble clic en un proyecto de la lista, podrá ver y editar sus propiedades específicas.

Estado del proyecto

Los iconos indican el estado en la nube y local de los diferentes proyectos.

• Situación local:

  • indica que solo existe un proyecto en la nube remoto.

  • indica que el proyecto en la nube también está almacenado localmente.

• Estado en la nube: Existen tres tipos diferentes de estado, indicados por un color, que muestran el estado actual de su proyecto en la nube. The status of each project is shown with a tooltip.

  • Red Status: The project is invalid and is not ready for use in the field. There are multiple reasons for this and the status message on your QFieldCloud landing page is the first step to address the issue.
  • Estado marrón: El proyecto se encuentra actualmente en proceso de actualización o edición.
  • Estado Verde: El proyecto está listo para ser utilizado en el campo. You can download the project down to QField.

Configuración del proyecto QField

Una vez instalado el plugin QFieldSync, aparecerá una nueva sección en Proyecto > Propiedades. También está disponible en la barra de herramientas de QFieldSync () a través del icono de Configuración. En esta configuración puede ajustar lo siguiente:

• Cómo se deben tratar las capas de su proyecto en la nube. Consulte la Guía de introducción a QFieldSync para obtener más detalles sobre las diferentes "Acciones de empaquetado".
• Habilitar "geocercas"
• Asignar una capa de registro digitalizador.
• Especifique la capa que estará activa para su edición después de seleccionar un Tema de mapa

Recomendamos trabajar con GeoPackages, especialmente al trabajar en equipo. Consulte la guía de configuración avanzada para obtener más información sobre los formatos vectoriales.

!!! Importante! Si utiliza fuentes de datos experimentales sin un campo de clave primaria (por ejemplo, Shapefiles, GeoJSON, etc.), debe tener un campo fid en minúsculas que se utilizará como clave primaria para identificar de forma única cada elemento.

Subida de proyecto

Una vez configurado, el proyecto se puede cargar en QFieldCloud.

Flujo

1. Pulse el icono de la nube con las flechas en la barra de herramientas de QFieldSync. Aquí debe elegir su opción preferida:
2. Archivo local: Esto reemplazará su archivo en la nube con una nueva versión del proyecto. Nota: Al trabajar con GeoPackages, la versión actual del archivo en la nube se reemplazará con la versión local.
3. Archivo en la nube: Esto modificará sus conjuntos de datos locales y reemplazará su archivo de proyecto con el actual.

Sincronizar

Ahora debería ver su proyecto y archivos en la página de resumen de su proyecto en QFieldCloud.

Dispositivo móvil

Comenzar con QField

Trabajo de campo

Cuando esté listo para tu trabajo de campo, es hora de configurar QField en su dispositivo móvil.

Flujo

1. Download and install the latest version of QField from Google's Play Store, Apple's App Store, or by downloading the latest release for Windows, Linux, or macOS.
2. Direct to Cloud Projects and log in to QFieldCloud on your mobile device

   

   Welcome

   

   Login

3. Select a project to download on your device:

   

   Download

Advanced Project Searching and Filtering

Trabajo de campo

To easily manage an abundance of projects, QField features a rich search-and-filter panel directly on the QFieldCloud projects screen.

The Filter button sits to the right of the project search bar.

1. Predefined Filter Presets

At the top of the filter panel is a quick preset buttons (such as My Own Projects, {org_name}'s projects). Tapping any preset instantly populates the criteria form and automatically filters the underlying list.

2. Form-Based Filtering Criteria

You can fine-tune your project queries by filling out distinct fields in the filter pane:

• Search term: Every project title or description that contains the provided term(s) will be selected.
• Owner: An editable dropdown combobox that automatically displays a list of unique project owners available to your account.
• Include public projects: A toggle switch that lets you pull in or hide community public projects.

Nota

Community projects are projects that are marked as public by any project owner. Public projects are available to view to every user of QFieldCloud. Edits, however, can only be made in case that you as a project owner adds them as collaborators to your project. For this, you do not need to have an organization account.

3. Power-User Search Syntax

The filter panel acts as visual "training wheels," but the main search bar is built for power users. Advanced filter parameters can be typed directly into the search bar using a dedicated key-value syntax.

Key parameters are dynamically recognized and highlighted in a distinct accent color directly inside the text input box.

Supported syntax tokens include:

• owner:name — Filters the list to only show projects belonging to a specific user or organization account name.
• include:public — Forces public projects to be included in the query evaluation.

Example Query: Typing owner:My_Organization include:public Forestry directly into the search field instantly isolates public projects matching the keyword "Forestry" owned by "My_Organization".

Sincronización con QFieldCloud

After you are done with data collection, you will need to synchronize your changes back to QFieldCloud.

Flujo

1. Open the Side Dashboard in QField.
2. Click on the cloud icon (a badge will indicate how many local changes you have made).

   

   Cloud button

3. • Upload local changes: Sends your edits and attachments to the cloud without downloading project updates from other collaborators. This is fast and saves internet bandwidth.
   • Synchronize project: Uploads your edits, then downloads the latest project from QFieldCloud so everything is completely up to date.
   • Upload history: Tap this button below the main actions to view a detailed log of your past uploads, including timestamps and their current statuses (e.g., Applied, Pending, Conflict, Error).
   • Danger zone: Tap this button to if you wish to revert previous actions or restore the current version of the cloud project. You can Discard local changes (which removes all your local edits that have not yet been uploaded) or Reset project (which re-downloads the cloud version if your local copy becomes corrupted).

   Choose the appropriate action card for your data:

   

Sus cambios están ahora disponibles para todos los que tengan acceso a su proyecto en la nube.

You can find more information on Advanced QFieldCloud setup and QFieldCloud technical reference.