Version: V1.0.0
Copyright: GeoTwin
Last updated: 2026-03-16
All ownership and related intellectual property rights in this software belong exclusively to GeoTwin.
Users must obtain the right to use the software through lawful means and use it in compliance with applicable agreements.
GeoTwin shall not be liable for any infringement or unlawful conduct that occurs during use of the software for reasons not attributable to GeoTwin; the user bears sole legal responsibility.
Without GeoTwin’s prior written consent or authorization, no party may adapt, translate, annotate, compile, sublicense, re-authorize, or otherwise modify or create derivative works of this software.
Updates or changes to this manual may be made without notice; GeoTwin assumes no obligation in this regard.
“GeoTwin”, “GEOTWIN”, and related marks are registered trademarks of GeoTwin and are protected by law. Without GeoTwin’s prior written consent or authorization, no one may infringe the exclusive rights attached to these trademarks; infringement will be pursued.
Enhancements:
New capabilities:
Other changes:
| Version | Date | Highlights |
|---|---|---|
| V1.0.0 | 2026-03-16 | First general release: survey creation, form design, data management, map linkage, and related core features |
| V0.9.x | 2025-12-09 | Internal testing: basic survey management and form design |
| Component | Recommendation |
|---|---|
| CPU | Intel Core i5 or better, or Apple M1 or better |
| Memory | 16 GB or more |
| Graphics | Discrete or integrated GPU with WebGL 2.0 |
| Storage | SSD 256 GB or larger |
| Network | Broadband 10 Mbps or higher |
| Browser | Latest Google Chrome (recommended) |
GeoTwin Survey is a web application; no local client install is required:
GeoTwin Survey is an online survey and data collection platform for geospatial and digital-twin workflows. It offers visual form design, geospatial data capture, and 3D map–linked presentation. Typical use cases include urban management, public health surveys, property censuses, and field verification wherever questionnaire data must be tied to location.
| Data type | Supported formats | Notes |
|---|---|---|
| Form field configuration | JSON | Internal designer format; import/export supported |
| Image upload | JPG, JPEG, PNG, GIF, WebP | For Upload fields |
| File upload | PDF, DOC, DOCX, XLS, XLSX, etc. | Generic file fields |
| Coordinates | Long/lat (WGS84, EPSG:2326, etc.) | Map fields; Hong Kong 1980 (EPSG:2326) supported |
| GIS feature layers | Built-in layer services | Direct linkage in Feature Layer mode |
| Output | Supported formats | Notes |
|---|---|---|
| Submission payload | JSON | Storage and API format |
| Data export | TBD | Export spec to be confirmed |
| Form configuration export | JSON | Designer import/export |
| Map visualization | 3D scene (WebGL) | Rendered via @gt-viewer/sdk; not exported as a standalone file |
The top bar is global across pages:
| Menu | Primary function | Description |
|---|---|---|
| My Surveys | Survey home | View, create, and manage all surveys |
| Scene | Scene management | 3D GIS scenes and layer configuration |
| HomePage | Home configuration | Platform landing content |
| Group | Group management | Survey grouping and permissions |
| Content | Content management | Rich text and announcements |
| Organization | Org management | Users, roles, permissions |
| Resource | Resource management | Platform file assets |
Top-right: notifications (bell), language (Aa), app launcher grid, avatar and account menu.
Figure 5-1-1: GeoTwin Survey survey list (grid view)
On My Surveys:
Each card: edit (pencil), details (document icon), more (three dots).
Three-column layout:
| Category | Components |
|---|---|
| Basic | Input, Textarea, Password, InputNumber, Radio, Checkbox, Select, Switch, Rate, Time, TimeRange, Slider, Date, DateRange, ColorPicker, Cascader, Upload, Transfer, Tree, TreeSelect, Editor, Signature, Map |
| Subform | Subform, Group, TableForm |
| Auxiliary | TBD |
Toolbar: device preview (desktop/tablet/phone), undo/redo, save, preview, clear.
Figure 5-1-3: Design page — component palette, canvas, property panel
Split layout:
Top — 3D map: @gt-viewer/sdk scene showing geographic distribution; zoom, rotate, layer toggle
Bottom — Table: Attribute rows aligned with form fields (e.g. Name, Health Status, Community name, Community Location, Submit time, Action)
Figure 5-1-4: Data page — 3D map (Hong Kong) linked to the attribute table
On My Surveys, click New Survey (top left).
Choose a creation mode:
Click Create under the chosen mode.
Enter the survey name and basic info, then open the form designer.
Figure 5-2-1: New survey — Blank Survey or Feature Layer
Open the survey detail page and select the Design tab.
Drag components from the left palette onto the canvas.
Select a widget and configure it in the right panel:
For location capture, add a Map component; respondents pick a point on the map.
For signatures, add Signature.
Click Save to persist; Preview to test the respondent experience.
When ready, share the public link with respondents.
Figure 5-2-2: Designing a “public health survey” with Name, Health Status, Community name, Community Location
After design, copy the public Share URL from the list or detail page.
Send the link; respondents open it without logging in.
On submit, data syncs to the backend.
Open the Overview tab for counts and field-level summaries.
Open Data for map visualization and the attribute table; use Action per row to view, edit, or delete.
From the list, open a survey card to enter details.
Overview is the default tab.
Left: survey navigation; right: 3D scene summary.
If you see a message such as “Auto login succeeded, please refresh,” refresh the page to load data.
Figure 5-2-4: Overview — left nav, map scene (loading)
Issue 1: Survey detail stays loading
Issue 2: Drag-and-drop in the designer does nothing
Issue 3: Share link errors
Issue 4: 3D map missing on Data
chrome://gpu/ in Chrome); check @gt-viewer/sdk dependencies; try resizing or switching tabs.Issue 5: Partial text not updating after language change
| Term | Definition |
|---|---|
| Survey | A structured data collection form made of fields; may include geographic context |
| Blank Survey | A survey designed from scratch without an underlying GIS layer |
| Feature Layer Survey | A survey created from a GIS feature layer; form fields map to layer attributes and tie to features |
| Form Designer | Visual drag-and-drop builder supporting 20+ field types |
| Digital Twin | A digital mirror of the physical world; 3D GIS reflects real-world state and data |
| GIS | System for capturing, storing, analyzing, and displaying geographic information |
| Feature Layer | Vector layer (points, lines, polygons) with geometry and attributes |
| WebGL | Web standard graphics API (based on OpenGL ES) for 2D/3D in the browser |
| CRS (Coordinate reference system) | Framework defining coordinate meaning; WGS84 (EPSG:4326) and Hong Kong 1980 (EPSG:2326) supported |
| Tenant | Isolated organizational unit in multi-tenant mode |
| Overview | Summary tab with statistics and map visualization |
| Grid view / List view | Two layouts for the survey list: cards vs. rows |
For problems, see Section 5.3 first, or contact your system administrator.
The following were not finalized when this manual was written; validate with product/engineering before publishing:
| # | Item | Section |
|---|---|---|
| 1 | Legal entity name, official website | Cover, Section 7 |
| 2 | Trademark wording and registration status | Trademark statement |
| 3 | Shipping version (align with package.json) | Cover, Section 1 |
| 4 | Export formats (CSV, Excel, GeoJSON, etc.) | Section 4.2 |
| 5 | Overview chart behavior (screenshot taken while data was loading) | Section 5.2.4 |
| 6 | Full Share page UI | Section 5.2.3 |
| 7 | Support contacts (email, phone, site) | Section 7 |
| 8 | Offline deployment and requirements | Section 2 |
| 9 | Detailed Feature Layer workflow | Section 5.2.1 |
| 10 | End-to-end data export procedure | Section 5.2 |