NAV Navbar
Examples

Authentication

--header 'apikey': 'your_secret_apikey'

Authentication is done via request's header. "apikey" parameter should be given at header. Apikeys have daily or monthly or yearly limits and they may not open every product in tarla API.

Base URL: http://world.tarla.in/v3

Drought

Drought service returns the drought information of given location.

Base URL http://world.tarla.in/v3/drought
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/drought?lat=39&lng=32&month=2&year=2018

Explanation of request parameters:

Parameter Type Explanation
lat Float Latitude
lng Float Longitude
month Integer Integer value of month. Between 1-12
year Integer Integer value of year. Ex: 2019

Swagger for drought

Explanation of response body parameters:

Successful response body

{
  "drought": {
      "few_drought_possibility": 9.13,
      "moderate_drought_possibility": 5.06,
      "pdsi": -2.396,
      "pdsiInfo": "Orta Kurak",
      "severe_drought_possibility": 2.48,
      "spei12": -0.729,
      "spei12Info": "Hafif Kurak",
      "spei9": -0.8,
      "spei9Info": "Orta Kurak",
      "spi12": -0.148,
      "spi12Info": "Normal",
      "spi6": -0.461,
      "spi6Info": "Normal",
      "total_drought_possibility": 16.67
  }
}

Parameter Type Explanation
few_drought_possibility Float Unit: Percentage %
moderate_drought_possibility Float Unit: Percentage %
pdsi Float Palmer drought index. Between -6 and 6
pdsiInfo String Explanation of palmer drought index
severe_drought_possibility Float Unit: Percentage %
spei12 Float 12 month spei drought index. Between -3 and 3
spei12Info String Explanation spei12
spei9 Float 9 month spei drought index. Between -3 and 3
spei9Info String Explanation spei9
spi12 Float 12 month spi drought index. Between -3 and 3
spi12Info String Explanation spi12
spi6 Float 6 month spi drought index. Between -3 and 3
spi6Info String Explanation spi6
total_drought_possibility Float Explanation of palmer drought index

PDSI, SPEI, SPI Tables

Table of PDSI Values Drought1

Table of SPEI Values Drought2

Table of SPI Values Drought3

Risk

Risk service returns all long term risk parameters (weather and lightning) for a location. Risk results are returned by grid base. Grid dimension is 12x12 km. The returning results belong to the grid of the given coordinate. Assuming that the
location is Antalya Airport. The returning result belongs to the grid that includes Antalya Airport. Number of lightnings and number of polygons indicates the number of events in the grid area.
You can see a grid example at belove image:

Grid

Base URL http://world.tarla.in/v3/risk
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/risk?lat=39&lng=32

Explanation of request parameters:

Parameter Type Explanation
lat Float Latitude
lng Float Longitude

Swagger for risk

Explanation of response body parameters:

Successful response body

{
  "lat": 39,
  "lng": 32,
  "start_date": "20160501",
  "end_date": "20190315",
  "total_day": 1048,
  "cg_count": 745,
  "ic_count": 215,
  "lightning_risk_count": 4,
  "lightning_risk_count_percent": 0.38,
  "total_precipitation": 852.0,
  "yearly_precipitation": {
          "2016": 134.9,
          "2017": 320.5,
          "2018": 315.0,
          "2019": 81.6
  },
  "total_precip_days": 243,
  "mean_precip_per_day": 0.81,
  "max_precip_day": {
         "value": 19.1,
         "day": "20180329"
  },
  "max_precip_month": {
         "value": 178.2,
         "month": "January"
  },
  "precipitation_90": 6.49,
  "concecutive_precip": 6,
  "concecutive_drought": 105,
  "mean_wind_per_day": 16.63,
  "wind_90": 31.97,
  "max_temp_90": 34.28,
  "max_temp_10": 1.76,
  "min_temp_90": 18.92,
  "min_temp_10": -6.71,
  "max_temp_day": {
        "value": 39.0,
        "day": "20170703"
  },
  "min_temp_day": {
        "value": -14.0,
        "day": "20171228"
  },
  "humudity_90": 84.15,
  "total_gdd_acc": 5639.0,
  "total_dsv_acc": 14.0,
  "total_sun_acc": 7390.0,
  "total_evapotrans_acc": 921.6,
  "long_term_monthly_precipitation": [
    {
      "month": 4,
      "year": 2018,
      "precipication": 45.5162
    },
    {
      "month": 5,
      "year": 2018,
      "precipication": 27.5539
    },
    {
      "month": 6,
      "year": 2018,
      "precipication": 8.1739
    },
    {
      "month": 7,
      "year": 2018,
      "precipication": 2.3142
    },
    {
      "month": 8,
      "year": 2018,
      "precipication": 2.1591
    },
    {
      "month": 9,
      "year": 2018,
      "precipication": 13.4742
    },
    {
      "month": 10,
      "year": 2018,
      "precipication": 48.2449
    },
    {
      "month": 11,
      "year": 2018,
      "precipication": 105.1477
    },
    {
      "month": 12,
      "year": 2018,
      "precipication": 145.3067
    },
    {
      "month": 1,
      "year": 2019,
      "precipication": 141.0835
    },
    {
      "month": 2,
      "year": 2019,
      "precipication": 105.6716
    },
    {
      "month": 3,
      "year": 2019,
      "precipication": 80.2739
    },
    {
      "month": 4,
      "year": 2019,
      "precipication": 45.5162
    }
  ],
  "monthly_risks": {
    "January": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "February": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "March": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "April": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "May": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "June": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "July": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "August": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "September": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "October": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "November": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
    "December": {
      "month_count": 3,
      "avarage_cg": 0.67,
      "avarage_ic": 0.33,
      "low_polygon": 0,
      "medium_polygon": 0,
      "high_polygon": 0,
      "precipitation": 178.2,
      "gdd": 36,
      "dsv": 0,
      "sun_acc": 860.0,
      "evapotrans_acc": 80.8
    },
  }
}
Parameter Type Explanation
lat Float Float
lng Float Float
start_date String Start date of calculation of returning risk parameters.
end_date String End date of calculation of returning risk parameters.
total_day Integer Indicates that for how many days these risk parameters are calculated. (end_date - start_date)
cg_count Integer Total cloud to ground lightning count in the 12x12km grid.
ic_count Integer Total inter cloud lightning count in the 12x12km grid.
lightning_risk_count Integer Number of risky days that can happen hail etc. Number of days that have cg/ic < 0.1
lightning_risk_count_percent Float Percentage of lightning risks in total days
total_precipitation Float Total precipitation. Unit milimeter.
yearly_precipitation JSON Total precipitation for each year in a given time interval. Unit milimeter.
total_precip_days Integer How many days passed with precipitation in given time interval.
mean_precip_per_day Float Average precipitation for one day in given time interval.
max_precip_day JSON Indicates the day that has maximum precipitation for given time interval.
max_precip_month JSON Indicates the month that has maximum precipitation for given time interval.
precipitation_90 Float Extreme precipitation average that is above 90 percent when values are sorted in ascending order.
concecutive_precip Integer Indicates how many consecutive 5 days precipitation happened.
concecutive_drought Integer Indicates how many consecutive 5 days drougth(no precipitation) happened.
mean_wind_per_day Float Average wind speed for one day in given time interval. Unit km/h
wind_90 Float Extreme wind speed average that is above 90 percent when values are sorted in ascending order.
max_temp_90 Float Extreme maximum temperature average that is above 90 percent when values are sorted in ascending order.
max_temp_10 Float Extreme maximum temperature average that is belove 10 percent when values are sorted in ascending order.
min_temp_90 Float Extreme minimum temperature average that is above 90 percent when values are sorted in ascending order.
min_temp_10 Float Extreme minimum temperature average that is belove 10 percent when values are sorted in ascending order.
max_temp_day JSON Indicates the day that has maximum temperature for given time interval
min_temp_day JSON Indicates the day that has minimum temperature for given time interval
humudity_90 Float Extreme humidity average that is above 90 percent when values are sorted in ascending order. Unit percentage %
total_gdd_acc Float Temperature accumulation in given time interval. Unit celcius
total_dsv_acc Float Disease risk accumulation in given time interval. Unitless
total_sun_acc Float Sunshine time accumulation in given time interval. Unit hour
total_evapotrans_acc Float Sweating evaporation accumulation in given time interval. Unit milimeter.
long_term_monthly_precipitation JSON Average precipitations are calculated from approximately 30 years of data starting from the given year.
monthly_risks JSON Risk parameters for months



Explanation of long_term_monthly_precipitation JSON:

Parameter Type Explanation
month Integer Integer value of month. Between 1-12
year Integer Integer value of year. Ex: 2019
precipitation Float Average precipitation for this date calculated from ~30 years of data.



Explanation of monthly_risks JSON:

Parameter Type Explanation
month_count Integer Indicates how many month there are in given time interval
avarage_cg Float Average cloud to ground lightning that happened in this month.(in 12x12km grid)
avarage_ic Float Average inter cloud lightning that happened in this month.(in 12x12km grid)
low_polygon Integer Number of low (few) storm polygon that happened in this month.(in 12x12km grid)
medium_polygon Integer Number of medium (moderate) storm polygon that happened in this month.(in 12x12km grid)
high_polygon Integer Number of high (severe) storm polygon that happened in this month.(in 12x12km grid)
precipitation Float Total precipitation in this month. Unit milimeter.
gdd Float Temperature accumulation in this month. Unit celcius
dsv Float Disease risk accumulation in this month. Unitless
sun_acc Float Sunshine accumulation in this month. Unit hour
evapotrans_acc Float Sweating evaporation accumulaiton in this month. Unit milimeter




Explanation of percentile: Percentile


Explanation of consecutive precip, drought:
Returns the number of series of 5 consecutive days with precipitation. The array given below shows the amount of precipitation and the number of consecutive_precip.

Precipitation Array: [0, 0, 1.2, 2.3, 0.5, 0, 1.3, 1.5, 2.5, 3.1, 2.6, 4.2, 5.3, 0, 0, 1.2, 3.1, 4.2, 5.3, 1 ]
Consecutive_precip: 2


Explanation of month count:

Returns number of months between the given time interval. The example is shown below.
start_date: 20180301
end_date: 20190530

There is 1 consecutive months of the year and an extra 2 March, April and May, such as March in 2018 and 2019, within the time period given above

Nowcast

Nowcast

Nowcast service sends you an alert for lightning, precipitation or storm polygon events.

This URL is to include a user to nowcast service. When an alert is happening in the user's location, we POST a JSON to URL that is specified when including the user. We send all users at once, not one by one. If no alert alert has happened in any of your user's location, we do not POST anything.
Therefore, to use this service, you need an API that accepts our POST requests. Then you can put URL of your API when you are adding new user under post_url parameter.

