Datasets

Create a dataset and get an upload URL

Register a new dataset and receive a presigned S3 upload URL. Upload your file (GeoJSON, Shapefile ZIP, KML, KMZ, CSV, or GeoPackage) to the returned URL. All geometries must be in WGS84 (EPSG:4326). Processing begins automatically after upload.

post/v1/datasets

Request

  • Base URL: https://api.terranode.co
  • URL: https://api.terranode.co/v1/datasets
  • Auth: API key in header x-api-key

Request body

namestring required

Display name for the dataset.

filenamestring required

Original filename. Format is detected from the extension. Accepted: .zip (shapefile), .geojson, .json, .kml, .kmz, .csv, .gpkg (GeoPackage). Geometries must already be in WGS84 / EPSG:4326; reproject upstream before upload.

descriptionstring
summarystring
slugstring

URL-safe identifier for use in query parameters.

fieldDescriptionsobject

Field-level metadata merged with auto-detected schema.

Response

Dataset created. Upload your file to the returned URL.

datasetIdstring uuid required
uploadUrlstring uri required

Presigned S3 URL. Upload your file here via HTTP PUT.

expiresIninteger required

Seconds until the upload URL expires (900).

Changes

No recorded changes to this operation across all 1 revision of this API.