Портал для партнеров

Документация

API-интерфейсы ClearAg® обеспечивают глубокий и динамичный источник данных о погоде, урожае и почве, чтобы помочь профессионалам в области сельского хозяйства в достижении их целей.

Разделы API

API данных о погоде

Текущая и прогнозируемая погода

Следующие конечные точки API предоставляют прогнозы погоды в формате JSON и текущие погодные условия для любого места по всему миру. Поддерживаются все стандартные типы данных, такие как температура воздуха, относительная влажность, скорость ветра и количество осадков, в дополнение к более специализированным типам, таким как дельта-Т, эвапотранспирация и градусо-дни роста.

Обратите внимание, что ответы API в настоящее время предоставляются только на английском языке.

Использование HTTPS необходимо при работе с ClearAg API.

Сервис предоставляет «Текущие погодные условия для выбранной точки.

Описание URL
https://ag.us.clearapis.com/v1.1/currentconditions?app_id={string}&app_key={string}&location={lat,loncoordinates}&unitcode={string}&lang={string}&icon_resolution={string}

location (широта, долгота координаты, обязательное) - Предоставляемые пользователем координаты широты и долготы в десятичных градусах. Пользователям разрешено использовать максимум пять координат, 1 в формате "& location = [(<lat_1>, <lon_1>), (<lat_2>, <lon_2>)]".

unitcode (строка, не обязательное) - Используемый набор преобразования единиц измерения. По умолчанию - «us-std». Допустимые значения: us-std, si-std, us-std-точный и si-std-точный. Если "точное" не установлено, выходные данные будут округлены до соответствующего уровня точности для параметра.

lang (строка, не обязательное) - Настройка языка. По умолчанию "en-us".

icon_resolution (строка, не обязательное) - Настройка разрешения значков. По умолчанию «128». Допустимые значения: 32, 64, 128 или 256.

Служба дождемеров в режиме реального времени предоставляет последние исторические накопления осадков и данные об отражательной способности радара. Обратите внимание, что это «виртуальная» служба дождемеров, при которой накопления получаются с использованием данных радара (если они доступны), спутниковых оценок, наземных наблюдений и / или численного анализа погоды и информации о прогнозе.

Почасовой прогноз погоды (для агро) предоставляет почасовой прогноз погоды, включая некоторые специализированные параметры, которые используются реже (например, температура поверхности, температура воздуха на высоте 5 см, дельта-Т и эталонная эвапотранспирация). На запрос возвращается максимум 240 часов данных.

start (целое число, обязательное) - Начало временного диапазона. Поддерживаемые диапазоны от нуля до 240. Нулевой час представляет текущий час.

end (целое число, обязательное) - Конец временного диапазона. Поддерживаемые диапазоны от нуля до 240. (Часы, превышающие 240, не могут быть возвращены).

location (широта, долгота координаты, обязательное) - Предоставляемые пользователем координаты широты и долготы в десятичных градусах. Пользователям разрешено использовать максимум пять координат, 1 в формате "& location = [(<lat_1>, <lon_1>), (<lat_2>, <lon_2>)]".

unitcode (строка, не обязательное) - Используемый набор преобразования единиц измерения. По умолчанию - «us-std». Допустимые значения: us-std, si-std, us-std-точный и si-std-точный. Если "точное" не установлено, выходные данные будут округлены до соответствующего уровня точности для параметра.

lang (строка, не обязательное) - Настройка языка. По умолчанию "en-us".

icon_resolution (строка, не обязательное) - Настройка разрешения значков. По умолчанию «128». Допустимые значения: 32, 64, 128 или 256.

Ежедневный прогноз предоставляет прогнозы температуры воздуха. Данные действительны с полуночи до 23:59. в часовом поясе запрашиваемого местоположения. На запрос возвращаются данные максимум за десять дней.

Ежедневный прогноз погоды предоставляет десятидневный прогноз, включая некоторые специализированные параметры, которые используются реже (например, температура воздуха на высоте 5 см, эталонная эвапотранспирация и продолжительность осадков). Данные, предоставляемые этой конечной точкой, действительны с полуночи до 23:59. в часовом поясе запрашиваемого местоположения. На запрос возвращаются данные максимум за десять дней.

Описание URL

https://ag.us.clearapis.com/v1.0/forecast/daily/ag_weather?app_id={string}&app_key={string}&start={integer}&end={integer}&location={lat,loncoordinates}&unitcode={string}&lang={string}&icon_resolution={string}

start (целое число, обязательное) - Начало временного диапазона. Поддерживаемые диапазоны от нуля до 240. Нулевой час представляет текущий час.