Nowcast service checks all coordinates approximately every 6 minutes. If it detects any lightning, precipitation or storm polygon, it sends alerts. When an alert is sent to the user, 1 hour sleep time begins. It means that we do not send same alert type for that user for 1 hour. Assume that the system sends a lightning alert to user X. Then it does not send any lightning alert for that user for 1 hour. However, if precipitation alert happens in user X's location, system sends it.

Base URL http://world.tarla.in/v3/nowcast
Request Type POST
Request Heeader application/json
Response Type Instant response
{
 "lat": 39.0,
 "lng": 32.0,
 "post_url": "http://sample-backend.com/nowcast",
 "auth_token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
 "user_id": "sample_user_id",
 "is_lightning": true,
 "is_polygon": true,
 "is_precipitation": false
}
Parameter Type Explanation
lat Float Latitude of user's coordinate.
lng Float Longitude of user's coordinate.
post_url String It is the POST URL when an alert happens in user's location. (You need to give same POST URL for all of your users. By this way, we can send all users that has alerts to your URL at once.)
auth_token String It is for security. When our system POST nowcast alerts to your post_url, this value is sent as value of Authorization header parameter. If you don't want, just send blank ""
user_id String Unique id of the user in your system.
is_lightning Boolean It indicates that whether lightning alert will be send to this user or not.
is_polygon Boolean It indicates that whether storm polygon alert will be send to this user or not.
is_precipitation Boolean It indicates that whether precipitation alert will be send to this user or not.
{
  "message":"Created"
}

Swagger for nowcast

Explanation of alert POST body parameters:

This is explanation of a sample alert POST request to your API.

{
  "lightning": [
    {
      "user": "sample_user_id"
    },
    {
      "user": "sample_user_id"
    }
  ],
  "polygon": [
    {
      "user": "sample_user_id",
      "severity": "High"
    },

    {
      "user": "sample_user_id",
      "severity": "Medium"
    }
  ],
  "precipitation": [
    {
      "user": "sample_user_id",
      "direction": "north",
      "arrival_time": 23
    },
    {
      "user": "sample_user_id",
      "direction": "southeast",
      "arrival_time": 31
    }
  ]
}
Parameter Type Explanation
lightning JSON It includes users that lightning events are happening in their location.
user String Unique id of the user that lightning event has happened in the particular location.
polygon JSON It includes users that storm polygon events are happening in their location.
severity String Severity of the storm polygon. It can be "High", "Medium" or "Low".
precipitation JSON It includes users that precipitation events are happening in their location.
direction String Direction of the approaching precipitation. It can be "north", "south", "west", "east", "northeast", "northwest", "southeast", "southwest"
arrival_time Integer Approximate arrival time of the precipitation that is approaching to the user's location. Unit: Minute

Nowcast Delete

You can remove nowcast user from system.

Base URL http://world.tarla.in/v3/nowcast
Request Type DELETE
Request Heeader application/json
Response Type Instant response
{
 "post_url": "https://test.com/post",
 "post_user_id": "1"
}

Swagger for nowcast

Weather

Weather Daily

It returns 7-day forward weather data starting from current date.


Base URL http://world.tarla.in/v3/weather/daily
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/weather/daily?lat=39&lng=32

Swagger for weather daily

Explanation of response body parameters:

Successful response body

{
  "daily": [
    {
      "time": "2019-08-27",
      "icon": 1,
      "temperature_max": 30.64,
      "temperature_min": 16.64,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 36,
      "windspeed": 17.39,
      "winddirection": 0
    },
    .
    .
    .
]}
Parameter Type Explanation
time String Date in YYYY-MM-DD format. Ex: "2019-08-27"
humidity Integer Unit: Percentage %
precipitation Float Unit: Milimeter
precipitation_probability Integer Unit: Percentage %
temperature_max Float Maximum temperature for that day. Unit: Celcius
temperature_min Float Minimum temperature for that day. Unit: Celcius
winddirection Integer Direction of the wind 0-360 degree. Explanation is belove.
windspeed_max Float Maximum wind speed. Unit: km/h
icon Integer Weather icon number between 1-17.
1- Güneşli 2- Güneşli-Bulutlu 3- Parçalı Bulutlu 4- Kapalı 5- Sisli 6- Yağmurlu 7- Sağanak Yağışlı 8- Şimşekli-Yağmurlu 9- Karlı 10- Sağanak Karlı 11- Sulu kar 12- Yağmurlu 13- Hafif Karlı 14- Parçalı Yağmurlu 15- Rüzgarlı Karlı 16- Hafif Yağmurlu 17- Hafif Karlı

Explanation of winddirection parameter:

Winddirect

Weather Monthly

It returns 7-day forward and 14-day backward weather data starting from current date.


Base URL http://world.tarla.in/v3/weather/monthly
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/weather/monthly?lat=39&lng=32

Swagger for weather monthly

Explanation of response body parameters:

Successful response body

{
  "monthly": [
    {
      "time": "2019-08-13",
      "icon": 1,
      "temperature_max": 32.79,
      "temperature_min": 15.85,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 28,
      "windspeed": 20.16,
      "winddirection": 45
    },
    .
    .
    .
]}
Parameter Type Explanation
time String Date in YYYY-MM-DD format. Ex: "2019-08-27"
humidity Integer Unit: Percentage %
precipitation Float Unit: Milimeter
precipitation_probability Integer Unit: Percentage %
temperature_max Float Maximum temperature for that day. Unit: Celcius
temperature_min Float Minimum temperature for that day. Unit: Celcius
winddirection Integer Direction of the wind 0-360 degree. Explanation is belove.
windspeed_max Float Maximum wind speed. Unit: km/h
icon Integer Weather icon number between 1-17.
1- Güneşli 2- Güneşli-Bulutlu 3- Parçalı Bulutlu 4- Kapalı 5- Sisli 6- Yağmurlu 7- Sağanak Yağışlı 8- Şimşekli-Yağmurlu 9- Karlı 10- Sağanak Karlı 11- Sulu kar 12- Yağmurlu 13- Hafif Karlı 14- Parçalı Yağmurlu 15- Rüzgarlı Karlı 16- Hafif Yağmurlu 17- Hafif Karlı

Weather Current

This returns current weather.

Base URL http://world.tarla.in/v1/weather/current
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/weather/current?lat=39&lng=32

Swagger for weather current

Explanation of response body parameters:

Successful response body

{
  "current_weather": {
    "time": "2019-08-15 08:00",
    "icon": 2,
    "temperature": 30.41,
    "precipitation": 0.0,
    "precipitation_probability": 5,
    "humidity": 40,
    "windspeed": 11.92,
    "winddirection": 265
  }
}
Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
icon Integer Weather icon number between 1-35.
1-Güneşli,2-Açık Hava,3-Açık Hava,4-Az Bulutlu,5-Rüzgar ve Bulutlu,6-Rüzgar ve Bulutlu,7-Parçalı Bulutlu,8-Parçalı Bulutlu,9-Parçalı Bulutlu,10-Fırtına Bulutları,11-Fırtına Bulutları,12-Fırtına Bulutları,13-Puslu,14-Puslu,15-Puslu,16-Sisli,17-Sisli,18-Sisli,19-Çoğunlukla Bulutlu,20-Çoğunlukla Bulutlu,21-Çoğunlukla Bulutlu,22-Bulutlu,23-Yağmurlu,24-Kar Yağışı,25-Sağanak Yağmur,26-Sağanak Kar Yağışı,27-Fırtınalı Yağmur,28-Gök Gürültülü Fırtına,29-Fırtınalı Yağmur,30-Gök Gürültülü Yağmur,31-Sağanak Yağış,32-Sağanak Kar Yağışı,33-Yağmurlu,34-Kar Yağışı,35-Karla Karışık Yağmur
temperature Float Current temperature. Unit: Celcius
precipitation Float Unit: Milimeter
precipitation_probability Integer Unit: Percentage %
humidity Integer Unit: Percentage %
windspeed Float Maximum wind speed. Unit: km/h
winddirection Integer Direction of the wind 0-360 degree. Explanation is belove.

Explanation of winddirection parameter:

Winddirect

Weather Daily Hourly

This returns weather forecast in daily and hourly format. 7-day daily and 7-day hourly forecast data will be returned.

Base URL http://world.tarla.in/v3/weather
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/weather?lat=39&lng=32

Swagger for weather daily hourly

Explanation of response body parameters:

Successful response body

{
  "daily": [
    {
      "time": "2019-08-19",
      "icon": 2,
      "temperature_max": 25.17,
      "temperature_min": 13.37,
      "precipitation": 0.0,
      "precipitation_probability": 8,
      "humidity": 60,
      "windspeed": 17.46,
      "winddirection": 45
    },
    {
      "time": "2019-08-20",
      "icon": 8,
      "temperature_max": 25.31,
      "temperature_min": 14.82,
      "precipitation": 1.23,
      "precipitation_probability": 34,
      "humidity": 65,
      "windspeed": 18.72,
      "winddirection": 0
    },
    {
      "time": "2019-08-21",
      "icon": 8,
      "temperature_max": 25.93,
      "temperature_min": 14.64,
      "precipitation": 1.2,
      "precipitation_probability": 29,
      "humidity": 66,
      "windspeed": 23.33,
      "winddirection": 315
    },
    {
      "time": "2019-08-22",
      "icon": 1,
      "temperature_max": 27.83,
      "temperature_min": 15.74,
      "precipitation": 0.0,
      "precipitation_probability": 10,
      "humidity": 66,
      "windspeed": 17.78,
      "winddirection": 270
    },
    {
      "time": "2019-08-23",
      "icon": 1,
      "temperature_max": 29.88,
      "temperature_min": 15.75,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 58,
      "windspeed": 15.7,
      "winddirection": 0
    },
    {
      "time": "2019-08-24",
      "icon": 1,
      "temperature_max": 30.97,
      "temperature_min": 16.74,
      "precipitation": 0.0,
      "precipitation_probability": 5,
      "humidity": 47,
      "windspeed": 23.15,
      "winddirection": 45
    },
    {
      "time": "2019-08-25",
      "icon": 1,
      "temperature_max": 30.99,
      "temperature_min": 16.62,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 47,
      "windspeed": 19.33,
      "winddirection": 45
    }
  ],
  "hourly": [
    {
      "time": "2019-08-19 00:00",
      "icon": 13,
      "temperature": 14.99,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 75,
      "windspeed": 13.18,
      "winddirection": 15
    },
    {
      "time": "2019-08-19 01:00",
      "icon": 1,
      "temperature": 14.39,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 77,
      "windspeed": 10.62,
      "winddirection": 9
    },
    {
      "time": "2019-08-19 02:00",
      "icon": 13,
      "temperature": 14.04,
      "precipitation": 0.0,
      "precipitation_probability": 0,
      "humidity": 80,
      "windspeed": 8.89,
      "winddirection": 5
    },
    .
    .
    .
  ]
}
Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
icon(Daily) Integer Weather icon number between 1-17.
1- Güneşli 2- Güneşli-Bulutlu 3- Parçalı Bulutlu 4- Kapalı 5- Sisli 6- Yağmurlu 7- Sağanak Yağışlı 8- Şimşekli-Yağmurlu 9- Karlı 10- Sağanak Karlı 11- Sulu kar 12- Yağmurlu 13- Hafif Karlı 14- Parçalı Yağmurlu 15- Rüzgarlı Karlı 16- Hafif Yağmurlu 17- Hafif Karlı
icon(Hourly) Integer Weather icon number between 1-35.
1-Güneşli,2-Açık Hava,3-Açık Hava,4-Az Bulutlu,5-Rüzgar ve Bulutlu,6-Rüzgar ve Bulutlu,7-Parçalı Bulutlu,8-Parçalı Bulutlu,9-Parçalı Bulutlu,10-Fırtına Bulutları,11-Fırtına Bulutları,12-Fırtına Bulutları,13-Puslu,14-Puslu,15-Puslu,16-Sisli,17-Sisli,18-Sisli,19-Çoğunlukla Bulutlu,20-Çoğunlukla Bulutlu,21-Çoğunlukla Bulutlu,22-Bulutlu,23-Yağmurlu,24-Kar Yağışı,25-Sağanak Yağmur,26-Sağanak Kar Yağışı,27-Fırtınalı Yağmur,28-Gök Gürültülü Fırtına,29-Fırtınalı Yağmur,30-Gök Gürültülü Yağmur,31-Sağanak Yağış,32-Sağanak Kar Yağışı,33-Yağmurlu,34-Kar Yağışı,35-Karla Karışık Yağmur
temperature Float Current temperature. Unit: Celcius
precipitation Float Unit: Milimeter
precipitation_probability Integer Unit: Percentage %
humidity Integer Unit: Percentage %
windspeed Float Maximum wind speed. Unit: km/h
winddirection Integer Direction of the wind 0-360 degree. Explanation is belove.

