Connect data to AtlasEvo, work with it in Workspace, and send it where it needs to go
Use this guide when you are connecting a station, vehicle, sensor, file, geospatial service, ocean-data product, API, or downstream system. It explains what AtlasEvo supports directly today, what should come through DataSynch or a gateway, how connectivity choices affect the design, and how to preserve provenance while data moves into and out of Workspace.
Choose the path that matches what you have in front of you
You do not need to begin with a protocol name. Begin with the thing you have and the result you need. AtlasEvo can then separate source, protocol, link, transport, representation, Workspace storage, and delivery so each part can change without forcing you to redesign the whole project.
Use Research onboarding. Describe the platform first, then record the device protocol, the local/network link, and the Atlas-facing access method. Create a Research REST connection only after the station definition is correct and a test observation can be verified.
Connect a station →Identify the real source and exact representation first. GeoJSON can enter Workspace directly. Other products may be connected or normalized through DataSynch, a source API, or the provider’s tooling before usable records are written into a Workspace dataset.
Find the format or standard →Choose whether the recipient needs a one-time export, repeatable DataSynch movement, Research REST access, or a deliberate Crossband share. Keep write-back policy and approved fields explicit when another system can be changed.
Choose a delivery path →See the whole path before configuring one piece
Observation assets and existing data sources reach Atlas through connectivity and interface layers. AtlasEvo then adds spatial context, ingestion, rules, access controls, and Workspace organization before data is visualized, exported, used by applications, or shared with research and education communities.
From a physical station or vehicle to live Workspace data
The operational sequence is straightforward even when the hardware is not: identify the platform, establish its position model, describe the connectivity chain, define observations, test the path, and then make the resulting data available in Workspace. The Research wizard groups these jobs into five onboarding stages.
How Wi-Fi, cellular, radio, tether, satellite, and offline links change the integration
Connectivity changes availability, latency, bandwidth, addressing, power use, and whether the source can be reached continuously. It does not change what the observation means. Design a gateway or store-and-forward path that matches the link, then use an Atlas-facing access method that the current project actually supports.
| Link | Good fit | Integration impact | Typical Atlas pattern |
|---|---|---|---|
| Ethernet | Fixed stations, labs, topside systems, companion computers, tether endpoints. | Usually stable and high bandwidth, but physically bounded by the wired network. | Run the gateway or source API on the reachable network; expose approved HTTPS/REST or WebSocket access, or feed DataSynch. |
| Wi-Fi | Local station networks, field access points, companion computers, short-range high-bandwidth work. | Range, interference, roaming, and changing IP addresses can make direct inbound access unreliable. | Prefer outbound HTTPS/WebSocket from a gateway or use a network path that does not require Atlas to discover a changing local device address. |
| Cellular | Mobile/fixed systems with carrier coverage and Internet access. | Coverage, carrier NAT, data plans, roaming, and intermittent handoff matter. Treat loss of service as expected in some operating areas. | Use outbound HTTPS/REST, WebSocket, or a store-and-forward gateway. Queue observations locally when coverage drops. |
| Radio | Vehicle telemetry, remote sites, private field networks. | Bandwidth and reach depend on the actual modem, frequency, topology, and regulatory environment. | Terminate radio traffic at a gateway/companion system, then bridge approved data into an Atlas-facing IP transport. |
| LoRa / LoRaWAN | Sparse sensor telemetry where small payloads and long range matter more than high throughput. | Payload size and duty-cycle constraints make it a poor fit for images, video, or high-rate raw telemetry. | Send compact observations to a LoRaWAN/network gateway, then forward them to Atlas through an API or DataSynch path. |
| Satellite | Remote platforms outside terrestrial coverage. | Latency, cost, antenna view, power, and service plan can dominate the design. | Send prioritized/compact observations through the satellite provider or gateway; use queued batch delivery when continuous streaming is unnecessary. |
| Acoustic / optical | Underwater links between UUVs, instruments, gateways, or nearby subsea systems. | Underwater bandwidth and reliability can be limited; LTE or ordinary Wi-Fi should not be treated as expected underwater connectivity. | Use acoustic/optical data locally, then surface or tether to a gateway that can deliver observations through an Atlas-facing IP/file path. |
| Physical tether | ROVs, UUV test systems, cabled stations, fiber/Ethernet links to topside. | The data path can be dependable, but the physical tether becomes part of operations and failure planning. | Terminate at topside/companion equipment; from there use Ethernet/IP plus the approved Atlas transport. |
| Delayed sync / file | Expected-offline field systems, removable media, missions that synchronize after recovery. | There is no live path. Timestamp, source identity, units, and provenance become especially important during later reconciliation. | Use file upload, cloud/object storage, SFTP or another DataSynch-supported batch path, then write normalized records into the target Workspace dataset. |
Move from source data to records you can actually work with
Workspace is where normalized project records, geometry, layers, source relationships, and derived results become usable together. Preserve the original source and product identity even when the representation is converted before it reaches Workspace.
- 1. Create or select the Workspace that represents the real project or operating context.
- 2. Add a Source for the real origin: station, provider, agency service, Copernicus product, file collection, API, or partner system.
- 3. Create/select the Dataset that should own the usable records. Keep unrelated sources in separate datasets when provenance or refresh behavior differs.
- 4. Choose the ingestion path. Use direct GeoJSON import when appropriate; otherwise use Research REST, DataSynch, a source API/toolbox, or a verified connector to normalize records.
- 5. Verify time, coordinates, vertical reference, units, observation meaning, source identity, and any standard/profile/version metadata before treating the data as ready.
- 6. Create map layers only when a spatial view helps. The dataset remains the record container; a layer is a presentation/organization surface, not the source of truth.
Choose how approved Atlas data leaves the project
Use the active-dataset export for CSV, GeoJSON, or JSON when a person or external tool needs a point-in-time copy.
Use DataSynch when records need repeatable movement to APIs, files, databases, cloud storage, notifications, or another enabled connector/destination.
Use the one-time-key Research REST connection for an approved station, application, gateway, or AI workload that needs to send observations through the station’s declared scope.
Use Atlasemoji MCP when an approved agent needs scoped access to Atlas capabilities and Workspace context exposed to its credential. The MCP catalog shows the tools and scopes that are currently callable.
Use Crossband when the intent is deliberate community/publication sharing. Research onboarding does not automatically make station geography or observations public.
The AtlasEvo project model
A Workspace is the AtlasEvo project. The important hierarchy is not “a pile of layers”; it is a traceable chain from source data to usable project output.
Source: where data came from — KoboToolbox, CSV, GeoJSON, an API, a drone survey, a sensor feed, government GIS, or manual work.
Dataset: a coherent set of records from a source. A dataset may be spatial, tabular, or mixed.
Layer: the map presentation and organization of spatial records. Not every dataset needs a layer.
Derived result: data created by Atlas analysis, such as validated coordinates, geofence membership, routing results, or prioritized findings.
Destination: where approved results go — remain in AtlasEvo, return to KoboToolbox, move through DataSynch, download as a file, or publish elsewhere.
Navigation without sacrificing the map
The permanent navigation is intentionally compact. Project and data actions live in menus so controls never consume a large part of the map viewport.
Project menu: create a workspace, manage connections and members, inspect the manifest, open this guide, or delete the project.
Data menu: add a source, create a dataset, create a layer, add data, and export the active dataset.
Basemap dropdown: switch the geographic reference surface without changing your AtlasEvo data.
2D / 3D: change camera perspective. Your project data remains the same.
Choose the right basemap for the work
A basemap is reference context, not your project database. Switching providers does not copy, rewrite, or re-import your AtlasEvo datasets.
Mapbox: strong interactive cartography, terrain, buildings, and Mapbox-specific layer controls.
Google: familiar Google geographic context when that provider is useful for the project.
ArcGIS: Esri topographic context for GIS and field-project workflows.
OpenStreetMap: open map context for normal interactive project viewing. Standard OSM tiles are not an offline or bulk-download service.
How to add and access project data
Start by deciding whether the information is a new independent source or additional records for a source you already created. Then create or select the dataset that should hold the records. Spatial records can be placed into a layer; non-spatial records remain part of the dataset and can still be exported or moved through integrations.
- 1. Open Data → Add source and name the real origin, such as “Kobo canal inspections” or “County parcels”.
- 2. Select that source and use Data → New dataset for the specific record set you want to manage.
- 3. Use Data → Add data for files or geometry, or use Connections/DataSynch when another system should supply the records.
- 4. Create a layer when records need a map view. A project can use several layers from the same dataset when different visual organization is useful.
- 5. Use the Sources, datasets & layers panel to move through the project hierarchy. Selecting a dataset makes it the active dataset for export and related actions.
- 6. Use Data → Export active dataset when you need the records outside AtlasEvo as CSV, GeoJSON, or JSON.
Configure Research onboarding without mixing protocol, link, and transport
Use Research onboarding for a physical or virtual platform that produces observations over time. The wizard records what the platform is, where it operates, what observations mean, how data moves locally, how Atlas accesses the gateway/source, and what the project may do with the resulting records.
Choose the real job first: fixed monitoring, UAV observation, surface/subsurface work, mobile field operations, space/orbital data, or an API/feed scenario.
Name the platform, choose its type/spatial domain, and describe fixed or telemetry-supplied position and vertical reference.
Choose source/data profile, device protocol, link, and Atlas-facing transport separately. The current-path summary shows the chain before you save.
Add geo-volumes, geo-tethers, expected connectivity behavior, and deliberate sharing/output choices.
Review the configuration, create the station, then create an approved Research REST connection when a gateway/application/AI workload will submit observations.
Required fields vs. values that can come from telemetry
| Field | Required? | What to enter | Where to get it |
|---|---|---|---|
| Station / platform name | Yes | Use a stable human-readable name for the physical platform, virtual feed, or station. | Use the project naming convention; keep it stable when hardware is replaced. |
| Platform type | Yes | Choose what the thing is operationally: fixed station, UAV, UUV, ROV, USV/vessel, carried sensor, orbital source, virtual/API feed, or another listed type. | Choose by the platform itself, not by the protocol or network it uses. |
| Spatial domain | Yes | Choose subsurface, surface, air/atmosphere, or space. | Use the domain where the platform normally operates. |
| Latitude / longitude | Fixed: usually yes. Moving: optional. | Enter a fixed/starting WGS84 position when appropriate. Moving platforms can provide position with each observation. | Survey/GNSS installation position, autopilot telemetry, or the source API. |
| Vertical value + reference | When vertical position matters | Record altitude/elevation/depth plus the reference such as MSL, ellipsoid, AGL, local surface, seabed, pressure depth, or local datum. | Use the source sensor/autopilot/product documentation. Do not assume all values called “meters” use the same reference. |
| Sensor / observation type | Yes for observation-producing stations | Identify the phenomenon or observation family: position, temperature, salinity, pressure, depth, current, wind, image/media reference, species observation, or a documented project identifier. | Sensor specification, source API variable definition, or data-product documentation. |
| Unit | For measured quantities | Use the real source unit and normalize only when the project deliberately chooses a conversion policy. | Sensor manual, API metadata, CF variable metadata, or product specification. |
| Device protocol | Only when one exists | Select MAVLink, NMEA 0183, NMEA 2000, custom serial, or another actual device protocol. | Device/autopilot/gateway documentation. |
| Network / physical link | Recommended for live equipment | Record Ethernet, Wi-Fi, cellular, radio, LoRa, satellite, acoustic, optical, tether, USB, serial, or the real link in use. | How bytes actually move between the device, companion computer, gateway, topside system, and Internet access point. |
| Atlas transport / access | Yes for programmatic ingestion | Choose the current Atlas transport/catalog option that reaches the source or gateway. This can be REST/HTTPS even when the vehicle itself speaks MAVLink. | Use the Research wizard transport list or a verified DataSynch integration profile. |
Know what Atlas does directly, what comes through a connector, and what should be preserved as source metadata
The list below deliberately distinguishes file/data representation, device protocol, web service, provider ecosystem, and geospatial product specification. “Covered” does not mean every item is a one-click Workspace parser. Use the support path shown for each family so the instructions match the current product.
| Format / standard / ecosystem | What it is | Current Atlas path | What to do |
|---|---|---|---|
| GeoJSON | Geospatial interchange format | Workspace import/export | Import GeoJSON into the selected Workspace/layer path; preserve feature properties and WGS84 longitude/latitude order. Export active datasets as GeoJSON when another GIS/API needs geometry. |
| JSON / CSV | Structured/tabular interchange | DataSynch / dataset records | Map real source fields into dataset records through the current file/connector path. Define coordinate, time, units, IDs, and provenance explicitly; export active datasets as JSON or CSV. |
| NetCDF / CF | Scientific multidimensional data + metadata conventions | Source tooling / connector → Workspace records | Use the provider/tooling to select real variables, dimensions, time/depth ranges, units and CF metadata. Normalize the subset into records/layers Atlas can currently store while preserving source dataset/product and CF variable identity. |
| Zarr | Chunked N-dimensional array storage | Source tooling / connector → Workspace records | Read/subset the real Zarr store with the provider or compatible tooling. Move only the needed values/geometry/metadata into Workspace; keep the original store URL/product identity and selection provenance. |
| Raster / vector GIS | Geospatial data families | Import/service/connector depends on representation | Identify the exact representation first (GeoJSON, tiles, image/raster product, ArcGIS service, etc.). Do not label an unknown input merely “raster” or “vector” when a concrete service/format is available. |
| WMS / WMTS | OGC map-image / tile services | Reference/map-service path | Use them as map/reference services when appropriate. WMS returns georeferenced map images; WMTS returns predefined tiles. Do not treat either as live sensor telemetry or as equivalent to editable feature records. |
| OGC API - Features | Feature-level web API standard | API/connector → Workspace dataset | Discover collections/capabilities, query the real feature records, preserve collection/source identity, then map returned features/properties into the Workspace dataset or reference layer needed by the project. |
| MAVLink | Vehicle/robotics messaging protocol | Device/gateway path → Atlas transport | Record MAVLink as the device protocol. Route it over the real serial/radio/Ethernet/Wi-Fi/TCP/UDP path to a companion/gateway, then send approved observation data from that gateway through the Atlas-facing transport. |
| ArduPilot | Autopilot/software ecosystem | Device/gateway path → Atlas transport | Keep vehicle control in ArduPilot. Use its MAVLink telemetry and companion-computer integrations to obtain the fields your project needs; translate/forward approved observations rather than turning Atlas into the flight controller. |
| ArduSub | Autopilot/software ecosystem | Device/gateway path → Atlas transport | Keep subsea control in ArduSub. Route MAVLink through the companion/topside path, record tether/acoustic/other links separately, and send observation data from the reachable gateway into Atlas. |
| BlueOS | Companion-computer operating environment | Device/gateway path → Atlas transport | Use BlueOS/companion services to access or route vehicle data. Atlas should receive approved observations/context from the gateway; it does not replace BlueOS vehicle-control responsibilities. |
| Copernicus Marine | Ocean-data service and catalogue | Toolbox/API → selected data → Workspace | Use the Copernicus Marine Toolbox/catalogue to choose the real product, dataset, variable, time/depth range and representation. Bring the selected subset into Atlas through the applicable connector/record path and preserve product/dataset identifiers. |
| IHO S-100 | Hydrographic data-model framework | Profile metadata + normalized usable content | Do not stop at “S-100” when the product is known. Record the specific S-1xx product and edition, preserve its feature/portrayal/encoding metadata as applicable, and map usable content into Atlas datasets through the project’s real ingestion path. |
| S-101 ENC | S-100 product specification | Profile metadata + normalized usable content | Preserve S-101 product/edition/source identity. Use an S-101-aware source/toolchain to expose the feature content your project needs, then map that content into Atlas without pretending the original ENC is generic GeoJSON. |
| S-102 | S-100 product specification | Profile metadata + normalized usable content | Preserve S-102 identity/edition and vertical/bathymetric references. Select the bathymetric surface content needed by the project and normalize it through an appropriate coverage/raster/record workflow. |
| S-103 | S-100 product specification | Profile metadata + normalized usable content | Preserve S-103 identity/edition and map only the navigation content actually needed by the project through a compatible source/toolchain. |
| S-104 | S-100 product specification | Profile metadata + normalized usable content | Preserve product/edition, time, reference/datum and water-level units. Normalize selected values into project records/observations only after those references are explicit. |
| S-111 | S-100 product specification | Profile metadata + normalized usable content | Preserve product/edition, time, units and vector meaning. Move selected current data into a Workspace representation suitable for the project while retaining the original S-111 provenance. |
| GGDM | Geospatial data-model/framework lineage | Profile metadata + normalized usable content | Treat GGDM as a geospatial data-model/schema lineage, not a transport. Preserve the supplied profile/version/mapping and transform only the needed feature content into Atlas datasets. |
| DGIF / DGIM | Geospatial data-model/framework lineage | Profile metadata + normalized usable content | Preserve the DGIF/DGIM context and any implementation schema/profile supplied by the source. Map usable features/attributes into Atlas without changing the meaning of the external model. |
| Vendor / standards metadata envelopes | Source-specific extension metadata | Preserve alongside normalized records | Store source-specific identifiers, profile/version, variable/product names, and mapping details in extension metadata so Workspace records stay usable without losing the information needed to trace them back to the real source. |
Official references
Use the official specification/provider documentation below when implementing the external side of an integration. Atlas documentation explains how to fit the result into AtlasEvo; the standards organizations and vendors define their protocols, formats, products, and services.
The standards and mapping guide shows how source identifiers, features, geometry, variables, units, time, depth or altitude, product versions, and provenance fit into AtlasEvo records and observations.
KoboToolbox workflow
Keep collecting in KoboToolbox. AtlasEvo connects those observations to the organization’s actual geography and lets the project decide whether Atlas results should ever be written back.
Values you need from KoboToolbox
| Field | Required? | What to enter | Where to get it |
|---|---|---|---|
| Kobo server URL | Yes | Use https://kf.kobotoolbox.org for Global, https://eu.kobotoolbox.org for EU, or your organization’s Kobo server. | Use the same KoboToolbox server where the account and project are hosted. |
| Kobo API Key | Yes | Paste the exact API Key displayed by KoboToolbox. DataSynch verifies it against Kobo API v2 before the connection is saved. | KoboToolbox → profile icon → Account Settings → Security → API Key → Display. |
| Kobo project | Yes | After Connect succeeds, choose Load Kobo projects and select the project whose submissions Atlas should read. | DataSynch lists projects directly from the authenticated Kobo account. The asset UID is shown for each project and can also be entered manually. |
How to connect KoboToolbox in DataSynch
| Field | Required? | What to enter | Where to get it |
|---|---|---|---|
| Connection name | Yes | A name your Atlas team will recognize, such as “EU Kobo field inspections”. | Choose the name in Atlas. It is not a Kobo credential. |
| Kobo server URL | Yes | Use https://kf.kobotoolbox.org for Global, https://eu.kobotoolbox.org for EU, or your organization’s Kobo server. | Use the same KoboToolbox server where the account and project are hosted. |
| Kobo API Key | Yes | Paste the exact API Key displayed by KoboToolbox. DataSynch verifies it against Kobo API v2 before the connection is saved. | KoboToolbox → profile icon → Account Settings → Security → API Key → Display. |
| Kobo project | Yes | After Connect succeeds, choose Load Kobo projects and select the project whose submissions Atlas should read. | DataSynch lists projects directly from the authenticated Kobo account. The asset UID is shown for each project and can also be entered manually. |
3. Enrich and analyze
Atlas capabilities can operate on project datasets without requiring the source application to become the analysis system.
Store derived results with lineage back to the source records used to create them.
4. Connections and write-back
A connection describes how AtlasEvo can exchange data with another system. A connection does not automatically authorize Atlasemoji to change that system.
Never: keep Atlas results separate from the source system.
Ask before updating: the default for destinations and bidirectional connections. A user approves the update.
Automatic: only for intentionally approved fields and workflows.
AtlasEvo and DataSynch
DataSynch moves and orchestrates data. AtlasEvo stores the project, datasets, layers, provenance, and results. Either side can be the source or destination of a workflow.
Use AtlasEvo Workspace as a DataSynch source when project datasets should feed another workflow.
Use AtlasEvo Workspace as a destination when a connector or workflow should create/update project dataset records.
How to give people or systems access to the work
Choose the sharing method based on what the recipient needs to do. A collaborator who needs to work inside the project is different from someone who only needs a file or a downstream system that needs structured records.
Open Project → Members when another Atlasemoji user needs access to the workspace. Workspace roles control whether the person can only view the project or edit/manage it.
Use Data → Export active dataset. CSV is useful for tabular review, GeoJSON for spatial tools and GIS workflows, and JSON for full structured records/integration work.
Use Project → Connections plus DataSynch when another application needs repeatable data movement instead of a one-time file.
Use Project → Manifest when an advanced user or system needs the project structure, IDs, source/dataset summaries, layer relationships, and connection policy references. The manifest is not a credential store.
Provenance: know where every record came from
Safe refresh, comparison, and write-back depend on provenance. AtlasEvo assets and records should retain their source, dataset, external identity, import timing, and derived lineage.
Source and dataset IDs identify the project container.
External record IDs and versions identify the source-system record.
Import and source-modified timestamps support refresh and change detection.
Derived-from references identify which records and operation produced a result.
A practical first project
- 1Create a workspace for the real project, not for a single file.
- 2Add the first source, for example KoboToolbox field observations.
- 3Create a dataset for those observations.
- 4Add reference geography such as canals, parcels, facilities, roads, or service areas as a separate source/dataset.
- 5Create layers for the spatial views you need.
- 6Switch basemaps to choose the best reference context; use 2D or 3D as needed.
- 7Run Atlas analysis and keep derived results traceable to their inputs.
- 8Review Connections before sending anything back to an external system.
- 9Export or route the approved result to the next destination.