API даних та ШІ-агенти
Усе, що показують карта й Атлас Criora, доступне і програмно: семиденний прогноз погоди та його ризик для будь-якої точки, довгостроковий кліматичний профіль будь-якої точки, небезпечні події поблизу точки та профіль ризиків кожної країни. Ці дані можна отримати двома способами: через MCP-сервер для ШІ-асистентів і через JSON API для Вашого власного коду.
Ні обліковий запис, ні ключ не потрібні. Обидва інтерфейси працюють лише на читання.
Для ШІ-асистентів: MCP-сервер
Criora надає віддалений сервер Model Context Protocol за адресою:
https://criora.com/mcpДодайте його як власний конектор у будь-якому асистенті, що підтримує віддалені MCP-сервери (Claude, ChatGPT, Cursor, VS Code та інші). Автентифікація не потрібна. Наприклад, у конфігураційному файлі MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Сервер пропонує сім інструментів. Кожен приймає широту й довготу або назву місця: інструмент сам знаходить найкращий збіг і повідомляє, яке місце обрав.
| Інструмент | На яке питання відповідає |
|---|---|
assess_place | Усе про місце в одній відповіді: ризик за прогнозом на кожен день, загрози поблизу, кліматичний профіль, країна |
get_forecast | Погода й погодний ризик на сім днів, за місцевими добами або за кроками прогнозу |
get_climate_profile | Довгострокова експозиція: повені, підвищення рівня моря, спека, посуха, водний стрес та інші загрози |
get_hazards_near | Лісові пожежі, землетруси, повені, циклони, вулкани, посухи та якість повітря поблизу місця |
get_country_profile | Оцінки ризиків країни та, на запит, усі індикатори з їхніми орієнтирами для порівняння |
compare_countries | Від двох до десяти країн у порівнянні, з їхніми місцями в рейтингу |
find_place | Координати за назвою місця, якщо назва неоднозначна |
Крім того, сервер пропонує три промпти, готові запитання, з яких асистент може почати: assess_trip показує, наскільки ризикована поїздка у вибрані дати, compare_places_to_live порівнює довгострокові ризики кількох місць, а country_briefing зіставляє країну з її регіоном і рештою світу.
Для Вашого коду: JSON API
Усі ендпоінти розміщені за адресою https://criora.com/api/v1, відповідають на запити GET і повертають JSON.
| Ендпоінт | Що повертає |
|---|---|
/place/forecast?lat=&lon= | Актуальний прогін прогнозу в точці: усі кроки та зведення за кожну місцеву добу |
/place/climate?lat=&lon= | Усі довгострокові кліматичні шари в точці; параметр categories= звужує вибірку (наприклад, flooding) |
/place/report?lat=&lon= | Прогноз по днях, загрози поблизу, кліматичний профіль і країну в одній відповіді |
/geodata/live-events/nearby?lat=&lon= | Небезпечні події поблизу точки; вибірку звужують radius_km=, event_types= і since= |
/countries/risks | Загальну оцінку й оцінки за вимірами для кожної країни |
/country/{ISO3}/summary | Оцінки та класифікацію однієї країни |
/country/{ISO3}/risks | Індикатори однієї країни, кожен зі своїм світовим і регіональним орієнтиром |
/geocode/search?q= | Місця, що відповідають назві, за даними OpenStreetMap Nominatim |
Наприклад, прогноз для Севільї:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Як читати ризик у прогнозі
Кожен крок прогнозу містить клас ризику від 0 («Слабкий») до 4 («Тяжкий»), загрозу, яка його визначає, і фізичну величину, на якій він ґрунтується: відчутну температуру за індексом UTCI для спеки й холоду, швидкість поривів для вітру, інтенсивність опадів для дощу й снігу. Дощ, сніг і вітер мають пріоритет над температурою: за тим самим правилом працює карта. Зведення кожного дня називає головний ризик дня й перелічує найвищий клас, якого того дня досягає кожна загроза.
Обмеження
Пошук за назвою місця йде через OpenStreetMap Nominatim, який дозволяє один запит на секунду для всієї Criora разом, тому, якщо координати відомі, передавайте саме їх.
Відповіді з прогнозом змінюються, коли публікується новий прогін моделі, тобто двічі на добу. Кліматичні шари змінюються, коли набір даних перебудовується. У відповідях можуть з’являтися нові поля; наявні поля зберігають своє значення.
Джерела та зазначення авторства
Кожна відповідь називає своє джерело. Публікуючи або поширюючи дані Criora, зазначайте Criora та дотримуйтеся ліцензії названого джерела: прогноз надає Міністерство довкілля та зміни клімату Канади (ECCC) за ліцензією Data Server End-use Licence, назви місць узято з OpenStreetMap за ліцензією ODbL, а кожен кліматичний шар зазначає власного постачальника й ліцензію. Повний перелік наведено в розділі Джерела даних. Використання API регулюють Умови використання.
Criora публікує дані, а не поради. Її цифри не замінюють професійної консультації з фінансових і страхових питань чи з питань безпеки.