Explanation of wind direction parameter:

Winddirect

Market Pricing

You can learn current market prices with this routes. You can get market names, plant names and last prices.

Markets: Returns all markets with name id and types.

Plants: Returns all plants with id.

Markets Prices: Returns all plant prices on specific market if you give nothing as a query parameter. It returns specific plant prices in all markets if you give plant_id as a parameter. It returns all plant prices in a specific market if you give market_id as query parameter. It returns all prices in a borsa or hal if you give market_type as a query parameter. market_type can be 'B' for borsa and 'H' for hal. You can give combination of these three query parameters plant_id,market_id,market_type, for example you can give just plant_id and market_id to get price of a plant in a specific market. Or you can give plant_id or market_type to get price of a plant in all borsa markets.

Markets Prices Others: Returns price of et, süt, yumurta, yem or price of all of them at once. If you give product_name parameter one of the followings et,sut,yumurta or yem, it returns just price of these products. If you do not send product_name parameter, it returns price of all of them.

Base URL(markets) http://world.tarla.in/v1/markets
Base URL(plants) http://world.tarla.in/v1/markets/plants
Base URL(markets prices) http://world.tarla.in/v1/markets/prices
Base URL(markets prices others) http://world.tarla.in/v1/markets/prices/others
Request Type GET
Response Type Instant response
Sample Request(markets) http://world.tarla.in/v1/markets
Sample Request(plants) http://world.tarla.in/v1/markets/plants
Sample Request(markets prices -market-) http://world.tarla.in/v1/markets/prices?market_id=10
Sample Request(markets prices -plant-) http://world.tarla.in/v1/markets/prices?plant_id=10
Sample Request(markets prices -type-) http://world.tarla.in/v1/markets/prices?market_type=B
Sample Request(markets prices -all-) http://world.tarla.in/v1/markets/prices
Sample Request(markets prices others) http://world.tarla.in/v1/markets/prices/others?product_name=et

Swagger for Markets
Swagger for Markets Plants
Swagger for Markets Prices
Swagger for Markets Prices Others

Markets - Explanation of response body parameters:

Successful response body

{
  "markets": [
    {
      "id": 1,
      "market_name": "Adana Hal",
      "market_type": "H"
    },
    {
      "id": 2,
      "market_name": "Adana Ticaret Borsası",
      "market_type": "B"
    },
    .
    .
    .
Parameter Type Explanation
id Integer Id of the market.
market_name String Market name.
market_type String Type of the market. 'H' for hal, 'B' for borsa, 'K' for konsey or kooperatif.

Markets Plants - Explanation of response body parameters:

Successful response body

{
  "plants": [
    {
      "id": 1,
      "plant_name": "Greyfurt"
    },
    {
      "id": 2,
      "plant_name": "Antep Fıs.K.Kab.II.K"
    },
    .
    .
    .
Parameter Type Explanation
id Integer Id of the plant.
plant_name String Plant name.

Markets Prices - Explanation of response body parameters:

Successful response body

{
  "prices": [
    {
      "plant_id": 7,
      "plant_name": "Armut Deveci",
      "unit": "kg",
      "min_price": 5.0,
      "max_price": 6.0,
      "market_id": 10,
      "market_type": "H",
      "market_name": "Aydın Efeler Hal",
      "last_update": "2019-12-03"
    },
    {
      "plant_id": 24,
      "plant_name": "Biber Çarliston",
      "unit": "kg",
      "min_price": 1.5,
      "max_price": 2.0,
      "market_id": 10,
      "market_type": "H",
      "market_name": "Aydın Efeler Hal",
      "last_update": "2019-12-03"
    },
    .
    .
    .
Parameter Type Explanation
plant_id Integer Id of the plant.
plant_name String Plant name.
unit String Unit of the plant. It can be 'kg','adet','demet','koli','çuval','kasa' etc.
min_price Float Minimum price of the plant in given market.
max_price Float Maximum price of the plant in given market.
market_id Integer Id of the market.
market_type String Type of the market. Indicates if market is 'hal' or 'borsa'. 'H' for hal, 'B' for borsa, 'K' for konsey.
market_name String Market name.
last_update String Date of the given price in 'YYYY-MM-DD' date format.

Geocoding

You can get detailed address of the given latitude and longitude or you can get latitude and longitude of a given string address.

Search: Returns address of latitude and longitude

Reverse: Returns latitude and longitude of the given string address.

Base URL(search) http://world.tarla.in/v1/geocoding/search
Base URL(reverse) http://world.tarla.in/v1/geocoding/reverse
Request Type GET
Response Type Instant response
Sample Request(search) http://world.tarla.in/v1/geocoding/search?q=bilkent,ankara&format=json&addressdetails=1&limit=5
Sample Request(reverse) http://world.tarla.in/v1/geocoding/reverse?lat=39&lon=32&format=json&addressdetails=1&extratags=1&namedetails=1&accept-language=tr&zoom=18

Swagger for geocoding(search)

Swagger for geocoding(reverse)

Explanation of geocoding search parameters:

Parameter Type Explanation
q String Place name. If words are seperated by comma, it works better.
format String These are the format types. xml,json,jsonv2,geojson,geocodejson. Only json works.
addressdetails Integer Level of address detail.
limit Integer How many addresses will come up after request.
namedetails Integer LEvel of name details.
extratags Integer Existence of detailed tag is indicated here.
accept-language String It is recommended that this parameter should not be used.
countrycodes String Only tr is available.

Notes 1: Only one type of polygon parameter should be sent, otherwise it returns error.
polygon_geojson=1
polygon_kml=1
polygon_svg=1
polygon_text=1

Notes 2: q is an optional parameter. Indeed request can be done with parameters below. Both q and parameters below should not be sent. Request can be done with q or parameters below. Request is done with parameters below returns faster.

street=
city=
county=
state=
country=
postalcode=

Explanation of geocoding reverse parameters:

Parameter Type Explanation
lat Float Latitude of the place.
lon Float Longitude of the place.
format String These are format types. xml,json,jsonv2,geojson,geocodejson. Only json is working now.
addressdetails Integer Level of address detail.
namedetails Integer Level of name details.
extratags Integer If there is detailed tag or is not indicated here.
accept-language String It is recommended to not to use this parameter.
zoom Integer Detail level of the address. Default is 18. 3: country, 5: state, 8: country, 10: city, 14: suburb, 16: major streets, 17: major and minor streets, 18: building

Notes: Only one type of polygon parameter should be sent, otherwise it returns error.
polygon_geojson=1
polygon_kml=1
polygon_svg=1
polygon_text=1

Geocoding Search - Explanation of response body parameters:

Successful response body

{
  "data": [
    {
      "place_id": 171914,
      "boundingbox": [
        "39.861951",
        "39.901951",
        "32.7384164",
        "32.7784164"
      ],
      "display_name": "Bilkent, Ankara, Çankaya, Ankara, İç Anadolu Bölgesi, 06800, Türkiye",
      "class": "place",
      "type": "suburb",
      "importance": 0.45,
      "icon": "/images/mapicons/poi_place_village.p.20.png",
      "address": {
        "suburb": "Bilkent",
        "city": "Ankara",
        "county": "Çankaya",
        "state": "İç Anadolu Bölgesi",
        "postcode": "06800",
        "country": "Türkiye",
        "country_code": "tr"
      },
      "lat": "39.881951",
      "lng": "32.7584164"
    },
    {
      "place_id": 177321,
      "boundingbox": [
        "39.9025884",
        "39.9125884",
        "32.7608293",
        "32.7708293"
      ],
      "display_name": "Bilkent, Dumlupınar Bulvarı, Ümit Mahallesi, Çankaya, Ankara, İç Anadolu Bölgesi, 06531, Türkiye",
      "class": "railway",
      "type": "station",
      "importance": 0.201,
      "icon": "/images/mapicons/transport_train_station2.p.20.png",
      "address": {
        "station": "Bilkent",
        "road": "Dumlupınar Bulvarı",
        "suburb": "Ümit Mahallesi",
        "county": "Çankaya",
        "state": "İç Anadolu Bölgesi",
        "postcode": "06531",
        "country": "Türkiye",
        "country_code": "tr"
      },
      "lat": "39.9075884",
      "lng": "32.7658293"
    }
  ]
}
Parameter Type Explanation
data List JSON List of possible addresses.
place_id Integer Id of the place.
boundingbox List Bounding box of given location.
display_name String Detailed string address of given location.
class String Class of the place.
type String Type of the place.
importance String Importance of the place.
address JSON Address components of given location.
lat String Latitude of the place.
lng String Longitude of the place.

Geocoding Reverse - Explanation of response body parameters:

Successful response body

{
  "data": {
    "place_id": 828626,
    "lat": "39.8782733184137",
    "lon": "32.7477620358817",
    "display_name": "Bilkent, Üniversiteler Mahallesi, Çankaya, Ankara, İç Anadolu Bölgesi, 06800, Türkiye",
    "address": {
      "suburb": "Bilkent",
      "city": "Üniversiteler Mahallesi",
      "county": "Çankaya",
      "state": "İç Anadolu Bölgesi",
      "postcode": "06800",
      "country": "Türkiye",
      "country_code": "tr"
    },
    "extratags": {},
    "namedetails": {},
    "boundingbox": [
      "39.8749718",
      "39.8787484",
      "32.7467019",
      "32.7483024"
    ]
  }
}
Parameter Type Explanation
data List JSON List of possible addresses.
place_id Integer Id of the place.
lat String Latitude of the place.
lng String Longitude of the place.
address JSON Address components of given location.
extratags JSON If extra tags of the location exist, it will be shown here.
namedetails JSON Some details about location will be shown here.
boundingbox List Bounding box of given location.

Ada-Parsel

You can get polygon wkt shape string of your place by giving ada, parsel and place_id.

Location List: Returns place id of the il, ilçe and mahalle locations.

Shapefile:: Returns polygon wkt string or geojson of given ada,parsel location.

Base URL(Location List) http://world.tarla.in/v1/location/list
Base URL(Shapefile) http://world.tarla.in/v1/location/shape
Request Type GET
Response Type Instant response
Sample Request(Location List) http://world.tarla.in/v1/location/list?place_id=1
Sample Request(Shapefile) http://world.tarla.in/v1/location/shape?place_id=10048&ada=2652&parsel=1

Swagger for geocoding(Location List)

Swagger for geocoding(Shapefile)

Location List

Returns place_id of il, ilce and mahalle.

Explanation location list parameters:

Parameter Type Explanation
place_id Integer It is optional. If you do not send this parameter, place id of all ils are returned. If you give this parameter, place id of all child places of given place_id are returned.

Successful response body

{
  "location_list": [
    {
      "name": "Aladağ",
      "place_id": 104
    },
    {
      "name": "Ceyhan",
      "place_id": 105
    },
    {
      "name": "Çukurova",
      "place_id": 6113
    },
    .
    .
    .

Shapefile

Returns polygon wkt string or geojson of given ada parsel.

Explanation location list parameters:

Parameter Type Explanation
place_id Integer Place if of wanted place. It can be found by "location list" request.
ada Integer Ada no of wanted place.
parsel Integer Parsel no of wanted place.
format String This is optional parameter. If it is given as "wkt", return format will be wkt string. If you do not send this parameter return format is defaultly geojson.

Successful response body (WKT string)

{
  "polygon_wkt": "POLYGON ((29.0844 40.99241, 29.08438 40.99244, 29.08435 40.99274, 29.08459 40.9928, 29.08472 40.99284, 29.08495 40.99295, 29.08513 40.99304, 29.08544 40.99324, 29.08555 40.9933, 29.08558 40.99331, 29.08563 40.99333, 29.08573 40.99336, 29.08609 40.99344, 29.08641 40.99351, 29.08657 40.99354, 29.08653 40.99305, 29.08655 40.99303, 29.08722 40.99302, 29.08725 40.99302, 29.08718 40.99291, 29.08639 40.99247, 29.08559 40.99245, 29.08537 40.99244, 29.0844 40.99241))"
}

Successful response body (Geojson)

{
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          29.0844,
          40.99241
        ],
        [
          29.08438,
          40.99244
        ],
        [
          29.08435,
          40.99274
        ],
        [
          29.08459,
          40.9928
        ],
        [
          29.08472,
          40.99284
        ],
        [
          29.08495,
          40.99295
        ],
        [
          29.08513,
          40.99304
        ],
        [
          29.08544,
          40.99324
        ],
        [
          29.08555,
          40.9933
        ],
        [
          29.08558,
          40.99331
        ],
        [
          29.08563,
          40.99333
        ],
        [
          29.08573,
          40.99336
        ],
        [
          29.08609,
          40.99344
        ],
        [
          29.08641,
          40.99351
        ],
        [
          29.08657,
          40.99354
        ],
        [
          29.08653,
          40.99305
        ],
        [
          29.08655,
          40.99303
        ],
        [
          29.08722,
          40.99302
        ],
        [
          29.08725,
          40.99302
        ],
        [
          29.08718,
          40.99291
        ],
        [
          29.08639,
          40.99247
        ],
        [
          29.08559,
          40.99245
        ],
        [
          29.08537,
          40.99244
        ],
        [
          29.0844,
          40.99241
        ]
      ]
    ]
  },
  "properties": {}
}

Satellites

You can get satellite images directly or get filter values like NDVI, SWIR, BAI, NDWI, SMAP, TRUE_COLOR and detect alarrms such as FIRE, HARVEST and FLOOD.

Base URL http://world.tarla.in/v1/satellites
Request Type POST
Response Type Instant response
Sample Request http://world.tarla.in/v1/satellites

Swagger for satellites

Request JSON body parameter explanations for products endpoint

{
    "name": "test",
    "start": "2019-06-26",
    "end": "2019-06-28",
    "format": "png",
    "products": [
        "ndvi"
    ],
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    40.0682,
                    37.0517
                ],
                [
                    40.0722,
                    37.0365
                ],
                [
                    40.1144,
                    37.0463
                ],
                [
                    40.1079,
                    37.0612
                ],
                [
                    40.0682,
                    37.0517
                ]
            ]
        ]
    }
}
Parameter Type Explanation
name String Name of the request given by you.
start String Date that the satellite data start from.
end String Date that the satellite data to finish. The time interval between start and finish dates can be maximum 30 days.
format String Format can be png or json.
products String Products can be one of true_color, ndvi, ndwi, smap, swir, bai.
geometry Object Geojson object of the field you want.

