API de date și agenți AI
Tot ce afișează harta și Atlasul Criora poate fi citit și programatic: prognoza pe șapte zile și riscul asociat pentru orice punct, profilul climatic pe termen lung al oricărui punct, evenimentele de hazard din apropierea unui punct și profilul de risc al fiecărei țări. Aceleași date sunt oferite în două moduri: un server MCP pentru asistenții AI și un API JSON pentru propriul dumneavoastră cod.
Nu aveți nevoie de cont sau de cheie. Ambele sunt disponibile doar pentru citire.
Pentru asistenții AI: serverul MCP
Criora rulează un server Model Context Protocol la distanță, la adresa:
https://criora.com/mcpAdăugați-l drept conector personalizat în orice asistent care acceptă servere MCP la distanță (Claude, ChatGPT, Cursor, VS Code și altele). Nu este necesară autentificarea. De exemplu, într-un fișier de configurare MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Serverul oferă șapte instrumente. Fiecare primește latitudinea și longitudinea sau un nume de loc, pe care îl asociază celei mai bune potriviri și o indică în răspuns.
| Instrument | La ce răspunde |
|---|---|
assess_place | Totul despre un loc într-un singur răspuns: riscul prognozat pe zile, hazardurile din apropiere, profilul climatic, țara |
get_forecast | Vremea și riscul meteorologic pe șapte zile, pe zile locale sau pas cu pas |
get_climate_profile | Expunerea pe termen lung: inundații, creșterea nivelului mării, căldură, secetă, stres hidric și altele |
get_hazards_near | Incendii de vegetație, cutremure, inundații, cicloni, vulcani, secete și calitatea aerului în apropierea unui loc |
get_country_profile | Scorurile de risc ale unei țări și, la cerere, fiecare indicator cu valorile sale de referință |
compare_countries | Între două și zece țări, puse una lângă alta, cu locul lor în clasament |
find_place | Coordonatele unui loc după nume, atunci când numele este ambiguu |
Serverul oferă și trei prompturi, întrebări gata pregătite de la care poate porni un asistent: assess_trip, pentru cât de riscantă este o călătorie la datele ei, compare_places_to_live, pentru expunerea pe termen lung a mai multor locuri puse alături, și country_briefing, pentru o țară comparată cu regiunea ei și cu restul lumii.
Pentru codul dumneavoastră: API-ul JSON
Toate endpointurile se află sub https://criora.com/api/v1 și răspund în format JSON la cereri GET.
| Endpoint | Returnează |
|---|---|
/place/forecast?lat=&lon= | Rularea curentă a prognozei într-un punct: fiecare pas și un rezumat pentru fiecare zi locală |
/place/climate?lat=&lon= | Toate straturile climatice pe termen lung dintr-un punct; categories= restrânge selecția (de ex. flooding) |
/place/report?lat=&lon= | Prognoza pe zile, hazardurile din apropiere, profilul climatic și țara, într-un singur răspuns |
/geodata/live-events/nearby?lat=&lon= | Evenimentele de hazard din apropierea unui punct; radius_km=, event_types= și since= restrâng selecția |
/countries/risks | Scorul general și scorurile pe dimensiuni ale fiecărei țări |
/country/{ISO3}/summary | Scorurile și clasificarea unei singure țări |
/country/{ISO3}/risks | Indicatorii unei singure țări, fiecare cu valoarea de referință mondială și regională |
/geocode/search?q= | Locurile care corespund unui nume, din OpenStreetMap Nominatim |
De exemplu, prognoza pentru Sevilla:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Cum citiți riscul din prognoză
Fiecare pas al prognozei are o clasă de risc de la 0 (Minim) la 4 (Critic), hazardul care o determină și valoarea fizică pe care se bazează: temperatura resimțită UTCI pentru căldură și frig, viteza rafalelor pentru vânt, intensitatea precipitațiilor pentru ploaie și ninsoare. Ploaia, ninsoarea și vântul au prioritate față de temperatură, după aceeași regulă pe care o aplică și harta. Rezumatul fiecărei zile numește riscul principal și indică, pentru fiecare hazard, cea mai înaltă clasă atinsă în acea zi.
Limite
Căutările după numele locului trec prin OpenStreetMap Nominatim, care permite o singură cerere pe secundă pentru întreaga platformă Criora, așa că transmiteți coordonatele atunci când le aveți.
Răspunsurile de prognoză se schimbă atunci când este publicată o nouă rulare a modelului, de două ori pe zi. Straturile climatice se schimbă atunci când un set de date este reconstruit. Răspunsurile pot primi câmpuri noi; câmpurile existente își păstrează semnificația.
Surse și atribuire
Fiecare răspuns își indică sursa. Când publicați sau redistribuiți date din Criora, menționați Criora și respectați licența sursei indicate: prognoza provine de la Environment and Climate Change Canada (ECCC), sub licența Data Server End-use Licence, numele locurilor provin din OpenStreetMap, sub licența ODbL, iar fiecare strat climatic își indică propriul furnizor și propria licență. Lista completă se află în Surse de date. Utilizarea API-ului este reglementată de Termenii și condițiile.
Criora publică date, nu consultanță. Cifrele sale nu înlocuiesc consultanța profesională financiară, de asigurări sau de siguranță.