GeoDxT

DEVELOPER GUIDES

Quick Links

Template Files API Reference Support Forum
Developer Documentation

Geospatial Data Standards

Comprehensive guidelines for submitting geospatial data to the GeoDxT platform. Ensure compatibility, automation, and reliability across all models.

Last updated: November 2025

Overview

To ensure compatibility, automation, and reliability across all models on the GeoDxT platform, all submitted geospatial data must adhere to the following technical standards. Submissions that do not meet these criteria will be returned for correction.

Interoperability

Seamless model integration

Automation

Plug-and-play workflows

Reliability

Consistent, quality results

Single-Purpose Layers

REQUIRED
Each submitted data layer must represent a single, distinct theme or analysis.

Why This Matters

The core value of GeoDxT is the ability for users to chain simple, specialized models together to create complex workflows. Combining data into a single layer prevents this modularity.

✓ Correct Examples

  • Submit a Flood Risk Map and a Land Price Value Map as separate layers
  • Submit a Land Use Classification Map and a Soil Type Map as separate layers

✗ Incorrect Example

Do not submit a single layer that contains both "flood risk" and "land price" attributes

Coordinate Reference System (CRS)

REQUIRED
All spatial data must use the WGS 84 / Geographic (EPSG:4326) coordinate system.

Why This Matters

This is the global standard for web mapping and interoperability. It prevents misalignment and projection errors when chaining models together.

Validation Requirements

  • Provide the .prj file (for shapefiles)
  • Ensure the CRS is correctly defined in your GeoPackage/GeoJSON
  • The metadata must explicitly state EPSG:4326

Example PROJ.4 string for WGS84:

+proj=longlat +datum=WGS84 +no_defs

Boundary Layers

REQUIRED
All boundary data must be topologically correct and sourced from a reputable, documented source.

Specifications

No Gaps or Overlaps

Adjacent polygons must share coincident boundaries without gaps or unintended overlaps.

Source Attribution

The data source (e.g., "Natural Earth," "OpenStreetMap," "US Census TIGER") must be clearly stated in the accompanying metadata.

Resolution

Data must be appropriate for the analysis scale. Generalized boundaries for national-level views are acceptable, but high-resolution data is required for local analysis.

Grid Layer Specifications

REQUIRED
A standardized grid layer is mandatory for spatial indexing and analysis.

Requirements

Cell Size

Each grid cell must be exactly 2km x 2km at its origin point.

CRS

The grid must be generated in a projected coordinate system that preserves distance for the area of interest (e.g., UTM zones) and then transformed to WGS 84 (EPSG:4326) for submission.

Attributes

Each grid cell must have a unique identifier (GridID).

Grid Example Structure

GridID: "G001", "G002", "G003", ...
Geometry: Polygon (2km x 2km)
CRS: EPSG:4326
Attributes: Confidence, Timestamp, Version

Data Schemas & Attribute Standards

Common Mandatory Attributes (All Layers)

Every vector or grid-based layer submitted to GeoDxT must contain the following core attributes:

Attribute Name Data Type Description Example
LayerID String (UUID) A unique identifier for each feature or grid cell "f47ac10b-58cc..."
Confidence Float (0.0-1.0) Certainty of classification/accuracy 0.87
Version String Model/algorithm version "2.1.0"
Timestamp Date/Time Data generation time (ISO 8601) "2025-10-27T14:30:00Z"

Risk & Hazard Schema

For models that output classified risk levels

RiskLevel - Categorical classification
RiskScore - Numerical score (1-5)
ReturnPeriod - Probability of occurrence

Economic & Valuation Schema

For models that output economic valuations

ValueMean - Mean estimated value
ValueUnit - Unit of value
Currency - Local currency code

Submission Process

Submission Package Structure

Your final submission must be a ZIP file named using the convention: [YourCompany]_[LayerName]_v[Version].zip

Example:

GeoAnalyticsCo_FloodRiskNigeria_v1.2.zip

Contents:

  • Spatial Data File (.gpkg or .shp)
  • Data Dictionary (data_dictionary.csv)
  • Metadata File (metadata.xml)
  • README.txt

Submission Checklist

Single-purpose data layer
WGS 84 (EPSG:4326) coordinate system
2km x 2km grid layer included
GeoPackage or Shapefile format
Complete Data Dictionary
Confidence attribute present
Check our Layer Standards