geoGPS Cloud panel – user manual
The geoGPS Cloud panel is a website for working with the data collected in the geoGPS system: the map, projects, objects, photos and the accounts in your organization. The same data is visible in the geoGPS mobile app and in the geoGPS QGIS plugin.
- Panel address: https://geogps.cloud
This manual covers the Manager and Employee roles and follows the order of work: signing in → projects and object types → objects, photos and the map → organization and account.
Table of contents
Part I – Getting started
Part II – Working with data
Part III – Organization and account
Part IV – Other
Part I – Getting started
1. Requirements
- A computer or tablet with Internet access.
- Google Chrome, Microsoft Edge, Mozilla Firefox or Apple Safari in one of the two latest versions, with JavaScript enabled.
- An account in the geoGPS system. The organization account is created in the mobile app (the "Register" tab); further accounts are added by the Manager.
- An active subscription for the organization. Without it you can sign in, but access to the data (map, objects, projects, object types) is blocked.
The panel is available in Polish, English, German, Spanish and Portuguese. The manuals in the Help section are available in Polish and English.
2. Signing in
Signing in takes two steps.
- Open https://geogps.cloud, enter your login or e-mail and password, then click "Sign in".
- The system 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.
- Enter the code and click "Confirm".
Good to know:
- A wrong code reduces the number of attempts left. When the code expires or you run out of attempts, use "Start over" and sign in again.
- Too many failed attempts block signing in for a while — wait and try again later.
- Forgot your password? Click this link on the sign-in page and enter the account e-mail address — you will receive a message explaining how to set a new password.
- After the Terms of service or the Privacy policy change, the panel asks you to accept them after signing in. You cannot use the account without accepting them.
3. Basic terms
| Term | Meaning |
|---|---|
| Organization | The company that all accounts, projects and data belong to. |
| Project | A set of objects with its own coordinate system and geoid model. |
| Active project | The project you are currently working on. The map, the object list, imports and new objects always refer to the active project. |
| Object | A point, line or area with a name, description, attributes and photos. |
| Object type | An object category (e.g. "Hydrants") that determines how the object looks on the map: symbol, colors, line width, label size. |
| Geometric data | The measurement record of each point of an object: B/L and X/Y coordinates, height, accuracy, measurement status (e.g. RTK fixed). |
| Object attributes | Any key–value pairs added to an object (e.g. number = 123). |
4. Roles and permissions
| Action | Manager | Employee |
|---|---|---|
| Working on your own projects and objects | yes | yes |
| Viewing projects and objects of other people in the organization | yes (view only) | yes (view only) |
| Editing and deleting other people's projects and objects | no | no |
| Taking over all data after deleting an Employee's account | yes | no |
| Creating, editing and deleting object types | yes | no (can use them) |
| Organization WMS/WMTS layers | yes | no (sees them on the map) |
| User accounts | yes | no |
| Organization, subscription, deleting the organization | yes | no |
You can edit and delete only your own projects and objects. Both the Manager and the Employee open other people's data in "View" mode, with information about who the author is.
5. Typical workflow
The order in which the panel is usually used:
- Sign in (chapter 2).
- Create a project or choose an existing one and set it as active (chapter 6).
- Manager: prepare the object types the team will use to describe the data (chapter 7).
- Collect data — in the field with the mobile app, and in the office by adding objects from coordinates, from the map or by importing a file (chapters 8 and 10).
- Complete the objects: attributes, descriptions, photos (chapters 8 and 9).
- Check the result on the map and correct the geometry where needed (chapter 10).
- Export the data for further work (GeoJSON, CSV, TXT, KML, DXF, IFC), prepare a PDF report or download the whole project as a ZIP — as a copy or to move it to another account (chapters 6 and 8).
Part II – Working with data
6. Projects
The Projects section shows the list of the organization's projects with these columns: name, status, coordinate system, geoid model, update date, author, number of objects and number of photos. The list can be searched, and sorted by clicking a column header.
Choosing the active project
Click a project row — it becomes active and is highlighted. From now on the map and the object list show this project.
New project
- Click the + icon in the list header (the last of four icons: trash, report, import, add).
- Enter a name, choose a coordinate system (type a country or a name and pick from the suggestions) and a geoid model matching the system. The description is optional.
- Click Create project.
The coordinate system determines in which system the panel shows and accepts X/Y coordinates. The geoid model is used to convert heights.
Editing and deleting
The pencil icon next to a project opens editing: name, status (active / blocked), coordinate system, geoid model, description.
Projects can be deleted in two ways:
- on the list: select projects with the checkboxes on the left (the checkbox in the header selects all visible ones) and click the trash icon at the top, the first icon above the list,
- in project editing: the Delete permanently button.
Deleting removes the project together with all its objects and photos — this cannot be undone. You can select and delete only your own projects.
A project with the "blocked" status is excluded from work: its objects and photos cannot be viewed or changed until the status is set back to "active".
PDF report of projects
Select projects with the checkboxes and click the PDF report of selected projects icon (next to the trash). Choose the report columns (name, status, coordinate system, geoid model, update date, author, number of objects, number of photos) and click Generate PDF.
Exporting a whole project (ZIP)
In project editing, in the Project export part, click Export project (ZIP). The downloaded file contains:
project.json— all project data from the database: the project, the object types used with their style, all objects with geometric data and attributes, photo descriptions,- the
photos/folder — the photos as ordinary image files.
The file serves as a copy of the project or as a way to move it to another account. It contains the data and photos in unencrypted form, so keep it in a safe place.
Importing a project (ZIP)
- On the project list, click the down arrow icon — between the report icon and the + icon.
- Choose the ZIP file created by a project export.
- After the import the panel opens the new project and shows the number of imported objects and photos.
An import always creates a new project on your account — it does not overwrite existing ones. You become the author of the imported data. Missing object types are created automatically. The import is rejected if adding the photos would exceed the organization's photo limit for its package.
7. Object types
The Object type section contains the object categories. A type describes how an object looks on the map — it looks the same in the panel, the mobile app and QGIS.
Every organization has three default types: for points, lines and areas.
Creating and editing (Manager only):
- Name and Description.
- Geometry type: Point, Line or Area. It cannot be changed after creation.
- Style:
- point — "With symbol" (choice of a symbol and its size in meters) or "Without symbol",
- line — color, width, style (solid, dashed, dotted), transparency,
- area — additionally the fill color and fill transparency,
- label font size.
Deleting (Manager only): select types with the checkboxes on the left and click the trash icon at the top, next to +; a single type can also be deleted in its editing form. A type cannot be deleted while it is assigned to any object — the panel then reports how many types were not deleted.
8. Objects
The Objects section shows the objects of the active project.
List and filters
- Filters: Geometry type, object type, Name (searches the name, description and GUID).
- Next to each object: the edit icon (or the view icon for someone else's object).
- The checkboxes on the left select objects for export, a report or deletion. The checkbox in the header selects all objects matching the filter.
New object from coordinates
- Click New object.
- Choose the object type, enter a name and a description.
- Enter the coordinates in the coordinate system of the active project:
- point — X, Y and optionally the height H,
- line or area — a list of points ("Add point" adds another row).
- Add attributes ("Add attribute") if needed and click Add object.
Latitude and longitude (B/L, WGS84) are calculated automatically after saving.
Editing an object
The edit form contains:
- Object type, Name, Description,
- Geometric data — a table with the measurements of each point (read-only),
- X, Y coordinates and H height of the point or of each vertex of a line or area (your own objects),
- Object attributes — key–value pairs; yes/no values and numbers are stored as boolean and numeric types,
- Photos (see chapter 9),
- the GUID, creation date and last update date,
- the Show on map button,
- the Print the full PDF report of this object icon.
Changing coordinates in the form
The geometry of your own object can be changed in the form or on the map (chapter 10).
- Enter new X, Y or H values in the project's coordinate system. An empty H means no height.
- After you save the object, the B/L coordinates and the ellipsoidal height h of the changed points are recalculated.
- The trash icon next to a vertex of a line or area marks it for removal, and clicking again restores the point. The point disappears only when you save the object. A line must keep at least 2 points and an area 3.
Exporting objects
Select objects, click Export and choose a format:
| Format | Contents |
|---|---|
| GeoJSON | Full object data. If the objects have photos, a ZIP with the GeoJSON file and the photos is created. Recommended format. |
| CSV | All objects listed vertex by vertex. |
| TXT (survey points) | Points only, in the NO X Y H layout. |
| KML | For Google Earth and QGIS. |
| DXF (CAD) | A drawing for CAD software. |
| IFC4 (BIM, georeferenced) | A file for BIM software. Objects are saved with the project's coordinate and height systems and with the measurement data in the geoGPS_Pomiar property set. |
X/Y coordinates are saved in the coordinate system of the active project.
Limits of one export when selecting all objects matching the filter: 5000 objects. A GeoJSON ZIP file holds at most 300 photos — any others will be missing from it, so export smaller batches when there are more. Export to GML is available in the mobile app.
PDF report of objects
- Select objects and click the PDF report of selected objects icon.
- Choose the contents: name, object and geometry type, description, dates, geometry (vertex coordinates), attributes, photos (up to 6 per object).
- Click Generate PDF. The report is A4 portrait. Do not close the page while it is being generated.
When selecting all objects matching the filter, the report is split into files of 100 objects.
Importing objects
Click Import, choose a format and select a file:
- GeoJSON — a single file or a ZIP with photos,
- CSV, TXT (survey points: NO X Y H),
- KML.
The objects are added to the active project, to the default object type for their geometry. Limits of a single import: 300 objects, file up to 5 MB (ZIP up to 30 MB). Do not close the page while the import is running.
Deleting
Objects are deleted with the Delete selected trash icon at the top right of the list: select objects with the checkboxes and click the icon. Objects are removed together with their photos — this cannot be undone. A single object can also be deleted with the "Delete" button in its editing form.
9. Photos
Photos are added in object editing, in the Photos part.
- + Add photo — choose a JPEG, PNG or WEBP file. The browser downsizes the photo before sending it (to about 300 KB), so large camera photos can be added as well.
- Clicking a thumbnail opens a preview with these buttons: download, rotate 90°, delete, previous / next, plus a description field and the Save description button.
- Photo changes are saved immediately, independently of the "Save changes" button in the object form.
The total number of photos in the organization is limited by the subscription package (chapter 13).
10. Map
The Map section in the menu shows the objects of the active project. If no project is active, first choose one in the "Projects" section.
Map tools
| Tool | What it does |
|---|---|
| Layers | Turning layers on and off: My objects, Object photos, Parcels from GUGiK, GML files, WMS/WMTS layers; transparency slider. "Save" remembers the setting. |
| Parcel search [PL] | Searching for a cadastral parcel (see below). |
| New point / New line / New area | Adding an object by picking it on the map. |
| Measure distance / Measure area | Measuring without saving an object. |
| Show all objects of the active project | Fits the view to the whole project. |
| Average | Pick points one after another — the panel shows the maximum deviation from the average. The average of B, L, h, X, Y, H is saved as a new point; the source points stay unless you tick "Delete the selected points". |
| Offset (parallel line) | Pick a line and enter an offset in meters to the left/right (relative to the line direction) and/or up/down along the H height. The offset copy is saved as a new object. |
| Extend line | Pick a line closer to the end you want to extend and enter the length in meters. A new point is added on the extension of the end segment; you can save the result as a new object and leave the original unchanged. |
| Perpendicular segment | Pick a line, enter the distance from its start, the side (left/right) and the segment length. The segment is saved as a new object. |
| Rotate symbol | Pick a point with a symbol and set its azimuth 0–360° (0° = north, clockwise). |
| Saves the current map view to a PDF file. |
The Surfaces and Volume tools are available only in the mobile app.
Layers from GML files
A GML file (e.g. from EGiB, GESUT, BDOT500 or BDOT10k, or a WFS response) can be shown on the map as a separate layer — for viewing only, without adding objects to the project.
- Open Layers and, in the GML files section, click Load GML file, then select a
.gmlor.xmlfile. - The panel shows how many objects were loaded and zooms to the layer extent.
- The checkbox next to the layer switches it on and off, and Remove removes it from the map after confirmation.
- Clicking an object of the layer shows its attributes from the file.
Reading the file. The panel reads GML 2.x, 3.x and 3.2 in the encoding given in the file header (UTF-8, ISO-8859-2, Windows-1250).
- The coordinate system is taken from the file, with the Polish axis order (X — north) for PL-2000 and PL-1992. When the file cannot be matched to a known system — e.g. it uses a compound system with heights (PL-2000 + PL-EVRF2007-NH) — the panel recognizes PL-2000 or PL-1992 from the coordinate values, provided the objects fall within Poland.
- Heights (the third coordinate) are skipped.
- Archival versions of objects (with
koniecWersjaObiektorkoniecObiektfilled in) are skipped, so a file with a change history shows only the current state.
Appearance. Objects of the EGiB, GESUT and BDOT500 databases are drawn with the base map symbols, depending on the map scale (1:500, 1:1000, 1:2000, 1:5000). Labels take their text from the label's tekst attribute or, when it is missing, from the object attributes. Other objects use a single layer color.
EGiB boundary points. At the 1:500 and 1:1000 scales the symbol shape depends on the stabilization type (STB), and its color on the acquisition method (SPD) and on meeting the accuracy standards (ISD):
- circle – stabilized point (STB = 3, 4, 5 or 6), dot – not stabilized or no stabilization information (STB = 1 or 2),
- blue – established point that meets the standards (SPD = 1 and ISD = 1), red – in all other cases, including when SPD or ISD is missing from the file.
| STB | SPD | ISD | Result |
|---|---|---|---|
| 3 | 1 | 1 | blue circle |
| 3 | 2 | 1 | red circle |
| 4 | 1 | 2 | red circle |
| 6 | 1 | 1 | blue circle |
| 2 | 1 | 1 | blue dot |
| 2 | missing | missing | red dot |
| 1 | 2 | 2 | red dot |
| missing | – | – | "unmarked" |
At the 1:2000 and 1:5000 scales boundary points are not drawn.
Limitations:
- The file is not sent to the server — it is read in the browser. Only requests for symbol styles and for the definition of a coordinate system other than PL-2000/PL-1992 (the EPSG number only) reach the server.
- The layer is kept in this browser only, until you log out — logging out removes it. It is not visible to other users, on another computer or in the mobile app.
- Objects of the layer cannot be edited or saved to a project.
Adding an object from the map
- Click New point, New line or New area.
- Point: click a place on the map. Line and area: click successive vertices (a line needs at least 2, an area at least 3) and finish with the Finish button or a double click. The Esc key or "Cancel" stops drawing.
- If you click close to another object, the question "Snap to object?" appears — choose Object (the point lands exactly on the existing object) or Coordinates (the clicked place is kept).
- In the "New object" window choose the object type, enter a name, optionally a description and attributes, and click Save object.
Working with an object on the map
Clicking an object shows its information and the available actions:
- Change object geometry location — point: drag the marker to a new place and release it. Line or area: drag an orange vertex, or the "+" sign on a segment to add a new point. The correction is saved automatically when you release it.
- Calculate length (line) / Calculate area (area) — computes the value and saves it in the object's attributes:
length_morarea_m2. The geometry does not change. - Edit object — opens the object form (chapter 8).
- Delete object — permanently deletes the object together with its photos.
When several objects are in the same place, the panel shows the "Select object" list.
Parcel search – Polish language version only
The parcel search and the parcel layer are not available with a free trial subscription.
- Choose in turn the voivodeship, county, commune and precinct, enter the parcel number (e.g.
700/3) and click Search parcel. Alternatively, use Pick on the map and click a point inside the parcel. - The parcel is drawn on the map. Options:
- removing the previously found parcel on a new search,
- Save to the current project — the parcel is saved as an object of the Area type, and its TERYT number becomes the name.
Parcel data comes from GUGiK services (the Polish Head Office of Geodesy and Cartography) and is for information only — it does not replace the work of a licensed surveyor.
11. Organization WMS/WMTS layers
The Organization WMS/WMTS layers section (Manager only) lets you add your own base maps. The added layers are visible to all users of the organization — on the map in the panel and in the mobile app.
- Click to add a layer and choose the type: WMS or WMTS.
- Enter the Service URL and click Fetch layers from server — the panel reads the list of layers; untick the ones you do not want.
- If needed, fill in: the layer name, format, transparent background, transparency, minimum and maximum zoom, whether the layer should be Visible by default, and the Display order (a lower value = higher on the list).
- Save.
Deleting: select layers with the checkboxes on the left and click the trash icon at the top, next to +. A deleted layer disappears for all users of the organization.
Part III – Organization and account
12. User accounts
The User accounts section (Manager only).
Adding an Employee
- Click to add an account ("New account in the organization").
- Enter the first name, last name, login, e-mail address and phone number.
- Tick the confirmation that the person is authorized to use the system on behalf of the organization.
- Save. The account gets the Employee role, and a single-use link for setting the password, valid for 24 hours, is sent to the given e-mail address.
The number of accounts is limited by the subscription package.
Editing, blocking, deleting
- Deactivate / Activate — temporarily blocks or restores the Employee's ability to sign in.
- Delete — permanently deletes the account. The Manager takes over all of the Employee's data (projects, objects, photos, object types) and can continue to edit and delete it.
- Changing an Employee's e-mail address requires entering your current password.
- The role cannot be changed after the account is created. You also cannot deactivate or delete your own account.
- The Terms column shows whether the account has accepted the current Terms of service.
13. Organization and subscription
The Organization section (Manager only) shows the organization's details, the date until which the accounts have access, the subscription end date, and the number of used and free accounts.
Subscription
After registration, a new organization gets a free 7-day subscription (without the Parcels module). After that period the Manager chooses a suitable package or deletes the organization's data.
The subscription is bought and renewed:
- in the mobile app — Subscriptions screen, payment in Google Play,
- in the web panel — the Orders section ("Change package"): choose a package and a period (1, 3 or 12 months) and you will receive a pro forma invoice; the package starts once the payment is booked, and the VAT invoice is issued in KSeF.
The subscription determines access to the data: without an active subscription the map, objects, projects and object types are blocked.
After the subscription expires, the organization's data is kept for another 30 days — during that time it is enough to renew the subscription to regain access. After 30 days the data is permanently deleted.
| Package | Number of accounts | Photo limit in the organization |
|---|---|---|
| A | 1 | 3000 |
| B | 2 | 6000 |
| C | 3 | 9000 |
| Individual | agreed individually | agreed individually |
Deleting the organization
The Delete organization part permanently removes all accounts, projects, objects, object types, layers and photos. It requires your current password and cannot be undone.
Deleting the organization does not cancel the subscription in Google Play — cancel it yourself in Google Play, otherwise you will continue to be charged.
14. My account
The My account section:
- Edit data — first name, last name, e-mail, phone. Changing the e-mail address requires your current password; for other changes leave the password field empty.
- Change login password — enter the current password and the new one twice. The new password must have more than 10 characters and contain an uppercase letter, a digit and a special character.
Part IV – Other
15. Data security
- The connection to the panel is encrypted (HTTPS).
- Signing in requires a password and a one-time code.
- Photo files, users' first and last names and backups are stored on the server in encrypted form. Other data in the database is protected by access control and the encrypted connection.
- Every user sees only the data of their own organization, within the scope of their role.
- Exported files (objects, project ZIP) are unencrypted — you are responsible for storing them.
Details: Privacy policy and Terms of service.
16. Troubleshooting
| Symptom | What to do |
|---|---|
| The login code does not arrive | Check the spam folder and the geoGPS app notifications on your phone. The code is valid for 3 minutes — sign in again to get a new one. |
| "No active subscription", data blocked | The Manager buys or renews the subscription in the mobile app or in the panel (Orders section). |
| The map or the object list is empty | Choose the active project in the "Projects" section and check the list filters. |
| I cannot edit a project or an object | It is another user's data — it is available for viewing only. |
| I cannot add or change an object type | Object types are managed by the Manager. |
| An object type cannot be deleted | The type is assigned to objects — change their type or delete them first. |
| I cannot add a photo | Check the package photo limit and the subscription status. |
| A file import loaded nothing | Check the format and the limits (300 objects, 5 MB, ZIP 30 MB); for a project import the file must come from a project export. |
| Form session error | Refresh the page and repeat the operation. |
| "The filter matches … objects, the export limit is 5000" | Narrow the filter (object type or search) and export the data in batches. |
| There is no parcel search | It is available only in the Polish language version and not with a free trial subscription. |
| I cannot find Surfaces or Volume | These functions are available only in the mobile app. |
| "Could not load the GML file" | The message gives the cause: an invalid file, no geometry, an unknown coordinate system or only archival versions of objects. |
| A GML layer has disappeared | GML layers are kept only in this browser and until you log out — load the file again. |
The Help section in the menu contains the manuals for the panel, the mobile app and the QGIS plugin, as well as documents: the Terms, the Privacy Policy, the data processing agreement and the security specification.
For other matters, write to office@geogps.cloud.