Skip to content

1km Mesh WeatherForecast (Medium-Range・CSV)

Overview

Provides weather forecast data calculated for each 1km grid in CSV format. Medium range forecast contains 10 days of daily weather forecasts. Weather codes in medium range forecasts include combined expressions like "later" and "sometimes" with two weather types. 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_mrf.csv

Request

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

Response

CSV

NameDescriptionTypeFormatMissingSample
idRequest IDstring
latLatitudefloat
lonLongitudefloat
meshcodeMesh codeint8-digit number3rd mesh code
dateDatestring2021/6/1
hourHourint0-23
wxWeather codeint100-999-9999Weather Code・Icon(Observation)
maxtempMaximum Temperature(℃)float-9999
mintempMinimum Temperature(℃)float-9999
popProbability of Precipitation(%)int-99

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

StatusError CodeError MessageDescription
400400_001"key" is requiredRequired parameter not specified
400400_002"key" is invalid valueInvalid parameter type/format
400400_003"key" is out of rangeParameter value out of range
401401_001"X-API-Key" is requiredAPI key not provided
401401_002API Key is invalid valueInvalid API key
401401_003"Key" is out of rangeOutside authorized usage period/access location
403403_001"key" is out of rangeData out of range
404404_001Resource is not existInvalid resource (method/path) specified
404404_002Data is not foundInvalid location/date specified
429429_001Requests is too manyRequest rate limit per second exceeded
500500_001an error has occurredUnknown error occurred

Sample

Response (Success)

csv
id,lat,lon,meshcode,date,wx,maxtemp,mintemp,pop
01101,43.062638,141.353921,64414278,2021/06/01,100,18,8,20
01101,43.062638,141.353921,64414278,2021/06/02,201,21,11,30
.....

Response (Error)

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

All trademarks and registered trademarks are the property of their respective owners.