Response JSON body if format is png

Successful response body

{
    "ndvi": [
        {
            "date": "20/11/2019",
            "image": "https://storage.googleapis.com/sentinel-hub/e6dd93b2-362a-4d87-8697-36c4d7e139c1/2019_12_15_ndvi.png",
            "event": 1,
            "analytics": {
                "min": "-0.02189781",
                "avg": "0.09733261",
                "max": "0.23469388"
            }
        }
    ],
    "alarms": {
        "drought": [
            {
                "pdsi": 3
            }
        ],
        "max_temperature": [],
        "windspeed": [
            {
                "date": "17/11/2019",
                "event": 1
            },
            {
                "date": "26/11/2019",
                "event": 1
            },
            {
                "date": "27/11/2019",
                "event": 1
            },
            {
                "date": "02/12/2019",
                "event": 1
            },
            {
                "date": "09/12/2019",
                "event": 1
            },
            {
                "date": "12/12/2019",
                "event": 1
            },
            {
                "date": "14/12/2019",
                "event": 1
            }
        ],
        "min_temperature": [],
        "precipitation": [],
        "storm": [],
        "hail": [
            {
                "date": "02/12/2019",
                "event": 1
            }
        ]
    },
    "id": "e6dd93b2-362a-4d87-8697-36c4d7e139c1"
}

-> All filter types are returned with this request.

Parameter Type Explanation
date String Date of the satellite image that is returned.
image String Image url of the satellite image that is returned.
event Integer Index of severity for the alarm/filter returned.
analytics JSON Analytics of the filter/alarm returned.
min Float Minimum analytics of the filter/alarm returned.
avg Float Average analytics of the filter/alarm returned.
max Float Maximum analytics of the filter/alarm returned.
alarms JSON Weather alarms of the area requested.
drought JSON Drought information of the area requested.
pdsi Float Palmer drought index. Between -6 and 6.
max_temperature JSON Maximum temperature information of the area requested.
windspeed JSON Wind speed information of the area requested.
min_temperature JSON Minimum temperature information of the area requested.
precipitation JSON Precipitation information of the area requested.
storm JSON Storm information of the area requested.
hail JSON Hail information of the area requested.
id String Id of the request.

Response JSON body if format is json

Successful response body

{
    "ndvi": [
        {
            "date": "20/11/2019",
            "value": 0.09733261168003082
        },
        {
            "date": "15/12/2019",
            "value": 0.08450356125831604
        }
    ],
    "alarms": {
        "drought": [
            {
                "pdsi": 3
            }
        ],
        "max_temperature": [],
        "windspeed": [
            {
                "date": "17/11/2019",
                "event": 1
            },
            {
                "date": "26/11/2019",
                "event": 1
            },
            {
                "date": "27/11/2019",
                "event": 1
            },
            {
                "date": "02/12/2019",
                "event": 1
            },
            {
                "date": "09/12/2019",
                "event": 1
            },
            {
                "date": "12/12/2019",
                "event": 1
            },
            {
                "date": "14/12/2019",
                "event": 1
            }
        ],
        "min_temperature": [],
        "precipitation": [],
        "storm": [],
        "hail": [
            {
                "date": "02/12/2019",
                "event": 1
            }
        ]
    },
    "id": "12a63884-16ae-4355-9c00-e1227a17b30e"
}

-> All filter types are returned with this request.

Parameter Type Explanation
date String Date of the satellite image that is returned.
value Float Float filter value for the image. It is between 0-1.
alarms JSON Weather alarms of the area requested.
drought JSON Drought information of the area requested.
pdsi Float Palmer drought index. Between -6 and 6.
max_temperature JSON Maximum temperature information of the area requested.
windspeed JSON Wind speed information of the area requested.
min_temperature JSON Minimum temperature information of the area requested.
precipitation JSON Precipitation information of the area requested.
storm JSON Storm information of the area requested.
hail JSON Hail information of the area requested.
id String Id of the request.

Request JSON body parameter explanations for analysis endpoint

{
    "name": "test",
    "start": "2019-06-26",
    "end": "2019-06-28",
    "format": "png",
    "analysis": [
        "fire"
    ],
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    40.0682,
                    37.0517
                ],
                [
                    40.0722,
                    37.0365
                ],
                [
                    40.1144,
                    37.0463
                ],
                [
                    40.1079,
                    37.0612
                ],
                [
                    40.0682,
                    37.0517
                ]
            ]
        ]
    }
}
Parameter Type Explanation
name String Name of the request given by you.
start String Date that the satellite data start from.
end String Date that the satellite data to finish. The time interval between start and finish dates can be maximum 30 days.
format String Format can be png or json.
analisys String Analysis can be one of fire, flood, harvest and all. All returns all analysis at the same time.
geometry Object Geojson object of the field you want.

Response JSON body if format is png

Successful response body

