Agrovisio Data API

Vegetacijos indeksai, radaro įvykiai, žalos vertinimai, rizikos balai, BŽŪP atitiktis ir parametriniai indeksai bet kuriam ES sklypui - per vieną HTTP API, su nemokama testine aplinka (sandbox), kuri atsako jau pirmu kvietimu.

Pradėti per 15 minučių Interaktyvus žinynas

Kam tai skirta

Draudikams ir insurtech

Žalos vertinimas prieš / po įvykio su pagrįstu pasikliautinuoju intervalu, SAR pokyčių įvykiai kaip beta signalai (aptikimo slenksčiai dar kalibruojami), deterministiniai PDF sertifikatai ir parametrinių indeksų apibrėžimai su backtest.

Bankams ir kreditoriams

Paaiškinami 0-100 rizikos balai su šešiais komponentais, portfelio suvestinės, derliaus prognozės su intervalais ir BŽŪP išmokų skaičiavimas skolininko pajamoms.

Agroverslui ir agritech

NDVI / NDWI / EVI serijos su penkių sezonų baseline, orų istorija nuo 1981 m., terminis vandens stresas ir radaro įvykiai bet kuriam aptarnaujamų šalių sklypui.

Sukurta integracijai

OpenAPI 3.1, kuriame aprašytas kiekvienas klaidos atsakymas, vienas klaidų formatas su 34 stabiliais tipais, cursor puslapiavimas, idempotentiški POST, pasirašyti webhook pranešimai, generuoti Python ir TypeScript SDK, Postman kolekcija.

Penkiolikos minučių kelias

Gaukite testinės aplinkos raktą. Užsiregistruokite klientų portale ir nukopijuokite sk_test_... raktą. Be pardavimų skambučio, be kortelės. Testinė aplinka nemokama, niekada neapmokestinama ir turi 20 realių Lietuvos sklypų su penkerių metų Sentinel-1, Sentinel-2 ir Sentinel-3 istorija, todėl pirmas kvietimas grąžina pilną atsakymą.
Registruotis testinės aplinkos raktui
Kūrimo aplinkoje iš karto veikia demonstracinis raktas, kurį išspausdina testinės aplinkos užpildymo skriptas; žemiau esantis raktas yra tas, su kuriuo ši svetainė patikrinta, o už jo esantys sklypai atkuriami kas naktį.

Nustatykite tris aplinkos kintamuosius. Juos naudoja kiekvienas pavyzdys šiame puslapyje.

export BASE=https://api.staging.agrovisio.ai/v1
export KEY=sk_test_16e7fa3b7095c7f52f094bec33b48413
export AUTH="Authorization: Bearer $KEY"

Paleiskite tris kvietimus žemiau. Kiekvienas jų pilnas ir veikia su testine aplinka toks, koks parašytas. Idempotency-Key tinka bet koks UUID; python čia naudojamas tik id ištraukti iš JSON.

# 1. 20 bendrų testinės aplinkos sklypų (kiekvienas su 5 metų Sentinel istorija)
curl -s "$BASE/parcels?limit=25" -H "$AUTH"

Kiekvienas sklypas turi external_ref, area_ha, crop_hint, environment: "test", shared požymį (true, kai sklypas priklauso ne jūsų rakto paskyrai - SBX-* rinkinys bet kuriam testinės aplinkos raktui, išskyrus jį valdančią demonstracinę paskyrą) ir data_status bloką, kuris sako, kiek istorijos jis jau turi. Puslapiavimas cursor principu: next_cursor perduokite atgal kaip ?cursor=, kol has_more taps false.

# 2. NDVI laiko serija su kiekvieno stebėjimo anomalija ir penkių sezonų baseline
export PARCEL=$(curl -s "$BASE/parcels?limit=25" -H "$AUTH" \
  | python -c "import sys,json;d=json.load(sys.stdin)['data'];print([p['parcel_id'] for p in d if p['external_ref']=='SBX-FIELD-01'][0])")

curl -s "$BASE/parcels/$PARCEL/indices?index=NDVI&from=2025-04-01&to=2025-09-30" -H "$AUTH"

value: null su reason yra atsakymas, ne klaida: debesuoti pikseliai niekada neinterpoliuojami. anomaly kiekvieną stebėjimą lygina su tuo pačiu metų dienos langu per ankstesnius pilnus sezonus (iki penkių); baseline sako, kiek ta norma patikima; method_version ir config_hash fiksuoja algoritmą. ?quality=good palieka tik vienos kokybės klasės stebėjimus.

# 3. Zalos vertinimas (202 + darbas) 2025-07-04 audrai SBX-LODGING-1 sklype, tada tikrinimas
export LODGING=$(curl -s "$BASE/parcels?limit=25" -H "$AUTH" \
  | python -c "import sys,json;d=json.load(sys.stdin)['data'];print([p['parcel_id'] for p in d if p['external_ref']=='SBX-LODGING-1'][0])")
export IDEM=$(python -c "import uuid;print(uuid.uuid4())")

export JOB=$(curl -s -X POST "$BASE/damage/assess" -H "$AUTH" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $IDEM" \
  -d '{"parcel_id":"'"$LODGING"'","event_date":"2025-07-04","peril":"storm","claim_ref":"CLM-DEMO-1"}' \
  | python -c "import sys,json;print(json.load(sys.stdin)['job_id'])")

sleep 5
curl -s "$BASE/jobs/$JOB" -H "$AUTH"

Viskas, kas trunka ilgiau nei turėtų trukti užklausa, grąžina 202 su darbu; darbo eta_seconds mažėja ir tampa null, kai darbas baigtas. Baigtas darbas turi result.assessment_id; GET /v1/damage/{'{assessment_id}'} grąžina išsaugotą vertinimą, o /certificate.pdf - sertifikatą, kai confidence ne mažesnis nei 0,50. SBX-LODGING-1 su 2025-07-04 atsako damage_pct: 85.0 su pasikliovimu 0.405 - žala neabejotina, bet su direction_not_confirmed ir be sertifikato; SBX-LODGING-3 su 2024-07-03 (storm) yra tas testinės aplinkos atvejis, kuris peržengia slenkstį - 0.51. Šakokitės pagal certificate, niekada nelaikykite PDF savaime suprantamu.

Visa kita

Žinynas

Interaktyvus žinynas su rakto langeliu ir „Try it”, statinis endpoint sąrašas ir klaidų katalogas, į kurį rodo kiekvienas doc_url.

Gidai

Autentifikacija, idempotencija ir limitai, webhook pranešimai, testinė aplinka, apmokestinimas, duomenų atribucija. Gidai, išskyrus greitą startą, kol kas tik anglų kalba.

SDK ir Postman

agrovisio-data-api Python ir @agrovisio/data-api TypeScript, abu generuoti iš OpenAPI dokumento, ir Postman kolekcija su idempotencijos raktų skriptu.

Būsena ir pakeitimai

Gyva API būsena iš jūsų naršyklės ir pakeitimų žurnalas su RSS srautu kiekvienam papildymui, nutraukimui ir metodo versijos pokyčiui.

Bazinis adresas produkcijoje: https://api.agrovisio.ai/v1. Testinės aplinkos ir gyvi raktai jį dalijasi; rakto priešdėlis (sk_test_ / sk_live_) nulemia, kurį pasaulį matote. Contains modified Copernicus Sentinel data.