This document describes the advantages and technical specification for integrating nature datasets with the Cecil platform.
Advantages of integrating with Cecil
- Cecil provides an additional distribution channel for your organisation. Our customers will discover your datasets in our product documentation.
- Cecil’s unique value proposition is to deliver an intuitive developer experience. Our customers will acquire and analyse your datasets in a few simple steps.
- We leverage a modern database with native support for spatial data, enterprise-grade security, and OLAP architecture optimised for analysis. This will enable our customers to develop scalable workflows with your datasets.
- We learn about your product details and we provide exceptional customer service. This will reduce your efforts in customer onboarding and support.
- We offer a pricing model that doesn’t have minimum usage requirements and we enable our customers to scale in a cost effective manner.
Process overview
There are 3 high-level steps across the end-to-end integration.
- Data request: Cecil initiates the process by submitting an API request to your organisation.
- Webhook notifications: Your organisation provides status updates on data requests.
- Data delivery: Your organisation finalises the process by delivering files via S3 or HTTP.
Data request
Cecil requires an API endpoint from your organisation that allows submitting a data request, which represents a dataset acquisition for an area of interest (AOI).
Minimum requirements
- Request body containing your dataset ID, a GeoJSON geometry object in EPSG:4326 delimiting the AOI boundary, and coordinates type in Polygon or MultiPolygon.
- Response body containing an entity ID representing Cecil’s data request in your system, or parseable data structures containing descriptive error messages for potential issues.
Recommended
- Request body with optional parameters that may be available in your product. For example, the ability to select specific variables, temporal coverage, and subscription settings.
- Response body with additional information that may be relevant to Cecil and customers.