{
    "ndvi": [
        {
            "date": "15/12/2019",
            "image": "https://storage.googleapis.com/sentinel-hub/433d0bb2-a63d-4283-8f66-89e7ddefca38/2019_12_15_ndvi.png",
            "event": 1,
            "analytics": {
                "min": "0.00790798",
                "avg": "0.08450356",
                "max": "0.24410823"
            }
        }
    ],
    "true-color-s2-l1c": [
        {
            "date": "15/12/2019",
            "image": "https://storage.googleapis.com/sentinel-hub/433d0bb2-a63d-4283-8f66-89e7ddefca38/2019_12_15_true-color-s2-l1c.png",
            "event": 1,
            "analytics": {
                "min": "0.199",
                "avg": "0.29410452",
                "max": "0.5775"
            }
        }
    ],
    "fire_mask": [
        {
            "date": "15/12/2019",
            "image": "https://storage.googleapis.com/sentinel-hub/433d0bb2-a63d-4283-8f66-89e7ddefca38/2019_12_15_fire_mask.png",
            "event": 23.984654247760773,
            "analytics": null
        }
    ],
    "alarms": {
        "drought": [
            {
                "pdsi": 3
            }
        ],
        "max_temperature": [],
        "windspeed": [
            {
                "date": "17/11/2019",
                "event": 1
            },
            {
                "date": "26/11/2019",
                "event": 1
            },
            {
                "date": "27/11/2019",
                "event": 1
            },
            {
                "date": "02/12/2019",
                "event": 1
            },
            {
                "date": "09/12/2019",
                "event": 1
            },
            {
                "date": "12/12/2019",
                "event": 1
            },
            {
                "date": "14/12/2019",
                "event": 1
            }
        ],
        "min_temperature": [],
        "precipitation": [],
        "storm": [],
        "hail": [
            {
                "date": "02/12/2019",
                "event": 1
            }
        ]
    },
    "id": "433d0bb2-a63d-4283-8f66-89e7ddefca38"
}

-> All filter types are returned with this request.

Parameter Type Explanation
date String Date of the satellite image that is returned.
image String Image url of the satellite image that is returned.
event Integer Index of severity for the alarm/filter returned.
analytics JSON Analytics of the filter/alarm returned.
min Float Minimum analytics of the filter/alarm returned.
avg Float Average analytics of the filter/alarm returned.
max Float Maximum analytics of the filter/alarm returned.
alarms JSON Weather alarms of the area requested.
drought JSON Drought information of the area requested.
pdsi Float Palmer drought index. Between -6 and 6.
max_temperature JSON Maximum temperature information of the area requested.
windspeed JSON Wind speed information of the area requested.
min_temperature JSON Minimum temperature information of the area requested.
precipitation JSON Precipitation information of the area requested.
storm JSON Storm information of the area requested.
hail JSON Hail information of the area requested.
id String Id of the request.

Response JSON body if format is json

Successful response body

{
    "ndvi": [
        {
            "date": "20/11/2019",
            "value": 0.09733261168003082
        },
        {
            "date": "15/12/2019",
            "value": 0.08450356125831604
        }
    ],
    "true-color-s2-l1c": [
        {
            "date": "20/11/2019",
            "value": 0.38531938195228577
        },
        {
            "date": "15/12/2019",
            "value": 0.29410451650619507
        }
    ],
    "fire_mask": [
        {
            "date": "20/11/2019",
            "value": 0.5330360531806946
        },
        {
            "date": "15/12/2019",
            "value": 0.15987913310527802
        }
    ],
    "alarms": {
        "drought": [
            {
                "pdsi": 3
            }
        ],
        "max_temperature": [],
        "windspeed": [
            {
                "date": "17/11/2019",
                "event": 1
            },
            {
                "date": "26/11/2019",
                "event": 1
            },
            {
                "date": "27/11/2019",
                "event": 1
            },
            {
                "date": "02/12/2019",
                "event": 1
            },
            {
                "date": "09/12/2019",
                "event": 1
            },
            {
                "date": "12/12/2019",
                "event": 1
            },
            {
                "date": "14/12/2019",
                "event": 1
            }
        ],
        "min_temperature": [],
        "precipitation": [],
        "storm": [],
        "hail": [
            {
                "date": "02/12/2019",
                "event": 1
            }
        ]
    },
    "id": "8a00a8d9-6b10-4d1b-b34f-88320581301e"
}

-> All filter types are returned with this request.

Parameter Type Explanation
date String Date of the satellite image that is returned.
value Float Float filter value for the image. It is between 0-1.
alarms JSON Weather alarms of the area requested.
drought JSON Drought information of the area requested.
pdsi Float Palmer drought index. Between -6 and 6.
max_temperature JSON Maximum temperature information of the area requested.
windspeed JSON Wind speed information of the area requested.
min_temperature JSON Minimum temperature information of the area requested.
precipitation JSON Precipitation information of the area requested.
storm JSON Storm information of the area requested.
hail JSON Hail information of the area requested.
id String Id of the request.

Accumulations

This returns accumulation data like GDD, DSV, precipitation, convective_precipitation, precipitation_hours, evapotranspiration, potentialevapotranspiration, referenceevapotranspiration_fao. You get these data within the given time interval.


Base URL http://world.tarla.in/v1/accumulations
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/accumulations?lat=39&lng=32&begin=2019-01-01&end=2019-03-01&accumulation_type=precipitation
Parameter Type Explanation
lat Float Latitude.
lng Float Longitude.
begin Date Date that the accumulations start from. In YYYY-MM-DD format.
end Date Date that the accumulations end. In YYYY-MM-DD format.
accumulation_type String Accumulation type that is requested to return.
Options are: gdd_0, gdd_10,gdd_11,gdd_55, gdd_67, gdd_133, dsv_50, dsv_60,dsv_70, dsv_80, dsv_90, precipitation, convective_precipitation, precipitation_hours, evapotranspiration,potentialevapotranspiration, referenceevapotranspiration_fao

Swagger for accumulations

Explanation of response body parameters:

Successful response body

{
  "accumulations": [
    {
      "time": "2019-01-01",
      "precipitation": 0.0
    },
    {
      "time": "2019-01-02",
      "precipitation": 1.8199999999999932
    },
    .
    .
    .
    ]
}
Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
gdd_0 Float GDD value. In formula subtraction value is 0
gdd_10 Float GDD value. In formula subtraction value is 10
gdd_11 Float GDD value. In formula subtraction value is 1.1
gdd_55 Float GDD value. In formula subtraction value is 5.5
gdd_67 Float GDD value. In formula subtraction value is 6.7
gdd_133 Float GDD value. In formula subtraction value is 13.3
dsv_50 Integer DSV value for 50 percentage.
dsv_60 Integer DSV value for 60 percentage.
dsv_70 Integer DSV value for 70 percentage.
dsv_80 Integer DSV value for 80 percentage.
dsv_90 Integer DSV value for 90 percentage.
precipitation Float Precipitation for given date.
convective_precipitation Float Convective precipitation for given date.
precipitation_hours Integer The duration (in hours) of the rain is given here.
evapotranspiration Float Evapotranspiration value.
potentialevapotranspiration Float Potential evapotranspiration value.
referenceevapotranspiration_fao Float Reference Evapotranspiration value determined by FAO.

Spraying

This returns if location is suitable or not for spraying.


Base URL http://world.tarla.in/v1/spraying
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/spraying?lat=39&lng=32

Swagger for spraying

Explanation of response body parameters:

Successful response body

{
  "data": [
    {
      "time": "2019-08-21 01:00",
      "explanation": "Hava nemi, yağış miktarı ve rüzgar hızı açısından uygun değildir."
    },
    {
      "time": "2019-08-21 02:00",
      "explanation": "İlaçlama için uygundur."
    },
    {
      "time": "2019-08-17 22:00",
      "explanation": "Hava nemi, yağış miktarı ve rüzgar hızı açısından kesinlikle uygun değildir."
    },
    .
    .
    .
    ]
}
Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
explanation String Explanation whether spraying is suitable or not for a given time.

Lightnings

This returns lightning data between a time interval in a location specified by radius.


Base URL http://world.tarla.in/v3/lightning
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/lightnings?lat=39&lng=32&begin=2019-08-14 00:00:00&end=2019-08-15 00:00:00&radius=20
Parameter Type Explanation
lat Float Latitude.
lng Float Longitude.
begin Timestamp Date that the lightnings data start from. In YYYY-MM-DD HH:MM:SS format.
end Timestamp Date that the lightnings data end. In YYYY-MM-DD HH:MM:SS format.
radius Integer Radius of the area that you want. Max value is 50. Unit: km

Swagger for lightnings

Explanation of response body parameters:

Successful response body

{
  "data": [
    {
      "time": "2019-08-14 05:08:30",
      "type": 1,
      "lat": 39.1627,
      "lng": 31.9991,
      "current": -7492,
      "height": 18939,
      "distance": 18.08
    },
    {
      "time": "2019-08-14 05:08:48",
      "type": 1,
      "lat": 39.1655,
      "lng": 32.029,
      "current": -3041,
      "height": 15171,
      "distance": 18.56
    },
    .
    .
    .
    ]
}
Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
type Integer Indicates if it is IC(inter cloud) or CG(cloud to ground). 1 is IC, 0 is CG.
lat Float Latitude.
lng Float Longitude.
current Integer Current of the lightning.
height Integer Indicates the altitude of the lightning. Unit: meter
distance Float Indicates the distance that lightning has happened from the central point. Unit: km

Lightnings Show

This returns lightning data that is happened in last 5 minutes.


Base URL http://world.tarla.in/v3/lightnings/show
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/lightnings/show

Explanation of response body parameters:

Successful response body

{
  "data": [
    {
      "time": "2019-08-14 05:08:30",
      "type": 1,
      "lat": 39.1627,
      "lng": 31.9991,
      "current": -7492,
      "height": 18939
    },
    {
      "time": "2019-08-14 05:08:48",
      "type": 1,
      "lat": 39.1655,
      "lng": 32.029,
      "current": -3041,
      "height": 15171
    },
    .
    .
    .
    ]
}

Parameter Type Explanation
time Timestamp Date with hour of current in UTC.
type Integer Indicates if it is IC(inter cloud) or CG(cloud to ground). 1 is IC, 0 is CG.
lat Float Latitude.
lng Float Longitude.
current Integer Current of the lightning.
height Integer Indicates the altitude of the lightning. Unit: meter

Polygons

This returns severe weather polygon data. Polygon data indicates that severe weather event occurs within the polygon area. It returns all polygons whose expiration time is bigger than (current_time - 5 min). There is three severity indications, which are low, medium and high.

ATTENTION: All the polygons that are returned are not unique. Since, a polygon moves it may appear multiple times in the data. They can separated by checking the "identifier" column.


Base URL http://world.tarla.in/v3/polygons
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v3/polygons

Swagger for polygons

Explanation of response body parameters:

Successful response body

