Spatial (GeoParquet / GeoJSON / Shapefile)
Read geospatial files for federated analysis, including geometry fields. Files are read in place and can be joined with datasets from other connectors.
When to use
- Geospatial datasets in GeoParquet, GeoJSON, or Shapefile format.
- Analyses that combine location data with attributes from other sources.
How the file is provided
- Object storage (managed service): the file lives in an S3-compatible bucket and is read using the storage credentials you provide.
- Local file path (desktop / self-hosted): the connector reads the file directly from a filesystem path. Not available on the managed service — see Managed vs. self-hosted.
Connection settings
Object-storage mode
Provide the object-storage access credentials, plus the bucket and the object path of the spatial file, e.g. geo/regions.geojson.
Local file path (desktop / self-hosted)
| Field | Required | Description |
|---|---|---|
| File path | Yes | Absolute path to the spatial file in the environment where Datyo runs. |
Capabilities
- Execution model: Federated. Spatial data can be joined with datasets from other connectors.
- Access: Read-only.
- Geometry: Geometry fields are read and available for analysis.
- Environment: Object-storage mode works everywhere; local file path is desktop / self-hosted only.
Troubleshooting
- File not found — verify the bucket and object path (or local file path) and read access.
- Shapefile components — a Shapefile is a set of sibling files; ensure the companion files accompany the main one at the same location.