CanopySat Forest Intelligence API

Intégrez l'intelligence forestière dans vos applications — analyses satellite en temps réel, scores d'intégrité forestière, détection de déforestation et hauteur de canopée NASA GEDI pour n'importe quelle zone sur Terre.

Plans & Tarifs

Free
0€ / mois
  • 10 appels / mois
  • Tous les endpoints
  • 6 satellites
  • NASA GEDI LiDAR
  • Support communauté
Commencer — Gratuit
Enterprise
299€ / mois
  • Illimité
  • Tous les endpoints
  • Déploiement dédié
  • Support prioritaire
  • SLA 99.9%
Nous contacter

Authentification

Toutes les requêtes API nécessitent un Bearer token dans le header Authorization :

Authorization: Bearer YOUR_API_KEY

Créez votre clé API gratuite via l'endpoint ci-dessous ou contactez-nous.

Endpoints

POST /api/v1/analyze
Analyser une zone forestière avec 6 satellites réels — ESA Sentinel-2/1, NASA Landsat 8/9, NASA Landsat 4/5, NASA FIRMS et NASA GEDI LiDAR

Paramètres :

latfloatrequis
Latitude (-90 à 90)
lngfloatrequis
Longitude (-180 à 180)
sizeintoptionnel
Taille de la zone en km (défaut: 10)
langstringoptionnel
Langue de réponse : "en" ou "fr" (défaut: "en")

Exemple :

curl -X POST https://www.canopysat.org/api/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat": -3.4653, "lng": -62.2159, "size": 10}'

Réponse :

{
  "success": true,
  "score": 87,
  "ndvi_current": 0.823,
  "forest_cover": 98.5,
  "canopy_height": 24.3,
  "canopy_height_rh50": 12.1,
  "gedi_cover": 99.2,
  "canopy_height_source": "NASA GEDI LiDAR",
  "ai_forest_type": "Dense Tropical Forest",
  "deforestation_alert": "STABLE",
  "active_fires": 0,
  "sentinel1_vv": -8.234,
  "trend": "improving",
  "satellites_used": ["ESA Sentinel-2", "NASA FIRMS", "ESA Sentinel-1", "NASA Landsat 8/9", "NASA Landsat 4/5", "NASA GEDI LiDAR"]
}
POST /api/v1/key/create
Créer une nouvelle clé API gratuite
namestringrequis
Votre nom
emailstringrequis
Votre email
use_casestringoptionnel
Votre cas d'usage
curl -X POST https://www.canopysat.org/api/v1/key/create \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "john@example.com"}'
GET /api/v1/key/status
Vérifier votre utilisation et les appels restants
curl https://www.canopysat.org/api/v1/key/status \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/compare
Comparer deux périodes temporelles pour détecter les changements forestiers
lat, lng, sizefloatrequis
date1_start, date1_endstringrequis
Période 1 (format YYYY-MM-DD)
date2_start, date2_endstringrequis
Période 2 (format YYYY-MM-DD)

Satellites Utilisés

ESA Sentinel-2
10m · NDVI, NDRE, NBR, couverture
ESA Sentinel-1
10m · Radar VV, classification
NASA Landsat 8/9
30m · Tendance 10 ans
NASA Landsat 4/5
30m · Tendance 40 ans depuis 1984
NASA FIRMS
375m · Feux actifs VIIRS/MODIS
NASA GEDI (ISS)
25m→10m fusion · Hauteur canopée LiDAR

Exemples de Code

Installez le SDK officiel :

pip install canopysat

📦 pypi.org/project/canopysat · github.com/SautiRay/canopysat

Python:

from canopysat import Forest

# Simple — no API key needed (10 free analyses/month)
result = Forest.analyze(lat=-3.4653, lng=-62.2159, size=10)
print(result.score)           # 80
print(result.canopy_height)   # 13.2m (NASA GEDI LiDAR)
print(result.summary())

# With API key
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://www.canopysat.org/api/v1"

response = requests.post(f"{BASE_URL}/analyze",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"lat": -3.4653, "lng": -62.2159, "size": 10}
)
data = response.json()
print(f"Forest Score: {data['score']}/100")
print(f"Canopy Height: {data['canopy_height']}m (NASA GEDI)")
print(f"Deforestation Alert: {data['deforestation_alert']}")

JavaScript:

const response = await fetch('https://www.canopysat.org/api/v1/analyze', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({lat: -3.4653, lng: -62.2159, size: 10})
});
const data = await response.json();
console.log(`Forest Score: ${data.score}/100`);
console.log(`Canopy Height: ${data.canopy_height}m (NASA GEDI)`);

📞 Obtenir une Clé API

Contactez-nous pour obtenir votre clé API gratuite ou pour upgrader vers un plan supérieur.

✉️ Obtenir une clé API