{
  "data": [
    {
      "creation_time": "2018-05-10 13:37:06.760370",
      "identifier": "EU201805081642001",
      "severity": "Unknown",
      "expire_time": "2018-05-10 13:44:00.000000",
      "effective_time": "2018-05-10 12:59:00.000000",
      "lightning_severity": "Medium",
      "direction": 245,
      "speed": 14,
      "cell_polygon_wkt": "LINESTRING(31.047419598 39.2413662488,31.0632085738 39.2246609616,31.1432085738 39.2105374453,31.1540373773 39.2213662488,31.1628544875 39.2413662488,31.1505311356 39.2613662488,31.1432085738 39.2686888106,31.1232085738 39.2853916918,31.1032085738 39.2960047652,31.0432085738 39.3127254792,31.0311728992 39.3013662488,31.0232085738 39.2938198225,31.0114201668 39.2813662488,31.047419598 39.2413662488)",
      "polygon_wkt": "LINESTRING(31.0548081812 39.2076376696,31.2583385877 39.2453120677,31.2132490447 39.3831054932,31.0268183031 39.2931746016,31.0548081812 39.2076376696)"
    },
    .
    .
    .
    ]
}
Parameter Type Explanation
creation_time Timestamp Indicates that when this polygon is created in UTC.
identifier String Unique id of the polygon.
severity String Depreciated severity of the polygon.
expire_time Timestamp Indicates the time when polygon effectiveness will disappear.
effective_time Timestamp Indicates the time when polygon starts to show its effect.
lightning_severity String Severity of the polygon. Options: Low, Medium, High.
direction Integer Direction of the polygon in degree.
speed Integer Speed of the polygon in km/h.
cell_polygon_wkt String Cell polygon is core of the polygon. This is WKT string of the cell area.
polygon_wkt String This is WKT string of the polygon. Polygons have 4 edges most of the time.

Lightning Analysis

This returns number of lightnings and severe weather polygons in given area with dates.

Base URL http://world.tarla.in/v1/lightnings_polygons/analysis
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/lightnings_polygons/analysis?lat=40.298754&lng=28.360458&start_date=2019-08-15&end_date=2019-09-1&radius=10
Parameter Type Explanation
lat Float Latitude.
lng Float Longitude.
start_date Date Date that the lightnings start from. In YYYY-MM-DD format.
end_date Date Date that the lightnings end. In YYYY-MM-DD format.
radius String It is optional default is 10. Indicates the area, system draws a circle with this much radius and returns number of lightnings and polygons in this drawn circle.

Swagger for lightning analysis

Explanation of response body parameters:

Successful response body

{
  "entln": [
    {
      "date": "2019-08-14",
      "type0": 10,
      "type1": 21,
      "ratio": 0.4762
    },
    {
      "date": "2019-08-15",
      "type0": 0,
      "type1": 1,
      "ratio": 0.0
    },
    {
      "date": "2019-08-17",
      "type0": 136,
      "type1": 294,
      "ratio": 0.4626
    }
  ],
  "dta": [
    {
      "date": "2019-08-17",
      "count": 3
    }
  ]
}
Parameter Type Explanation
date String Indicates that when this lightning or polygon is created in UTC.
type0 Integer Number of CG lightning count. CG means Cloud-to-ground.
type1 Integer Number of IC lightning count. IC means inter-cloud.
ratio Float Ratio between type0 and type1. CG/ IC.
dta - count Integer Threat polygon count.

Radar Score

This returns radar scores for given area in given dates. Scores that are less than 1 means no precipitation. Scores that are more than 10 means heavy raining. If scores goes above 10 in 2-3 hours then it means a flood potential. Generally scores are between 0-45.

Base URL http://world.tarla.in/v1/radar/index
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/radar/index?lat=36.895855&lng=30.714666&start_date=2019-11-13 00:00&end_date=2019-11-15 00:00
Parameter Type Explanation
lat Float Latitude.
lng Float Longitude.
start_date Date Date that the radar scores start from. In YYYY-MM-DD HH:MM format. (HH is in 24 hour format)
end_date Date Date that the radar scores end. In YYYY-MM-DD HH:MM format. (HH is in 24 hour format)

Swagger for radar score

Explanation of response body parameters:

Successful response body

{
  "scores": [
    {
      "dt": "2018-11-13 00:14:21.573325",
      "score": 3.2
    },
    {
      "dt": "2018-11-13 00:14:21.573325",
      "score": 3.2
    },
    .
    .
    .
    ]
}
Parameter Type Explanation
dt Timestamp Indicates that when this radar score is created in UTC.
score Float Radar score.

Fertilizer

This endpoint returns nitrogen, phosphorous and potassium amounts as well as the type and amount of a fertilizer product that should be applied per given area. The units are in kilograms

Base URL http://world.tarla.in/v1/fertilizers
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/fertilizers?plant_id=11&yield_value=5000&fosfor=3.9&ph=7&nmin=0&organik=0&cinko=0.71&potasyum=10&lat=30&lng=32
Parameter Type Explanation
plant_id Integer Id of the plant.
1-Buğday (Ekmeklik) , 2-Buğday (Makarnalık), 3-Arpa (Maltlık), 4-Arpa (Yemlik), 5-Mısır (Tanelik), 6-Mısır (Silajlık), 7-Pamuk, 8-Ayçiçeği, 9-Karpuz, 10-Kavun, 11-Patates
yield_value Integer Expected yield for the given farm area. Unit: kg/da
fosfor Float Phosphorous amount in soil. Unit: Kg P2O5/da. Interval: 0-13.
ph Float ph of the soil. Interval: 0-14.
nmin Float nmin amount of the soil. Unit: ppm. Interval: 0-10.
organik Float Organic amount in soil. Unit: %. Interval: 0-6
cinko Float Zinc in soil. Unit: ppm. Interval: 0-3
potasyum Float potassium amount in soil. Unit: Kg K2O/da. Interval: 0-250.
lat Float Latitude of the farm. (while testing please send -1)
lng Float Longitude of the farm. (while testing please send -1)
tuz Float Optional. Unit: ds/m. Interval: 0-35.
kirec Float Optional. Unit: %. Interval: 0-100.
katyon Float Optional. Unit: cmol/kg. Interval: 0-50.
demir Float Optional. Unit: ppm. Interval: 0-13.5.
mangan Float Optional. Unit: ppm. Interval: 0-6.
bakir Float Optional. Unit: ppm. Interval: 0-1.
bunye String Optional. It can take one of ['kum', 'tınlı kum', 'kumlu tın', 'tın', 'siltli tın','silt','killi tın','kumlu killi tın','siltli killi tın','kumlu kil','siltli kil','kil','orta ağır','hafif orta']

Yield Value Table:

Plant Plant Id Yield Value Options (kg/da)
Buğday (Ekmeklik) 1 300,400,500,600,700,800,900,1000
Buğday (Makarnalık) 2 300,400,500,600,700,800,900,1000
Arpa (Maltlık) 3 300,400,500,600,700,800
Arpa (Yemlik) 4 300,400,500,600,700,800
Mısır (Tanelik) 5 1000,1100,1200,1300,1400,1500,1600,1700,1800
Mısır (Silajlık) 6 5000,5500,6000,6500,7000,7500,8000,8500,9000
Pamuk 7 400,450,500,550,600
Ayçiçeği 8 200,250,300,350,400
Karpuz 9 2000,3000,4000,5000,6000,7000
Kavun 10 2000,3000,4000,5000,6000,7000
Patates 12 4000,4500,5000,5500,6000,6500,7000,7500

NOTE: If you do not have soil analysis there are two options. "Hafif Toprak" and "Ağır Toprak". Here is the parameters of these two soil types.
hafif toprak: fosfor:7.5, ph:7.5, nmin:0, organik:1, cinko:0.71, potasyum:54, tuz:3, bakir:5.2 , bunye:kumlu killi tın, demir:2.2, katyon:2, kirec:3, mangan:3
ağır toprak: fosfor:7.5, ph:7.5, nmin:0, organik:1, cinko:0.71, potasyum:147, tuz:3, bakir:5.2 , bunye:kumlu killi tın, demir:2.2, katyon:2, kirec:3, mangan:3

Swagger for fertilizer

Explanation of response body parameters:

Successful response body

{
  "fertilizers": [
    [
      {
        "stage_id": 2,
        "stage_name": "1. Üst Gübre (Ara Çapada)",
        "fertilizer_name": "AS",
        "amount": 12.9
      },
      {
        "stage_id": 3,
        "stage_name": "2. Üst Gübre (Sulama Öncesi)",
        "fertilizer_name": "AS",
        "amount": 12.9
      },
      {
        "stage_id": 2,
        "stage_name": "1. Üst Gübre (Ara Çapada)",
        "fertilizer_name": "CAN",
        "amount": 10.4
      },
      {
        "stage_id": 3,
        "stage_name": "2. Üst Gübre (Sulama Öncesi)",
        "fertilizer_name": "CAN",
        "amount": 10.4
      },
      {
        "stage_id": 1,
        "stage_name": "Taban",
        "fertilizer_name": "20.20.0 + 30(SO3) + Zn",
        "amount": 25.6
      }
    ],
    [
      {
        "stage_id": 2,
        "stage_name": "1. Üst Gübre (Ara Çapada)",
        "fertilizer_name": "AS",
        "amount": 17.4
      },
      {
        "stage_id": 3,
        "stage_name": "2. Üst Gübre (Sulama Öncesi)",
        "fertilizer_name": "AS",
        "amount": 17.4
      },
      {
        "stage_id": 2,
        "stage_name": "1. Üst Gübre (Ara Çapada)",
        "fertilizer_name": "CAN",
        "amount": 14.1
      },
      {
        "stage_id": 3,
        "stage_name": "2. Üst Gübre (Sulama Öncesi)",
        "fertilizer_name": "CAN",
        "amount": 14.1
      },
      {
        "stage_id": 1,
        "stage_name": "Taban",
        "fertilizer_name": "20.32.0 + 15(SO3) + Zn",
        "amount": 16.0
      }
    ]
  ],
  "amounts": {
    "fosfor": 5.128,
    "azot": 10.5292,
    "potasyum": 4.999000000000002
  }
}

Fertilizers:

Parameter Type Explanation
fertilizer_name String Name of the fertilizer.
stage_name String Indicates when to apply fertilizer. Fertilizer thrown with planting is called "Taban" fertilizer. The fertilizer that is thrown after reaching a certain stage is called "Üst" fertilizer. "Kristal" or "Granül" fertilizers are also used as "Üst" fertilizer.
stage_id Integer Indicates when to apply fertilizer.
amount Float Indicates how much fertilizer should be applied. Unit: kg/da


Amounts:

Parameter Type Explanation
fosfor Float Indicates how much potassium should fertilizer contains. Unit: kg/da
azot Float Indicates how much nitrogen should fertilizer contains. Unit: kg/da
potasyum Float Indicates how much potassium should fertilizer contains. Unit: kg/da

Fertilizer Dealers

This returns nearest 5 fertilizer dealers for given point.


Base URL http://world.tarla.in/v1/fertilizer/dealers
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/fertilizer/dealers?lat=39&lng=32

Swagger for fertilizer dealers

Explanation of response body parameters:

Successful response body

