Ana içeriğe atla
POST
/
v1
/
forecasts
/
current
Güncel Tahmin İşlemi
curl --request POST \
  --url https://api.iklim.co/v1/forecasts/current \
  --header 'Content-Type: application/json' \
  --data '
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "metrics": [
    "TEMPERATURE",
    "HUMIDITY"
  ],
  "forecastDays": 7,
  "startTime": 1746454091000
}
'
{
  "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

Anlık hava durumu uç noktası için talep edilen metrikler. İzin verilen değerler: WEATHER_ICON, TEMPERATURE, APPARENT_TEMPERATURE, HUMIDITY, CLOUD_COVER, WIND_SPEED, WIND_GUSTS, WIND_DIRECTION, SNOWFALL, PRECIPITATION

Minimum array length: 1
Mevcut seçenekler:
WEATHER_ICON,
TEMPERATURE,
TEMPERATURE_AVG,
TEMPERATURE_MIN,
TEMPERATURE_MAX,
APPARENT_TEMPERATURE,
APPARENT_TEMPERATURE_AVG,
APPARENT_TEMPERATURE_MIN,
APPARENT_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,
SNOWFALL,
PRECIPITATION,
PRECIPITATION_PROBABILITY,
PRECIPITATION_PROBABILITY_AVG,
PRECIPITATION_PROBABILITY_MIN,
PRECIPITATION_PROBABILITY_MAX,
REF_EVAPORATION_TRANSPIRATION_ET0,
REF_EVAPORATION_TRANSPIRATION_ET0_SUM,
DEW_POINT,
DEW_POINT_AVG,
DEW_POINT_MIN,
DEW_POINT_MAX,
SOIL_TEMPERATURE,
SOIL_MOISTURE,
GLOBAL_TILTED_RADIATION_GTI,
DIRECT_NORMAL_IRRADIANCE_DNI,
SHORTWAVE_SOLAR_RADIATION_GHI,
SHORTWAVE_RADIATION_SUM,
VISIBILITY,
VISIBILITY_AVG,
VISIBILITY_MIN,
VISIBILITY_MAX
Örnek:
["TEMPERATURE", "HUMIDITY"]
​
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

Yanıt

Güncel hava durumu 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"
]