Biodiversity Report Generation

Platformv05.00 credits/fixed

Responsible:Niccolò Calandri

Biodiversity Report Generation

Overview

The Biodiversity Report Generation feature is an automated system for creating comprehensive PDF reports, based on Google Docs templates with a sophisticated placeholder system. The platform supports four report types:

Site Report — Detailed analysis of a single monitoring site
Multi-site Report — Comparative aggregation of multiple sites
Scenarios Report — Comparison of alternative CLC (land cover) scenarios
Census Report — Faunal census and monitoring data

Each report automatically integrates over 30 placeholder groups covering: satellite data (NDVI, LST, evapotranspiration), land cover (CLC), protected areas, endangered species, air quality, IoT sensors, climate risks, microclimate, urbanisation, and socioeconomic indicators. Map images are rendered in parallel via concurrent Lambda invocations (up to 5 simultaneous).

The system uses the Google Docs API for template compilation and Google Drive for storage. Execution is asynchronous via Lambda, costing 20 credits per generated report (admin bypass available).

Architecture

Component	Detail
Template engine	Google Docs API (placeholder-based)
Storage	Google Drive
Execution	Asynchronous Lambda
Image rendering	Up to 5 concurrent Lambdas
Cost	20 credits per report
Supported types	site, multisite, scenarios, census
Payload version	2.0

API Endpoints

Endpoint	Method	Description	Rate Limit
`/{user_slug}/sites/{site_id}/generate_report`	POST	Single site report	1/10min, 3/h, 6/day
`/{user_slug}/sites/{site_id}/generate_report/scenarios`	POST	CLC scenarios report	1/10min, 3/h, 6/day
`/{user_slug}/sites/{site_id}/generate_report/census`	POST	Census report	No limit

Data Sources

Code	Name	Provider	Type	Coverage	Availability
`3BE_OASRP_99`	3Bee Oasi Report Generation	3Bee / Google Workspace	api	Global	Continuous

References

Google (2025). "Google Docs API v1 Reference". Google Cloud.
3Bee (2025). "Report Placeholder Guidelines — GUIDELINES.md". Internal documentation.

Data Sources & References

Sources

3BE_OASRP_99

Methodology

Automatic generation of biodiversity PDF reports using Google Docs templates. Placeholder system with over 30 groups (NDVI, LST, CLC, protected areas, species, MSA, microclimate, risks, IoT sensors). Parallel image rendering (up to 5 concurrent Lambdas). Types: single site, multi-site, CLC scenarios, census. Storage: Google Drive. Execution: Asynchronous Lambda. Cost: 20 credits/report. Source: lambda-oasi platform.