{
  "dealers": [
    {
      "distance": 2.19207177634,
      "dealer_name": "ABDURRAHMAN TORUN",
      "lat": 39.9327,
      "lng": 32.8777,
      "owner_name": "ABDURRAHMAN TORUN",
      "phone_number": "2425724793",
      "mobile_number": "5373698089",
      "city": "ANTALYA",
      "district": "GAZİPAŞA",
      "address": "CEMAL GÜRSEL CAD. NO:1"
    },
    {
      "distance": 11.81533389954,
      "dealer_name": "AL NAHRAİN DANIŞMANLIK VE DIŞ TİCARET LTD. ŞTİ.",
      "lat": 40.0276,
      "lng": 32.7887,
      "owner_name": "KHUDHAIR HAMEED HAMAD SAEEDI",
      "phone_number": "5345194453",
      "mobile_number": "",
      "city": "ANKARA",
      "district": "YENİMAHALLE",
      "address": ""
    },
    {
      "distance": 15.78482555589,
      "dealer_name": "YAŞAR YILMAZ",
      "lat": 39.7957,
      "lng": 32.8053,
      "owner_name": "YAŞAR YILMAZ",
      "phone_number": "5326159630",
      "mobile_number": "5326159630",
      "city": "ANKARA",
      "district": "GÖLBAŞI",
      "address": ""
    },
    {
      "distance": 16.2905896966,
      "dealer_name": "AKŞEN TARIM VE GÜBRE SAN. TİC. LTD. ŞTİ",
      "lat": 39.7913,
      "lng": 32.8038,
      "owner_name": "GÜNEŞ KAYNAK",
      "phone_number": "5078576941",
      "mobile_number": "5078576941",
      "city": "ANKARA",
      "district": "GÖLBAŞI",
      "address": ""
    },
    {
      "distance": 17.01942816791,
      "dealer_name": "ÖZMENLER TOPRAK ÜRN.GIDA YAK.İNŞ.NAK.SAN VE TİC.LTD. ŞTİ.",
      "lat": 39.963,
      "lng": 32.6562,
      "owner_name": "YASEF ÖZMEN,HÜSEYİN ÖZMEN",
      "phone_number": "3122773688",
      "mobile_number": "5336103993",
      "city": "ANKARA",
      "district": "SİNCAN",
      "address": ""
    }
  ]
}
Parameter Type Explanation
distance Float Distance between given point and fertilizer shop. Unit: km
dealer_name String Name of the fertilizer shop or Name of the individual fertilizer dealer.
lat Float Latitude of the fertilizer shop.
lng Float Longitude of the fertilizer shop.
owner_name String Name of the fertilizer dealer.
phone_number String Mobile phone number of the fertilizer dealer.
mobile_number String Phone number of the fertilizer shop.
city String Province name.
district String District (İlçe) name.
address String Detailed address of fertilizer shop.

Agriculture News

This endpoint returns Turkey's agriculture news in the last 1 month and las 50 news. It has two optional parameters date and limit.

Base URL http://world.tarla.in/v1/news
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/news?date=2020-02-01&limit=10
Parameter Type Explanation
date String It is in YYYY-MM-DD format. It is optional. If it is given, just news after this date are returned.
limit Integer It is optional. If it is given, last this much of news are returned.

Swagger for agriculture news

Explanation of response body parameters:

Successful response body

{
  "news": [
    {
      "date": "2019-12-12",
      "header": "İnegöllü çiftçiler kooperatif çatısı altında birleşti",
      "description": "267 bin dekarlık ekilebilir alanıyla Bursa’nın önemli bir tarımsal üretim merkezi olan İnegöl’de çiftçiler “Üreten Çiftçiler Kooperatifi” çatısı altında birleşiyor. İnegöl belediyesi öncülüğünde oluşturulan Üreten Çiftçiler Kooperatifi bünyesinde TKDK desteği ile soğuk hava deposu da kurulacak.",
      "news_text": "BURSA (DÜNYA) - İnegöl Belediyesi’nin tarıma ilişkin projeleri hakkında açıklama yapan Belediye Başkanı Alper Taban, Üreten Çiftçiler Kooperatifi bünyesinde TKDK desteği ile kurulacak soğuk hava deposunun projesinin onaylandığını ifade etti. Taban, kooperatife de şuana kadar 200 çiftçinin üye olduğunu duyurarak tüm çiftçilere davette bulundu.Belediye Başkanı Alper Taban, 267 bin dekarlık ekilebilir alana sahip olan İnegöl’de 127 bin dekarlık alanın meyve arazisi olarak kullanıldığını söyledi. Taban, “Çok iyi bir meyve üreticisi bölgeyiz. Bunu da zaman içerisinde hem bölgemizde hem ülkemizde hem de uluslararası alanda daha iyi tanınır hale getireceğiz. Alım heyetlerini kooperatifimiz üzerinden şehrimize getirerek bu ürünleri almalarını sağlamak üzere adımlarımızı attık. Yaban mersini, şeftali ve çilek ile ilgili festivaller gerçekleştirdik. Bunların neticesinde tarafımıza ulaşarak bu ürünlerle alakalı bilgiler alıp nasıl alım yapılabilir noktasında girişimler olduğunu ifade edebilirim” dedi. Alper Taban, 5-8 Aralık tarihinde Ankara’da düzenlenen kooperatifçilik fuarında İnegöl Üreten Çiftçiler Kooperatifi’nin ilk kez boy gösterdiğini hatırlattı. Kooperatif bünyesinde 200 üye bulunduğunu belirten Taban, çiftçilere üye olmaları yönünde çağrıda bulundu.Kooperatif bünyesinde planlanan soğuk hava deposu yapımı hakkında da bilgiler veren Taban, “Bildiğiniz gibi TKDK kurumuna yaptığımız bir girişim vardı. Projemizi yazdık. Beraberinde soğuk hava deposunun yapımı için dün itibariyle projeniz onaylanmıştır denildi ve sürecimiz başlamış oldu. Yaklaşık 6 buçuk milyonluk bir soğuk hava deposu yapılacak. Bu soğuk hava tesisinin bedelinin yarısını TKDK Kurumu karşılayacak. Deponun bizim için önemi büyük. Ürettiğiniz ürünleri anında satamayabilirsiniz. Pazarda istediğiniz fiyat dengesi oluşmamış olabilir. Dolayısıyla çiftçimiz burada değerli satış yapma imkanını yakalamış olur” diye konuştu.",
      "img_url": "https://i.dunya.com/1/670/377/files/2019/12/12/458555/458555.jpg?v=1576139777",
      "ref_url": "https://www.dunya.com/ihracat/cay-ihracatindan-13-milyon-dolar-gelir-elde-edildi-haberi-458699"
    },
    {
      "date": "2019-12-15",
      "header": "TMO'ya ilave 500 bin ton buğday ithalat yetkisi",
      "description": "Toprak Mahsulleri Ofisi'ne sıfır gümrükle verilen 1 milyon ton buğday ithalat yetkisi 500 bin ton artışla 1.5 milyon tona çıkarıldı.",
      "news_text": "Ali Ekber YILDIRIMİZMİR- Türkiye buğday ithalatına doymuyor. Bu yılın ilk 10 ayında 7.6 milyon ton ile buğday ithalatında  tarihi rekor kırılırken, Toprak Mahsulleri Ofisi'ne sıfır gümrükle verilen 1 milyon ton buğday ithalat yetkisi 500 bin ton artışla 1.5 milyon tona çıkarıldı.Resmi Gazete'de bugün (15 Aralık 2019) yayınlanan Cumhurbaşkanı Kararı ile Toprak Mahsulleri Ofisi'ne  16 Ocak 2019'da Resmi Gazete'de yayınlanan Karar ile verilen 1 milyon ton buğday ve mahlut ithalat yetkisi 1 milyon 500 bin tona çıkarıldı.Türkiye 2019'un ilk 10 aylık döneminde 6 milyon 750 bin ton ekmeklik ve 902 milyon ton  makarnalık olmak üzere toplamda 7 milyon 652 bin ton buğday ithalatı yaptı. Bu tarihi rekor, üretimin azalmasından kaynaklanıyor.Geçen yıl ilk 10 ayda 4.3 milyon ton olan ekmeklik buğday ithalatı bu yıl aynı dönemde yüzde 57 artışla 6 milyon 750 bin tona ulaştı. Makarnalık buğday ithalatı ise aynı dönemde yüzde 148 artışla 364 bin tondan 902 bin tona çıktı.Üretim azalıyorSon 5 yıllık verilere bakıldığında Türkiye'nin buğday üretimi azalıyor. 2015 yılında  22 milyon 600 bin ton olan buğday üretimi 2016'da 20 milyon 600 bin tona düştü. 2017'de 21 milyon 500 bin ton olan üretim 2018'de 20 milyon tona, 2019'da da 19 milyon tona geriledi. Türkiye'nin buğday tüketimi de 19 milyon ton. Üretimle tüketim başabaş noktasına geldi.Tarım Bakanlığına göre üretimdeki düşüşün nedenleriTarım ve Orman Bakanı Dr. Bekir Pakdemirli'nin talimatıyla stratejik öneme sahip bazı tarım ürünleri hakkındaki gelişmelerin izlenmesi için oluşturulan ürün takip masalarının hazırladığı Buğday Raporuna göre üretim alanlarının daralması ve üretimdeki düşüşün nedenleri şöyle ifade ediliyor: \"Buğday ekim alanlarında yaşanan azalma en yüksek seviye çıkarak toplam buğday ekiliş alanları 70 milyon dekarın altına gerilemiştir. Geçen sezon kuraklığa bağlı yaşanan üretim azalması, fiyatların düşük seyretmesi, girdi fiyatlarının aşırı yükselmesi, bu sezon için buğday üreticisinin alternatif ürünlere yönelmesine sebep olmuştur.\"Mazot, gübre ve ilaç fiyatları yüksekGirdi fiyatlarının yüksek olmasının da üretimdeki düşüşte etkili olduğu belirtilen raporda: \"Ayrıca yine yüksek mazot, gübre ve ilaç fiyatları yüzünden çiftçi ürününe yeterli özeni gösterememiş, tohum yatağını düzgün hazırlayamamış, daha düşük miktarda gübre kullanıp, yeterli ilaçlama yapamamıştır. İklimsel olarak şartların normal gitmesine ve bölge ülkelerindeki üretim artışına rağmen ülkemiz üretiminde alan azalmasından ve ürüne yetersiz bakımdan kaynaklı üretim azalması yaşanmıştır.\" denildi.Mamul madde ihracatıİthal buğdayın büyük bölümü un,makarna,irmik ve diğer ürünlerde kullanılıyor ve bu ürünlerin de büyük bölümü ihraç ediliyor. Türkiye Makarna Sanayicileri derneği verilerine göre, bu yılın ilk 10 aylık döneminde makarna ihracatında yüzde 8.63 oranında artış sağlandı.Makarna ihracatı 1 milyon 70 bin tona ulaştı. Un ihracatı ise 2019 yılının ilk 9 ayında 2 milyon 380 bin ton olarak gerçekleşti.Geçen yıl aynı dönemde un ihracatı  2 milyon 460 bin tondu.",
      "img_url": "https://i.dunya.com/1/670/377/files/2019/12/15/458718/458718.jpg?v=1576395297",
      "ref_url": "https://www.dunya.com/ihracat/cay-ihracatindan-13-milyon-dolar-gelir-elde-edildi-haberi-458699"
    },
    {
      "date": "2019-12-12",
      "header": "Ekolojik ürünler kooperatif aracılığıyla tüketiciye ulaşacak",
      "description": "Nilüfer Belediyesi desteğiyle, kentin kırsal mahallelerinde tarım ve hayvancılığın geliştirilmesi amacıyla kurulan S.S. Nilüfer Tarımsal Kalkınma Kooperatifi (NİLKOOP), 160 dönüm araziye yerli buğday ekti. Ekolojik koşullarda üretilecek buğday unu kooperatif aracılığıyla tüketiciye ulaşacak.",
      "news_text": "BURSA (DÜNYA) – Nilüfer’de tarım ve hayvancılığın gelişmesi için pek çok çalışma yürüten ve aynı amaçla NİLKOOP S.S. Nilüfer Tarımsal Kalkınma Kooperatifi’nin kurulmasına destek veren Nilüfer Belediyesi, Nilüfer Küçük Ölçekli Kent Bostanları’nda yapılan çeşit ve verimlilik denemeleri sonucu elde edilen yerli buğday tohumlarıyla seri üretime geçiyor.Merkezi Çatalağıl Mahallesi’nde bulunan NİLKOOP, tıbbi ve aromatik bitkilerden, meyve üretimine, arıcılık ve bal üretiminden, tahıl, baklagil ve sebze gibi ürünlerin yetiştirilip, satışının yapılmasına kadar geniş bir yelpazede çalışma yürütüyor. Ekolojik tarım koşullarında ve tarım kimyasalları kullanmadan yapılması hedeflenen bitkisel üretimlerden elde edilecek sağlıklı gıdaları, bireysel tüketicilerin yanı sıra Tüketici Kooperatifleri aracılığıyla daha geniş kitlelere ulaştırılacak olan NİLKOOP, Nilüfer Belediyesi’nden kiralanan arazilerde yerli buğday ekimi gerçekleştirdi.Kooperatif üyelerinin toprak hazırlığı ve ekim işlerini bizzat gerçekleştirdiği 160 dönümlük üretim alanına yerli tohumlar ekildi. Karacaoba, Konaklı, Büyükbalıklı, Gökçeköy, Kızılcıklı, İrfaniye, Fadıllı ve Akçalar mahallelerinde ekolojik şartlarda üretilecek olan ürünler, hasat sonrası un haline getirilerek satışa sunulacak. Uygulama hakkında bilgi veren Nilüfer Belediyesi Çevre ve Kırsal Alan Koordinatörü ve NİLKOOP Yönetim Kurulu Üyesi Arca Atay, “NİLKOOP’un kurulma amaçlarından biri de Nilüfer Belediyesi’nin tarım arazilerini doğru yöntemlerle değerlendirmek. Bu yıl bu arazilerin 160 dönümlük bölümde yerli buğdaylar elde edeceğiz. Yerli tohumlardan tam buğday unu elde etmeyi hedefliyoruz. Arazilerimizde ekili olacak ürünler tamamen ekolojik şekilde üretilecek. Zirai ve kimyasal gübre kullanılmayacak. Hedefimiz insanların sağlıklı gıdaya ulaşmasıdır. Kooperatif olarak ürün çeşitliliğini önemserken, ekolojik şartlarda sağlıklı ürün elde etmek en önemli hedefimiz” dedi.",
      "img_url": "https://i.dunya.com/1/670/377/files/2019/12/12/458574/458574.jpg?v=1576158907",
      "ref_url": "https://www.dunya.com/ihracat/cay-ihracatindan-13-milyon-dolar-gelir-elde-edildi-haberi-458699"
    }
  ]
}
Parameter Type Explanation
date String Date of the news.
header String Header of the news.
description String Short description (summary) of the news.
news_text String Full text of the news.
img_url String Image url of the news.
ref_url String Website link of the news source.

