API za podatke i AI agenti
Sve što prikazuju Criorina mapa i Atlas može se čitati i programski: sedmodnevna prognoza i njen rizik za bilo koju tačku, dugoročni klimatski profil bilo koje tačke, opasni događaji u blizini tačke i profil rizika svake zemlje. Isti podaci dostupni su na dva načina: kao MCP server za AI asistente i kao JSON API za vaš sopstveni kod.
Nisu vam potrebni ni nalog ni ključ. Oba pristupa su samo za čitanje.
Za AI asistente: MCP server
Criora pokreće udaljeni Model Context Protocol server na adresi:
https://criora.com/mcpDodajte ga kao prilagođeni konektor u bilo kom asistentu koji podržava udaljene MCP servere (Claude, ChatGPT, Cursor, VS Code i drugi). Autentifikacija nije potrebna. Na primer, u MCP konfiguracionoj datoteci:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Server nudi sedam alata. Svaki prima geografsku širinu i dužinu ili naziv mesta, koji povezuje sa najboljim poklapanjem i navodi ga u odgovoru.
| Alat | Na šta odgovara |
|---|---|
assess_place | Sve o mestu u jednom odgovoru: prognozirani rizik po danima, opasnosti u blizini, klimatski profil, zemlja |
get_forecast | Vreme i vremenski rizik za sedam dana, po lokalnim danima ili korak po korak |
get_climate_profile | Dugoročna izloženost: poplave, porast nivoa mora, vrućina, suša, vodni stres i drugo |
get_hazards_near | Požari, zemljotresi, poplave, cikloni, vulkani, suše i kvalitet vazduha u blizini mesta |
get_country_profile | Ocene rizika jedne zemlje i, na zahtev, svaki indikator sa njegovim referentnim vrednostima |
compare_countries | Od dve do deset zemalja uporedo, sa njihovim mestom na rang-listi |
find_place | Koordinate za naziv mesta, kada naziv nije jednoznačan |
Server nudi i tri prompta, unapred pripremljena pitanja od kojih asistent može da krene: assess_trip za to koliko je putovanje rizično u zadatim danima, compare_places_to_live za uporedni pregled dugoročne izloženosti više mesta i country_briefing za poređenje jedne zemlje sa njenim regionom i ostatkom sveta.
Za vaš kod: JSON API
Svi endpointi nalaze se pod https://criora.com/api/v1 i odgovaraju na GET zahteve u JSON formatu.
| Endpoint | Vraća |
|---|---|
/place/forecast?lat=&lon= | Tekuću prognozu za tačku, iz poslednjeg pokretanja modela: svaki korak i rezime po lokalnom danu |
/place/climate?lat=&lon= | Sve dugoročne klimatske slojeve u tački; categories= sužava izbor (npr. flooding) |
/place/report?lat=&lon= | Prognozu po danima, opasnosti u blizini, klimatski profil i zemlju u jednom odgovoru |
/geodata/live-events/nearby?lat=&lon= | Opasne događaje u blizini tačke; radius_km=, event_types= i since= sužavaju izbor |
/countries/risks | Ukupnu ocenu i ocene po dimenzijama za svaku zemlju |
/country/{ISO3}/summary | Ocene i klasifikaciju jedne zemlje |
/country/{ISO3}/risks | Indikatore jedne zemlje, svaki sa svetskom i regionalnom referentnom vrednošću |
/geocode/search?q= | Mesta koja odgovaraju nazivu, iz servisa OpenStreetMap Nominatim |
Na primer, prognoza za Sevilju:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Kako čitati rizik u prognozi
Svaki korak prognoze nosi klasu rizika od 0 (Slab) do 4 (Opasan), opasnost koja je određuje i fizičku vrednost na kojoj počiva: osećaj temperature po indeksu UTCI za vrućinu i hladnoću, brzinu udara vetra za vetar, intenzitet padavina za kišu i sneg. Kiša, sneg i vetar imaju prednost nad temperaturom, po istom pravilu koje koristi i mapa. Rezime svakog dana navodi glavni rizik tog dana i najvišu klasu koju tog dana dostiže svaka opasnost.
Ograničenja
Pretraga po nazivu mesta ide preko servisa OpenStreetMap Nominatim, koji dozvoljava jedan zahtev u sekundi za celu Crioru zajedno, pa prosleđujte koordinate kad god ih imate.
Odgovori sa prognozom menjaju se kada se objavi novo pokretanje modela, dva puta dnevno. Klimatski slojevi menjaju se kada se skup podataka ponovo izgradi. Odgovorima mogu biti dodata nova polja; postojeća polja zadržavaju svoje značenje.
Izvori i navođenje autorstva
Svaki odgovor navodi svoj izvor. Kada objavljujete ili dalje distribuirate podatke iz Criore, navedite Crioru i poštujte licencu navedenog izvora: prognoza potiče od Environment and Climate Change Canada (ECCC) pod njihovom licencom Data Server End-use Licence, nazivi mesta potiču iz OpenStreetMap-a pod licencom ODbL, a svaki klimatski sloj navodi sopstvenog dobavljača i licencu. Kompletan spisak potražite na stranici Izvori podataka. Korišćenje API-ja uređuju Uslovi korišćenja.
Criora objavljuje podatke, ne savete. Njene brojke ne zamenjuju stručni savet u oblasti finansija, osiguranja ili bezbednosti.