geoGPS

← Volver a la ayuda

Los manuales están disponibles en inglés.

geoGPS QGIS plugin – user manual

The geoGPS QGIS plugin connects QGIS with the geoGPS Cloud. It lets you load into QGIS the objects collected with the geoGPS mobile app, edit them, add new ones, handle photos, and import and export data. Changes are saved on the server straight away and are visible in the mobile app and in the web panel (https://geogps.cloud).

This manual applies to version 1.4.14 and follows the order of work: installation → signing in → choosing a project → working with objects → tools and measurements → import and export.

Table of contents

Part I – Getting started

  1. Requirements
  2. Installation and update
  3. The geoGPS toolbar
  4. Signing in

Part II – Project and layers

  1. Basic terms
  2. Projects and the active project
  3. geoGPS layers in QGIS
  4. Object labels on the map

Part III – Working with objects

  1. Adding a new object
  2. Editing an object
  3. Photos
  4. Changing geometry
  5. Object list
  6. Tools
  7. Coordinates and measurements on the map

Part IV – Data exchange

  1. Exporting objects
  2. Importing objects

Part V – Other

  1. Information and logging out
  2. Permissions
  3. Troubleshooting

Part I – Getting started

1. Requirements

2. Installation and update

Installation

  1. Download the plugin ZIP file.
  2. In QGIS choose Plugins → Manage and Install Plugins → Install from ZIP.
  3. Select the downloaded file and click Install Plugin.
  4. Make sure the "geoGPS QGIS" plugin is ticked on the list of installed plugins.

After installation the geoGPS toolbar appears, along with the geoGPS item in the Plugins menu.

Update

  1. Close QGIS and delete the old plugin folder from the QGIS profile.
  2. Start QGIS and install the new version from the ZIP file, as above.
  3. Restart QGIS.

Interface language

The plugin works in Polish or English — by default it follows the QGIS language. To change it:

  1. Choose Plugins → geoGPS → Język / Language.
  2. Choose Automatic (QGIS language), Polski or English.
  3. Restart QGIS — the change takes effect after a restart.

3. The geoGPS toolbar

All functions are available from the geoGPS toolbar and from the Plugins → geoGPS menu. The toolbar icons are split by separators into groups: account and data, drawing, object, tools, measurements, session.

IconWhat it doesWhen it is active
LoginSigning in to the geoGPS Cloud.Before signing in.
ProjectsProject list, choosing the active project, creating, editing, deleting and importing projects.After signing in.
ObjectsList of the active project's objects, import, export.After signing in and choosing a project.
New pointAdding a point by clicking on the map.After signing in and choosing a project.
New lineAdding a line.After signing in and choosing a project.
New areaAdding an area.After signing in and choosing a project.
Edit objectClicking an object on the map opens its editing; clicking a photo marker opens the photo preview.After signing in.
Label objectsChoosing what the object labels on the map show.After signing in.
Rotate symbolRotating the symbol of a selected point (saves its azimuth).After signing in.
AverageAveraging several selected points, saved as a new point.After signing in and choosing a project.
Offset (parallel line)A copy of a line shifted sideways or along height H.After signing in and choosing a project.
Extend lineExtending a line by a given length from the selected end.After signing in and choosing a project.
Perpendicular segmentA segment of a given length perpendicular to a line.After signing in and choosing a project.
CoordinatesReading the coordinates of the clicked place and copying them to the clipboard.After signing in.
Measure distanceMeasuring a length on the map, without saving an object.After signing in.
Measure areaMeasuring an area on the map, without saving an object.After signing in.
Log outLogging out and removing the geoGPS layers from QGIS.After signing in.
InformationVersion, sign-in status, description of the system.Always.

The Język / Language item is available in the menu only (chapter 2).

Icons that cannot work at a given moment are greyed out. The tooltip shown on mouse hover tells you what to do (sign in or choose a project).

These functions are not in the plugin: Surfaces, Volume, GML layers and GML export are in the mobile app, and IFC export, PDF reports of objects and projects and exporting a whole project to ZIP are in the web panel.

4. Signing in

Signing in takes two steps.

  1. Click Login. The geoGPS splash screen appears, followed by the login window.
  2. Enter your login or e-mail and password ("Show" reveals the password) and click Sign in. With Remember login ticked, the login is suggested the next time you sign in; the password is not remembered.
  3. The server sends a 6-digit code: by e-mail to the account address and as a push notification to the geoGPS app on your phone. The code is valid for 3 minutes.
  4. In the Login code window enter the code and click Confirm. The window shows where the code was sent and a countdown.

Special cases:

The organization and user identifiers are fetched automatically when you sign in — you do not need to enter them anywhere.


Part II – Project and layers

5. Basic terms

TermMeaning
ProjectA set of objects with its own coordinate system and geoid model.
Active projectThe project whose objects are loaded into QGIS and to which new objects are added.
ObjectA point, line or area with a name, description, attributes and photos.
Object typeAn object category (e.g. "Hydrants") that determines how it looks. In QGIS every type is a separate layer.
Geometric dataThe measurement record of each point: B/L, X/Y in the project's coordinate system, heights, accuracy, measurement status.
Object attributesAny key–value pairs added to an object.

6. Projects and the active project

  1. Click Projects. The list shows the organization's projects with these columns: name, status, coordinate system (e.g. "ETRF2000-PL / CS2000/21 (EPSG:2178)"), geoid model, update date, author, number of objects and number of photos.
  2. The list can be searched (name, status, author), and sorted by clicking a header. The active project is highlighted.
  3. Click a project and choose Set as active (or double-click it).

After a project is chosen:

A project with the "blocked" status can be set as active, but its objects are not loaded — the plugin shows "The active project is blocked - its objects are not loaded."

New project

  1. In the Projects window click the New project icon above the table (the last of three icons: delete, import, new).
  2. Enter the project name, choose the coordinate system with the Change… button (a system from the EPSG database) and the geoid model — the list contains the models for the area of the chosen system. The description is optional.
  3. Click Save.

Editing and deleting a project

Importing a project (ZIP)

  1. Click the Import project (ZIP) icon above the table.
  2. Choose the ZIP file created by a project export in the web panel.
  3. The plugin shows the number of imported objects and photos (and of skipped ones, if the file contained invalid data).

An import always creates a new project on your account — it does not overwrite existing ones. Exporting a whole project to a ZIP is done in the web panel.

7. geoGPS layers in QGIS

The objects of all users of the organization in the active project are loaded. Other people's objects are available for viewing only (chapter 19).

The geoGPS layers are managed by the plugin and are read-only in QGIS — they cannot be changed with the attribute table or the QGIS vertex tool. Make changes to objects with the plugin's tools (object editing, including X/Y/H coordinates, and changing geometry) — only they save the data on the server.

After an object is saved, added or deleted, the plugin updates only what has changed: the other layers are not reloaded.

The "Object photos" layer

On top of the project group there is the Object photos layer — the same as on the map in the web panel. A purple camera marker stands where each photo of the active project's objects was taken. Photos without a saved position have no marker.

8. Object labels on the map

The Label objects icon opens a window with tiles — clicking a tile selects the option immediately:

OptionWhat it shows
No labelObjects without labels.
Object nameThe object name (the default setting).
ElevationThe height of the measured point. Lines, areas and points without a height show "NULL".
Other parameterThe value of a chosen attribute. After choosing it, enter the Parameter key. An object without this attribute shows "NULL".

The choice takes effect immediately on all geoGPS layers and is remembered. The selected option has an orange frame and a ✓ mark.

The labels look the same as in the mobile app: points — red, below the point; lines — navy blue, along the line; areas — orange, in the center; all with a white outline. The size comes from the object type, and when it is not set there, it is 20.


Part III – Working with objects

9. Adding a new object

A new object is added to the active project.

  1. Click New point, New line or New area. The cursor changes into an orange cross, and a hint bar with the Finish and Cancel buttons appears at the bottom of the map.
  2. Pick the geometry:
    • point — a single click on the map,
    • line — click successive vertices, at least 2,
    • area — click successive vertices, at least 3; the area closes by itself.

    A line and an area are finished with the Finish button or a double click. Esc or Cancel stops drawing.

  3. If you click within 18 pixels of another geoGPS object, the question "Snap to object?" appears:
    • Object — the point lands exactly on the existing object,
    • Coordinates — the exact clicked place is kept.
  4. In the New point / New line / New area window fill in:
    • Object type,
    • Name (required),
    • Description,
    • Object attributes — any number of key–value pairs.
  5. Click Save object.

If saving fails, the error is shown in the window, which stays open — you can correct the data and try again.

Geometric data is saved for every vertex: B/L and X/Y in the coordinate system of the active project, with the status "Manual (map pick)". After saving, the layer of the given type is reloaded from the server in full; if it was not present in QGIS, it is created.

10. Editing an object

The edit window can be opened in two ways:

The Edit object window has the same layout as editing in the web panel:

PartContents
Object typeA list of types with the same geometry type. Changing the type moves the object to another layer.
Name, DescriptionThe basic object data.
Geometric dataX / Y / H fields for editing coordinates (see below) and a table with the measurements of each point — read-only.
Object attributesKey/Value rows. "+ Add attribute" adds a row, "Delete" removes it. Yes/no values and numbers are stored as boolean and numeric types.
PhotosThumbnails and adding photos (chapter 11).
InformationGUID, creation date, last update date.

Buttons:

Another user's object

Another user's object opens in the View object window: the fields are locked, and there is Close instead of Cancel. There are no Save, Change geometry or Delete buttons. Show on map and Export remain available.

Editing X/Y/H coordinates

At the top of the Geometric data part there are fields for entering coordinates — one row for a point, and for a line or an area one Vertex N row per vertex.

When you click Save, the plugin:

Invalid values (e.g. letters in X/Y or a point outside the B/L range) block saving — the plugin shows a message and the window stays open.

If someone else changed the same object while you were editing it (e.g. in the mobile app or in the panel), a conflicting changes window appears on saving and asks whether to overwrite those changes with yours. Yes saves your version; No saves nothing — open the object again to see the current data. The same applies to saving geometry (chapter 12).

11. Photos

The Photos part of the object edit window:

Photo changes are saved immediately, independently of the "Save" button in the object window. After the object window is closed (also with Cancel), the Object photos layer refreshes by itself.

Photos on the map

A photo can also be opened from the map, from the Object photos layer (chapter 7):

  1. Click Edit object and then a photo marker.
  2. The same preview as in the object window opens. When there are several photos in the clicked place, move between them with the previous / next buttons.
  3. When an object also lies under the marker, the SELECT OBJECT window appears — choose the object or the Photos: N item.

After a photo is deleted or its description changed, the photos layer refreshes by itself. The number of photos in the organization is limited by the subscription package.

12. Changing geometry

The tool works the same way as "CHANGE GEOMETRY" in the mobile app.

  1. In the Edit object window click Change geometry. If the form has unsaved changes, the plugin asks whether to save them.
  2. The map is set on the object (point — a close zoom; line or area — the whole object with a margin). The vertices are shown as blue numbered circles, and the line or the area boundary as a dashed line.
  3. Edit the geometry:
ActionHow to do it
Moving a vertexDrag the circle to a new place.
Snapping to another objectRelease the vertex next to another geoGPS object. With a point, its elevation is taken over as well. When there are several objects, choose the right one from the list.
Deleting a vertex (line, area)Click the vertex and choose Delete from the "Point N" menu. At least 2 (line) or 3 (area) must remain.
Moving a vertex by pickingClick the vertex, choose Move on map, pick the new place.
Inserting a vertex on a sideClick next to a side of the line or area.
Adding a vertex at the endClick elsewhere on the map.
Relocating a pointFor a point object: click the map in the new place.
Panning and zooming the mapDrag in an empty place; the mouse wheel zooms in and out.
  1. The bar at the bottom shows the current result: Distance (line), Area (area) or B, L (point).
  2. Click SAVE, or stop with Cancel / Esc.

Saving sets the new geometry, writes the geometric data of the vertices anew (status "Manual (map pick)", X/Y in the project's coordinate system) and recalculates the length or the area of the object.

13. Object list

The Objects icon opens the list of the active project's objects (of all users of the organization). The window title is the project name.

Above the table, next to the filters, there are these icons:

14. Tools

The five tools on the geoGPS toolbar are the same tools as in the "Tools" window on the map in the web panel and in the mobile app. Each has its own icon. After clicking it, select an object on the map; Esc ends the tool. When there are several objects in the clicked place, choose the right one from the list.

ToolYou selectResult
Rotate symbola point with a symbolchanged azimuth of that point
Averagesuccessive pointsa new point
Offset (parallel line)a linea new line
Extend linea line, closer to the end to extendthe changed line or its copy
Perpendicular segmenta place on a linea new two-point line

New objects go to the active project and get the same object type as the selected object. Values in meters can be typed with a comma or a dot.

Rotate symbol

It works only for your own points whose object type has a symbol (chapter 7) — a plain dot has no direction.

  1. Click Rotate symbol and then a point.
  2. Set the azimuth in degrees (0° = north, clockwise): with the slider, by typing a value or with the −90°, −5°, +5°, +90° buttons. The symbol on the map turns as you change it.
  3. Save saves the azimuth on the server, Cancel restores the previous one.

The tool stays on for further points.

Average

  1. Click Average — the Average of points window opens and stays on screen.
  2. Click successive points on the map. The window lists them with their measurement status and shows the largest deviation from the average. Undo removes the last point.
  3. Optionally enter the name of the new point.
  4. Save (from 2 points) saves the average as a new point.

B, L, heights and precisions are averaged. X/Y and height H go into the result only when all selected points have them in the same system. The measurement status is "RTK fixed" when all points have it, otherwise "Average".

The Delete the selected points checkbox deletes the source points from the database after saving, without a further question — this cannot be undone. You can delete only your own points. Other people's points stay, and the plugin reports how many were not deleted.

Offset (parallel line)

  1. Click Offset and then a line.
  2. Enter the Left/right [m] shift and choose the side — relative to the line direction, from the first to the last point. The side you clicked on is selected by default.
  3. Optionally enter the Up/down - height H [m] shift. The field is available only for a line that has H heights.
  4. Save — the shifted copy is saved as a new object; the original stays unchanged.

You can enter one value or both. The copy gets the attributes of the original and a name with a suffix, e.g. "Axis (offset 2.00 m)".

Extend line

  1. Click Extend line and then the line, closer to the end you want to extend.
  2. Enter the Extension [m] and choose the end: from the start of the line (point 1) or from its end.
  3. Save — a new point is added on the extension of the end segment.

By default the selected line itself is changed; its existing points keep their measurement data. The Save as a new object (original unchanged) checkbox saves a copy instead. Another user's line can be extended only this way — the server rejects a change to the original.

Perpendicular segment

  1. Click Perpendicular segment and then the place on the line where the segment should start.
  2. Check the Distance from the start of the line [m] — the distance of the clicked place is filled in; the window also shows the line length.
  3. Enter the Segment length [m] and choose the side (left/right relative to the line direction).
  4. Save — the segment is saved as a new line.

15. Coordinates and measurements on the map

Three measurement tools on the geoGPS toolbar work after signing in and save nothing on the server.

ToolWhat it does
CoordinatesClick a place on the map — the WGS84 geographic coordinates are copied to the clipboard and shown on the map. When the QGIS map uses a projected coordinate system, the hint bar also gives X/Y in that system.
Measure distanceClick successive points — the result (in meters, from 1000 m in kilometers) is updated as you go.
Measure areaClick successive vertices — the result (in m², from 1 ha in hectares) is updated as you go.

Part IV – Data exchange

16. Exporting objects

  1. In the Objects window select objects and click Export.
  2. Choose a format:
FormatContents
GeoJSONFull object data. When the objects have photos, a ZIP with the dane.geojson file and the photos is created automatically.
CSVObjects listed vertex by vertex.
TXT (survey points)Points only.
KMLFor Google Earth and other GIS software.
DXF (CAD)A drawing for CAD software.
  1. Choose where to save the file. The suggested file name is <project>_<date>.

X/Y coordinates are saved in the coordinate system of the active project. Up to 5000 objects can be exported at a time. A ZIP file holds at most 300 photos — export smaller batches when there are more.

A single object can also be exported from its window (chapter 10).

17. Importing objects

  1. In the Objects window click Import.
  2. Choose a format and a file:
    • GeoJSON — a single file or a ZIP with photos,
    • CSV / TXT (survey points) — points; X/Y coordinates in the project's coordinate system, or B/L,
    • KML.
  3. Confirm the import.

Rules:


Part V – Other

18. Information and logging out

Information shows: the plugin version, the user status (signed in or logged out, login, active project), a description of the geoGPS system, data sources and licenses, and links to the Privacy Policy and the Terms of Service.

Log out removes the access token and all geoGPS layers from the QGIS project. The data on the server remains unchanged. Always log out when other people use the computer.

19. Permissions

The plugin applies the same permissions as the mobile app and the web panel:

20. Troubleshooting

SymptomWhat to do
No geoGPS toolbar after installationCheck that the plugin is enabled in "Manage and Install Plugins"; restart QGIS.
The old version still runs after an updateDelete the geogps_api_qgis folder from the QGIS profile, install the ZIP again and restart QGIS.
The icons are greyed outSign in; for the object icons, also choose the active project in "Projects".
The login code does not arriveCheck your e-mail (including spam) and the geoGPS app notifications; use "Resend code".
"Sign in again"The session has expired — click OK and sign in once more.
No access to the dataThe organization has no active subscription, or the current Terms of Service have not been accepted.
The project is loaded but the map is emptyThe project has no objects or has the "blocked" status.
A geoGPS layer cannot be edited with QGIS toolsThe layers are read-only — use Edit object (including the X/Y/H fields) and Change geometry.
The "conflicting changes" window on savingSomeone else changed the object in the meantime — choose whether to overwrite their changes.
The plugin is in the wrong languageChange it in Plugins → geoGPS → Język / Language and restart QGIS.
No layer for an object typeA layer is created only once the type has at least one object.
Photo markers cover the objectsTurn off the Object photos layer in the Layers panel.
A photo has no marker on the mapThe photo has no saved position. A photo added other than in the object window (e.g. in the mobile app) appears after the project is loaded again.
"This point has no symbol to rotate."The object type of this point has no symbol set — only points with a symbol can be rotated.
A tool does not react to clicking an objectAverage and Rotate symbol work only for points, the other tools only for lines.
The object window has no Save buttonIt is another user's object — available for viewing only.
A line cannot be extendedAnother user's line can be extended only as a new object: tick Save as a new object (original unchanged).
"Average saved, but some points could not be deleted"The average is saved. The points were not deleted, most often because they belong to other users.
Import rejectedCheck the format and the limits: 300 objects, 5 MB, ZIP 30 MB.
The import does not calculate heightsNo Internet access (geoid grid from cdn.proj.org), or the project has no geoid model.
Objects in the wrong placeCheck the coordinate system of the active project and the coordinate system of the data in the imported file.

Support: office@geogps.cloud. Documents: Privacy Policy and Terms of Service.

← Volver a la ayuda