Insurance

This returns important risk parameters for a place.


Base URL http://world.tarla.in/v1/insurance
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/insurance?lat=39&lng=32&start_date=2019-08-20&end_date=2019-08-24&radius=5&event_type=hail
Parameter Type Explanation
lat Float Latitude.
lng Float Longitude.
start_date String Start date of risk parameters. In YYYY-MM-DD format. This dat is included.
end_date String End date of risk parameters. In YYYY-MM-DD format. This day is not included.
radius Integer It is optional default is 5. Indicates the area, system draws a circle with this much radius and returns risk parameters for this drawn circle.
event_type String It is optional default is "hail". Indicates the risk parameter types. For now just "hail" option is available.

Swagger for insurance

Explanation of response body parameters:

Successful response body

{
  "risk_parameters": [
    {
      "date": "2019-08-20",
      "hail": 0,
      "ic_count": 4,
      "cg_count": 5,
      "low_polygon_count": 0,
      "medium_polygon_count": 0,
      "high_polygon_count": 0,
      "precipitation": 2.46,
      "max_wind": 15.23,
      "max_temperature": 25.54,
      "min_temperature": 14.76,
      "radar_scores": [
        {
          "date": "2019-08-20 00:09",
          "score": 0.0
        },
        {
          "date": "2019-08-20 00:27",
          "score": 0.0
        },
        {
          "date": "2019-08-20 00:45",
          "score": 0.0
        },
        {
          "date": "2019-08-20 01:03",
          "score": 0.0
        },
        {
          "date": "2019-08-20 01:21",
          "score": 0.0
        },
        .
        .
        .
        {
          "date": "2019-08-20 23:24",
          "score": 0.0
        },
        {
          "date": "2019-08-20 23:45",
          "score": 0.0
        }
      ]
    },
    {
      "date": "2019-08-21",
      "hail": 0,
      "ic_count": 0,
      "cg_count": 3,
      "low_polygon_count": 0,
      "medium_polygon_count": 0,
      "high_polygon_count": 0,
      "precipitation": 0.1,
      "max_wind": 17.42,
      "max_temperature": 25.15,
      "min_temperature": 14.66,
      "radar_scores": [
        {
          "date": "2019-08-21 00:07",
          "score": 0.157576
        },
        {
          "date": "2019-08-21 00:29",
          "score": 1.15152
        },
        {
          "date": "2019-08-21 00:51",
          "score": 1.24848
        },
        .
        .
        .
        {
          "date": "2019-08-21 22:49",
          "score": 0.0
        },
        {
          "date": "2019-08-21 23:29",
          "score": 0.0
        },
        {
          "date": "2019-08-21 23:50",
          "score": 0.0
        }
      ]
    }
  ]
}

Parameter Type Explanation
date String Date of risk parameters. It is in YYYY-MM-DD format
hail Integer It is result of "machine learning hail prediction" algorithm. 1 means hail is detected. 0 mean no hail is detected.
ic_count Integer Total inter-cloud lightnings happened for the date in given radius area.
cg_count Integer Total cloud-to-ground lightnings happened for the date in given radius area.
low_polygon_count Integer Total low polygon happened for the date in given radius area. Low is the severity of the polygon.
medium_polygon_count Integer Total medium polygon happened for the date in given radius area. Medium is the severity of the polygon.
high_polygon_count Integer Total high polygon happened for the date in given radius area. High is the severity of the polygon.
precipitation Float Precipitation happened for the date. Unit: mm
max_wind Float Maximum wind happened for the date. Unit: km/h
max_temperature Float Maximum temperature happened for the date. Unit: celcius
min_temperature Float Minimum temperature happened for the date. Unit: celcius
radar_scores Array Radar score array. Date is in YYYY-MM-DD HH:MM format. Approximately for every 25 minutes there is a radar score. Scores above 10 means heavy rain. Scores below 1 means no precipitation.

Land Prices

This endpoint returns land maximum, mininum and average land prices for given area and given date interval.

Base URL http://world.tarla.in/v1/farms/prices
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/farms/prices?lat=39.933057&lng=32.851995&start_date=2019-01-01&end_date=2020-02-01&radius=50

Swagger for land prices

Explanation of response body parameters:

Successful response body

{
  "prices": [
    {
      "year": 2019,
      "month": 11,
      "max_price": 497,
      "min_price": 1,
      "avg_price": 83.26,
      "total_land_count": 68
    },
    {
      "year": 2019,
      "month": 12,
      "max_price": 502,
      "min_price": 1,
      "avg_price": 84.15,
      "total_land_count": 75
    },
    {
      "year": 2020,
      "month": 1,
      "max_price": 496,
      "min_price": 1,
      "avg_price": 83.45,
      "total_land_count": 59
    }
  ]
}
Parameter Type Explanation
year Integer Year of the statistics.
month Integer Month of the statistics.
max_price Float Maximum price among all the lands in given month and year. Unit: ₺
min_price Float Minimum price among all the lands in given month and year. Unit: ₺
avg_price Float Average price among all the lands in given month and year. Unit: ₺
total_land_count Integer Total land amount for given area and given date.

Crop Truth

This endpoint returns all farm crops for given area and given date interval.

Base URL http://world.tarla.in/v1/farms/plants
Request Type GET
Response Type Instant response
Sample Request http://world.tarla.in/v1/farms/plants?lat=39.933057&lng=32.851995&start_date=2019-01-01&end_date=2020-02-01&radius=50

Swagger for crop truth

Explanation of response body parameters:

Successful response body

{
  "plants": [
    "yulaf",
    "fiğ",
    "buğday (ekmeklik)",
    "patates",
    "yonca",
    "arpa",
    "buğday (makarnalık)",
    "sorgum",
    "yem bezelyesi",
    "elma",
    "arpa (yemlik)",
    "pamuk",
    "mısır (tanelik)",
    "buğday",
    "mısır (silajlık)",
    "ayçiçeği",
    "mısır",
    "kiraz",
    "avokado",
    "kavun",
    "yonca",
    "üzüm",
    "pancar",
    "armut",
    "buğday",
    "karpuz",
    "arpa (maltlık)"
  ]
}
Parameter Type Explanation
plants Array All plant names that exists for given area and given date interval.

Error Codes

Code Explanation Return Value
403 no permission to access { "message": "Forbidden"}
500 a problem occured about returning data { "message": "Error"}
401 there is no apikey parameter at header of the request { "message": "Auth API key required."}
401 wrong apikey { "message": "Invalid API key."}
401 apikey does not have permission to user that product { "message": "Wrong product."}
401 apikey run out of limit for that product { "message": API key exceeded."}
401 apikey expired { "message": API key expired."}
422 wrong parameters in the request JSON that has what is wrong in your request