Service
일본 기상청(JMA) Bosai 날씨 데이터: 예보 관서(office) 단위의 단기·주간 예보와 예보 해설, 공식 예보 구역 코드 계층, 지점에서 가장 가까운 관측소의 현재 AMeDAS 관측, JMA가 추적 중인 모든 열대저기압의 실황과 예보를 www.jma.go.jp의 키 없는 공개 JSON 엔드포인트에서 제공합니다.
99.73%30일 가동률평균 응답196ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/jma-weather/active-typhoons | Returns every tropical cyclone JMA is currently tracking in the western North Pacific, each with its current analysis and JMA's forecasts, from bosai/typhoon/data/targetTc.json and each cyclone's specifications.json. Every state carries its kind (analysis, one-hour estimate, or forecast), lead hours, valid time, grade (typhoon, severe tropical storm, tropical storm, tropical depression, extratropical cyclone), JMA's size and intensity classes, center latitude/longitude, movement direction and speed, central pressure in hPa, maximum sustained wind and gust in m/s, and wind areas as radii in km per side of the center: the storm area (25 m/s or more) and gale area (15 m/s or more) for the analysis and estimate, and the probability circle and storm warning area for forecasts. Use when you need to know whether a typhoon is active, where it is, how strong it is, and where JMA forecasts it to go. Takes no input. An empty typhoons list is JMA's normal answer when no cyclone is active. Do NOT use for local weather forecasts — use jma-weather:forecast-by-area. Names and location_text are JMA's Japanese text, verbatim; values JMA does not publish for a state (no size class on a forecast, no maximum wind for a tropical depression) are null. | |
| POST | /v1/jma-weather/area-code-map | Returns the official JMA area hierarchy from bosai/common/const/area.json: centers (regional blocks), offices (prefecture-level forecast offices; the jma-weather:forecast-by-area input vocabulary), class10 primary subdivisions, class15 grouped-municipality areas, and class20 municipalities with kana readings. A few offices have no forecast file of their own: as of 2026-07-20, 014030 Tokachi and 460040 Amami return NOT_FOUND because their forecasts are published under sibling offices 014100 and 460100. Use when you need to resolve a place to a forecast area code or walk parent/child relations of the official hierarchy. Do NOT use for weather values — use jma-weather:forecast-by-area instead. This is a static reference map maintained by JMA that changes only when administrative areas change. Returns centers, offices, class10_areas, class15_areas, and class20_areas. | |
| POST |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| /v1/jma-weather/current-observation |
| Fetches the latest JMA AMeDAS observation from the station nearest to a WGS84 latitude/longitude. It reads amedas/data/latest_time.txt, the 10-minute map snapshot it names, and JMA's official station table, selects the nearest station that published in that snapshot, and returns that one station's identity, coordinates, distance from the requested point, observation time, and the readings it carries (temperature, humidity, station and sea-level pressure, visibility, wind speed and direction, 10-minute to 24-hour precipitation, sunshine duration). Use when you need what the weather is right now near a place in Japan. Do NOT use for forecasts — use jma-weather:forecast-by-area instead; forecast office area codes are a different vocabulary and do not identify an AMeDAS station. Readings JMA flags as anything other than normal or quasi-normal are returned as null, never as the doubtful number. Check distance_meters: the nearest station can be far from a point outside Japan's station network. Returns station_code, station_name, station_name_english, latitude, longitude, elevation_meters, distance_meters, observation_time, and the station's readings. |
| POST | /v1/jma-weather/forecast-by-area | Fetches the official JMA forecast for one forecast office area code (e.g. 130000 for Tokyo) and returns both report blocks JMA publishes: a short-term report (~3 days of weather codes, Japanese weather/wind/wave text, precipitation probabilities, and forecast daily minimum/maximum temperatures on time-labeled slots) and a weekly report (7-day weather codes, precipitation probabilities, forecast reliability classes, min/max temperature ranges, and climatological normals). Use when you need the authoritative Japanese government forecast for a prefecture-level area. Do NOT use for resolving a city or place name to an area code or for browsing the area hierarchy — use jma-weather:area-code-map instead. Area codes are JMA office codes from jma-weather:area-code-map, never city names or coordinates. Unknown area codes return a structured NOT_FOUND error (upstream HTTP 404). Weather codes are pattern-validated 3-digit strings from JMA's open-ended code table; the Japanese text fields carry the human-readable forecast. Returns area_code, short_term, and weekly. |
| POST | /v1/jma-weather/forecast-overview-by-area | Returns JMA's Japanese forecast narrative (天気概況) for one forecast office area code (e.g. 130000 for Tokyo): the publishing office, the report time, the target area name, the headline, and the narrative prose, all verbatim from bosai/forecast/data/overview_forecast/{area_code}.json. Use when you need JMA's own explanation of the weather situation behind the forecast — fronts, pressure systems, and what to expect — in Japanese. Do NOT use for structured forecast values (weather codes, precipitation probabilities, temperatures) — use jma-weather:forecast-by-area instead. Area codes are JMA office codes from jma-weather:area-code-map; the same two offices without a forecast file (014030 Tokachi, 460040 Amami) have no overview either and return NOT_FOUND. The Japanese text is never translated; headline_text is an empty string outside special-weather situations. Returns area_code, publishing_office, report_datetime, target_area, headline_text, and narrative_text. |
