Data-API en AI-agents
Alles wat de kaart en de Atlas van Criora tonen, is ook programmatisch op te vragen: de zevendaagse verwachting met het bijbehorende risico voor elk punt, het klimaatprofiel op lange termijn van elk punt, gevarengebeurtenissen in de buurt van een punt en het risicoprofiel van elk land. Dezelfde gegevens zijn op twee manieren beschikbaar: via een MCP-server voor AI-assistenten en via een JSON-API voor uw eigen code.
U hebt geen account of sleutel nodig. Beide zijn alleen-lezen.
Voor AI-assistenten: de MCP-server
Criora draait een externe server voor het Model Context Protocol op dit adres:
https://criora.com/mcpVoeg hem toe als aangepaste connector in elke assistent die externe MCP-servers ondersteunt (Claude, ChatGPT, Cursor, VS Code en andere). Authenticatie is niet nodig. Bijvoorbeeld in een MCP-configuratiebestand:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}De server biedt zeven tools. Elke tool accepteert een breedte- en lengtegraad, of een plaatsnaam die hij koppelt aan de beste overeenkomst en in het antwoord vermeldt.
| Tool | Waarop hij antwoord geeft |
|---|---|
assess_place | Alles over een plaats in één antwoord: verwacht risico per dag, gevaren in de buurt, klimaatprofiel, land |
get_forecast | Weer en weerrisico voor zeven dagen, per lokale dag of stap voor stap |
get_climate_profile | Blootstelling op lange termijn: overstromingen, zeespiegelstijging, hitte, droogte, waterstress en meer |
get_hazards_near | Natuurbranden, aardbevingen, overstromingen, cyclonen, vulkanen, droogte en luchtkwaliteit in de buurt van een plaats |
get_country_profile | De risicoscores van een land en, op verzoek, elke indicator met de bijbehorende referentiewaarden |
compare_countries | Twee tot tien landen naast elkaar, met hun positie in de ranglijst |
find_place | Coördinaten bij een plaatsnaam, als een naam niet eenduidig is |
De server biedt daarnaast drie prompts, kant-en-klare vragen waarmee een assistent kan beginnen: assess_trip voor hoe riskant een reis op de reisdata is, compare_places_to_live om de blootstelling van meerdere plaatsen op lange termijn naast elkaar te zetten, en country_briefing om één land af te zetten tegen zijn regio en de rest van de wereld.
Voor uw code: de JSON-API
Alle endpoints staan onder https://criora.com/api/v1 en beantwoorden GET-verzoeken met JSON.
| Endpoint | Geeft terug |
|---|---|
/place/forecast?lat=&lon= | De actuele modelrun op een punt: elke stap en een samenvatting per lokale dag |
/place/climate?lat=&lon= | Alle klimaatlagen voor de lange termijn op een punt; categories= beperkt de selectie (bijv. flooding) |
/place/report?lat=&lon= | Verwachting per dag, gevaren in de buurt, klimaatprofiel en het land in één antwoord |
/geodata/live-events/nearby?lat=&lon= | Gevarengebeurtenissen in de buurt van een punt; radius_km=, event_types= en since= beperken de selectie |
/countries/risks | De totaalscore en de dimensiescores van elk land |
/country/{ISO3}/summary | De scores en de classificatie van één land |
/country/{ISO3}/risks | De indicatoren van één land, elk met de wereldwijde en regionale referentiewaarde |
/geocode/search?q= | Plaatsen die bij een naam passen, uit OpenStreetMap Nominatim |
Bijvoorbeeld de verwachting voor Sevilla:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Het verwachte risico lezen
Elke verwachtingsstap bevat een risicoklasse van 0 (Gering) tot 4 (Kritiek), het gevaar dat die klasse bepaalt en de fysische waarde waarop ze berust: de gevoelstemperatuur volgens UTCI bij hitte en kou, de snelheid van windstoten bij wind en de neerslagintensiteit bij regen en sneeuw. Regen, sneeuw en wind gaan voor temperatuur; de kaart hanteert dezelfde regel. De samenvatting van elke dag noemt het belangrijkste risico van die dag en vermeldt per gevaar de hoogste klasse die het die dag bereikt.
Limieten
Zoekopdrachten op plaatsnaam lopen via OpenStreetMap Nominatim, dat voor heel Criora samen één verzoek per seconde toestaat. Geef dus coördinaten mee als u die hebt.
Verwachtingsantwoorden veranderen wanneer er een nieuwe modelrun verschijnt, twee keer per dag. Klimaatlagen veranderen wanneer een dataset opnieuw wordt opgebouwd. Er kunnen velden aan antwoorden worden toegevoegd; bestaande velden behouden hun betekenis.
Bronnen en naamsvermelding
Elk antwoord vermeldt zijn bron. Wanneer u gegevens van Criora publiceert of verder verspreidt, vermeld dan Criora en volg de licentie van de genoemde bron: de verwachting komt van Environment and Climate Change Canada (ECCC) onder de Data Server End-use Licence, plaatsnamen komen uit OpenStreetMap onder de ODbL, en elke klimaatlaag vermeldt een eigen leverancier en licentie. Zie Gegevensbronnen voor de volledige lijst. Voor het gebruik van de API gelden de Gebruiksvoorwaarden.
Criora publiceert gegevens, geen advies. De cijfers zijn geen vervanging voor professioneel financieel, verzekerings- of veiligheidsadvies.