end (целое число, обязательное) - Конец временного диапазона. Поддерживаемые диапазоны от нуля до 240. (Часы, превышающие 240, не могут быть возвращены).

location (широта, долгота координаты, обязательное) - Предоставляемые пользователем координаты широты и долготы в десятичных градусах. Пользователям разрешено использовать максимум пять координат, 1 в формате "& location = [(<lat_1>, <lon_1>), (<lat_2>, <lon_2>)]".

unitcode (строка, не обязательное) - Используемый набор преобразования единиц измерения. По умолчанию - «us-std». Допустимые значения: us-std, si-std, us-std-точный и si-std-точный. Если "точное" не установлено, выходные данные будут округлены до соответствующего уровня точности для параметра.

lang (строка, не обязательное) - Настройка языка. По умолчанию "en-us".

icon_resolution (строка, не обязательное) - Настройка разрешения значков. По умолчанию «128». Допустимые значения: 32, 64, 128 или 256.

Сервис ClearAg NowCast предоставляет краткосрочный прогноз осадков и отражательной способности радара в дополнение к недавним историческим данным. Исторические данные о погоде предоставляются за предыдущие четыре часа, а прогнозные данные - на два часа вперед.

Конечная точка «Сводка осадков» предоставляет краткосрочные и долгосрочные исторические итоги осадков, такие как накопления за последние 24 часа, 90 дней и за год до текущей даты.

Конечная точка прогноза заморозков предоставляет 15-минутные прогнозы заморозков, которые показывают, следует ли ожидать заморозков на поверхности растительности. На запрос возвращается максимум 72 часа данных.

Сумма активных температур (GDD) предоставляет пользователям исторические и прогнозные оценки роста градусо-дней с использованием метода единственного синуса. Этот метод использует дневную минимальную и максимальную температуры для построения синусоидальной кривой за 24-часовой период, а затем оценивает градусо-дни для этого дня, вычисляя площадь выше пороговой (базовой) температуры и ниже синусоидальной кривой. Этот метод предполагает, что температурная кривая симметрична относительно максимальной температуры.

Историческая и климатологическая погода

Следующие конечные точки API предоставляют исторические и климатологические погодные условия в формате JSON для любой точки мира. Эта информация может быть полезной для организаций, которым необходимо анализировать или сравнивать прошлые условия окружающей среды для оценки характеристик продукта, а также стратегии внесения питательных веществ или химикатов в продукт для оптимального роста и здоровья сельскохозяйственных культур.

Информация о доступности данных конечной точки и ограничениях доступна во вводном разделе каждой конечной точки.

Обратите внимание, что ответы API в настоящее время предоставляются только на английском языке.

Использование HTTPS необходимо при работе с ClearAg API.

Конечная точка предоставляет ежедневную погодную климатологию за последние пять полных лет. Данные, предоставляемые этой конечной точкой, действительны с полуночи до 23:59. в часовом поясе запрошенного местоположения, при этом максимум данных, возвращаемых на каждый запрос, составляет 366 дней. Эти данные не привязаны к конкретному году; поэтому пользователи могут выбрать конкретную дату и получать данные, относящиеся к этому дню каждый год за последние пять лет.

Описание URL

https://ag.us.clearapis.com/v1.0/historical/daily/climatology/five_year?app_id={string}&app_key={string}&location={lat,loncoordinates}&start_date={string}&end_date={string}&unitcode={string}

location (широта, долгота координаты, обязательное) - Предоставляемые пользователем координаты широты и долготы в десятичных градусах. Пользователям разрешено использовать максимум пять координат, 1 в формате "&location = [(<lat_1>, <lon_1>), (<lat_2>, <lon_2>)]".

start (целое число, обязательное) - Строка, представляющая дату начала возвращаемых данных, которая должна быть отформатирована как ММ-ДД или ГГГГ-ММ-ДД. Если год не указан, будут возвращены только даты, действительные для текущего года. Если требуется дополнительная дата, являющаяся результатом високосного года, укажите год, в котором происходит високосный год. Если требуется диапазон дат, выходящий за пределы одного непрерывного года, необходимо указать год.

end (целое число, обязательное) - Строка, представляющая дату окончания возвращаемых данных, которая должна быть отформатирована как ММ-ДД или ГГГГ-ММ-ДД. Год необходимо указать, если start_date содержит год.

unitcode (строка, не обязательное) - Используемый набор преобразования единиц. По умолчанию - «us-std». Допустимые значения: us-std, si-std, us-std-точный и si-std-точный. Если "точное" не установлено, выходные данные будут округлены до соответствующего уровня точности для параметра.