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 public announcements and product documentation.
• Our unique value proposition is to deliver an intuitive developer experience. Our customers will acquire and analyse your datasets in a few simple steps.
• We are fully compatible with leading organisations and spatial technologies. This will enable our customers to use your datasets with their preferred systems, tools, and libraries.
• We take the time to learn about your product details and we embrace customer success. 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 a resource 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.