1km Mesh Feel-like Forecast(CSV)

Overview

Provides feel-like forecast data calculated for each 1km grid in CSV format. Contains 72 hours of hourly forecast data. Forecast data includes feel-like index and feel-like temperature values. API supports up to 50 requests per second.

Endpoint

A dedicated endpoint will be provided with your API Key upon contract.

GET https://example.com/csv/batch/xxxxxxxxxx.csv

Request

curl -s "https://example.com/csv/batch/xxxxxxxxxx.csv" \
    -H "X-API-Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" > xxxxxxxxxx.csv

Response

CSV

Name	Description	Type	Format	Missing	Sample
id	Request ID	string
lat	Latitude	float
lon	Longitude	float
meshcode	Mesh code	int	8-digit number		3rd mesh code
date	Date	string			2021/6/1
hour	Hour	int	0-23
wx	Weather code	int	100-999	-9999	Weather Code・Icon(Observation)
temp	Temperature(℃)	float		-9999
prec	Precipitation(mm/h)	float		-9999	Next 1 hour
arpress	Pressure(hPa)	float		-9999
wndspd	Wind speed(m/s)	float		-9999
wnddir	Wind direction	int	1-16	-99	Wind Direction Definitions
rhum	Humidity(%)	int		-99
feeltmp	Feel-like temperature(℃)	float		-9999
feelidx	Feel-like index	int	1-10	-99	Feel-like Index Definitions

Request ID

An ID is provided to classify the data. When providing CSV data by municipality, this includes the 5-digit municipal code issued by the Ministry of Internal Affairs.

Errors

Status	Error Code	Error Message	Description
400	400_001	"key" is required	Required parameter not specified
400	400_002	"key" is invalid value	Invalid parameter type/format
400	400_003	"key" is out of range	Parameter value out of range
401	401_001	"X-API-Key" is required	API key not provided
401	401_002	API Key is invalid value	Invalid API key
401	401_003	"Key" is out of range	Outside authorized usage period/access location
403	403_001	"key" is out of range	Data out of range
404	404_001	Resource is not exist	Invalid resource (method/path) specified
404	404_002	Data is not found	Invalid location/date specified
429	429_001	Requests is too many	Request rate limit per second exceeded
500	500_001	an error has occurred	Unknown error occurred

---

Sample

Response (Success)

id,lat,lon,meshcode,date,hour,wx,temp,prec,arpress,wndspd,wnddir,rhum,feeltmp,feelidx
01101,43.062638,141.353921,64414278,2022/12/21,5,200,-4,0,1015,0,10,79,-5,1
01101,43.062638,141.353921,64414278,2022/12/21,6,200,-4,0,1015,0,11,79,-5,1
.....

Response (Error)

{
  "requestId": "xxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx==",
  "errors": [
    {
      "code": "401_001",
      "message": "request is unauthorized"
    }
  ]
}