Ana içeriğe atla
POST
/
v1
/
forecasts
/
hourly
Saatlik Tahmin İşlemi
curl --request POST \
  --url https://api.iklim.co/v1/forecasts/hourly \
  --header 'Content-Type: application/json' \
  --data '
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "metrics": [
    "TEMPERATURE",
    "WIND_SPEED"
  ],
  "forecastDays": 7,
  "startTime": 1746454091000,
  "solarPanelTiltForRadiation": 45,
  "solarPanelAzimuthForRadiation": 0
}
'
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "timezone": "Europe/Istanbul",
  "elevation": 897.5,
  "weatherIconUrlBase": "https://api-test.iklim.co/v1/weather-icons",
  "metricForecasts": [
    {
      "metric": "TEMPERATURE",
      "unit": "°C",
      "forecasts": [
        {
          "time": "2025-04-14T16:58:22Z",
          "isDay": true,
          "value": 23.5,
          "icon": "sunny"
        }
      ]
    }
  ],
  "warnings": [
    "The provided metric is not valid for this request: TEMPERATURE_SUM"
  ]
}

Gövde

application/json
​
location
object
gerekli

Hava tahmini sorgusunun yapılacağı coğrafi nokta

​
metrics
enum<string>[]
gerekli

Saatlik tahmin uç noktası için talep edilen metrikler. İzin verilen değerler: WEATHER_ICON, TEMPERATURE, HUMIDITY, CLOUD_COVER, WIND_SPEED, WIND_GUSTS, WIND_DIRECTION, PRECIPITATION, PRECIPITATION_PROBABILITY, REF_EVAPORATION_TRANSPIRATION_ET0, DEV_POINT, SOIL_TEMPERATURE, SOIL_MOISTURE, GLOBAL_TILED_RADIATION_GTI, DIRECT_NORMAL_IRRADIANCE_DNI, SHORTWAVE_SOLAR_RADIATION_GHI

Minimum array length: 1
Mevcut seçenekler:
WEATHER_ICON,
TEMPERATURE,
TEMPERATURE_AVG,
TEMPERATURE_MIN,
TEMPERATURE_MAX,
HUMIDITY,
HUMIDITY_AVG,
HUMIDITY_MIN,
HUMIDITY_MAX,
CLOUD_COVER,
CLOUD_COVER_AVG,
CLOUD_COVER_MIN,
CLOUD_COVER_MAX,
WIND_SPEED,
WIND_SPEED_AVG,
WIND_SPEED_MIN,
WIND_SPEED_MAX,
WIND_GUSTS,
WIND_GUSTS_AVG,
WIND_GUSTS_MIN,
WIND_GUSTS_MAX,
WIND_DIRECTION,
PRECIPITATION,
PRECIPITATION_PROBABILITY,
PRECIPITATION_PROBABILITY_AVG,
PRECIPITATION_PROBABILITY_MIN,
PRECIPITATION_PROBABILITY_MAX,
REF_EVAPORATION_TRANSPIRATION_ET0,
REF_EVAPORATION_TRANSPIRATION_ET0_SUM,
DEV_POINT,
DEV_POINT_AVG,
DEV_POINT_MIN,
DEV_POINT_MAX,
SOIL_TEMPERATURE,
SOIL_MOISTURE,
GLOBAL_TILED_RADIATION_GTI,
DIRECT_NORMAL_IRRADIANCE_DNI,
SHORTWAVE_SOLAR_RADIATION_GHI,
SHORTWAVE_RADIATION_SUM
Örnek:
["TEMPERATURE", "WIND_SPEED"]
​
forecastDays
integer<int32>

Döndürülecek maksimum gün sayısı (1-14)

Gerekli aralık: 1 <= x <= 14
Örnek:

7

​
startTime
integer<int64>

Talep ufkunun başlangıcını belirleyen isteğe bağlı epoch milisaniyesi

Örnek:

1746454091000

​
solarPanelTiltForRadiation
number<double>

Solar radyasyon metriklerini hesaplamak için kullanılan panel eğim açısı (derece)

Örnek:

45

​
solarPanelAzimuthForRadiation
number<double>

Solar radyasyon metriklerini hesaplamak için kullanılan panel azimut açısı (derece)

Örnek:

0

Yanıt

Saatlik hava tahmin verileri başarıyla getirildi.

​
location
object

Tahminin üretildiği konum

​
timezone
string

Zaman damgalarında kullanılan IANA zaman dilimi kimliği

Örnek:

"Europe/Istanbul"

​
elevation
number<double>

Talep edilen konumun metre cinsinden rakımı

Örnek:

897.5

​
weatherIconUrlBase
string

Hava durumu simgelerini almak için kullanılabilecek temel URL

Örnek:

"https://api-test.iklim.co/v1/weather-icons"

​
metricForecasts
object[]

Cevapta döndürülen metrik tahminleri

​
warnings
string[]

İstek için döndürülen bilgilendirici uyarılar

Örnek:
[
  "The provided metric is not valid for this request: TEMPERATURE_SUM"
]