JMA-LANG-KO

JMA-LANG-KO는 일본 기상청(JMA, Japan Meteorological Agency)의 지진·해일 정보에서 사용되는 일본어 지역명, 진앙명 등을 한국어로 변환하는 라이브러리입니다.
Node.js 환경에서 간단히 불러와 사용할 수 있습니다.

📦설치

npm install jma-lang-ko

🔎사용 예시

import {earthquake, tsunami} from 'jma-lang-ko'

console.log(earthquake.EarthquakeWarningKR('31'))
// 출력 예시: 긴급지진속보(경보)
console.log(tsunami.TsunamiWarningKR('00'))
// 출력 예시: 해일 없음

earthquake, tsunami, volcano 함수는 string | number 타입의 코드를 입력받을 수 있습니다.

jma 함수는 string 타입을 지원합니다.

🚩제공 함수

earthquake

| 함수명 | 코드 종류 | 입력값 | 출력값 | | --- | --- | :-: | --- | | EarthquakeWarningKR | ”警報等情報要素／緊急地震速報”"경보 등 정보 요소 / 긴급지진속보" | 00 | "없음" | | EarthquakeForecastKR | ”緊急地震速報”"긴급지진속보" | 00 | "긴급지진속보(예보)" | | AreaForecastEEWKR | ”緊急地震速報／地方予報区”"긴급지진속보 / 지방 예보구" | 9910 | "홋카이도 도오" | | AreaForecastLocalEEWKR | ”地震情報／都道府県等”"지진정보 / 도도부현 등" | 01 | "홋카이도" | | AreaInformationPrefectureEarthquakeKR | ”緊急地震速報／地方予報区”"긴급지진속보 / 지방 예보구" | 9910 | "홋카이도" | | AreaForecastLocalEKR | ”地震情報／細分区域”"지진정보 / 세분 구역" | 100 | "이시카리 지방 북부" | | AreaInformationCityKR | “気象・地震・火山情報／市町村等”"기상・지진・화산정보 / 시정촌 등" | 0123500 | "이시카리 시" | | PointSeismicIntensityKR | ”震度観測点”"진도 관측점" | 0123500 | "이시카리 시 하나가와" | | AreaEpicenterKR | ”震央地名”"진앙지명" | 011 | "홋카이도 지방" | | AreaEpicenterAbbreviationKR | ”短縮用震央地名”"단축용 진앙지명" | 9011 | "홋카이도 도오" | | AreaEpicenterDetailKR | ”詳細震央地名”"상세 진앙지명" | 1001 | "미국, 알래스카 주 중앙부" | | AreaEpicenterSupplimentKR | ”震央補助”"진앙지명" | 100 | "에토로후 섬" | | TokaiInformationKR | ”東海観連情報番号”"도카이 관련 정보 번호" | 000 | "임시" | | EarthquakeInformationKR | ”地震関連情報番号”"지진 관련 정보 번호" | 111 | "조사중" | | AdditionalCommentEarthquakeKR | ”固定付加文”"고정 부가문" | 0101 | "이후, 약간의 해수면 변동이 있을 수도 있습니다." |

tsunami

| 함수명 | 코드 종류 | 입력값 | 출력값 | | --- | --- | :-: | --- | | TsunamiWarningKR | ”警報等情報要素／津波警報・注意報・予報”"경보 등 정보 요소 / 해일경보・주의보・예보" | 00 | "해일 없음" | | AreaTsunamiKR | ”津波予報区”"해일 예보구" | 100 | "홋카이도 태평양 연안 동부" | | CoastTsunamiKR | ”沿岸地域”"연안 지역" | 100 | "홋카이도 태평양 연안 동부" | | PointTsunamiKR | “潮位観測点”"조위 관측점" | 10001 | "쿠시로" |

volcano

| 함수명 | 코드 종류 | 입력값 | 출력값 | | --- | --- | :-: | --- | | VolcanicWarningKR | ”警報等情報要素／噴火警報・予報等”"경보 등 정보 요소 / 분화경보・예보 등" | 11 | "레벨 1 (활화산인 것에 유의)" | | PointVolcanoKR | ”火山名”"화산명" | 101 | "시레토코 이오 산" |

jma

| 함수명 | 코드 종류 | 입력값 | 출력값 | | --- | --- | :-: | --- | | OfficeKR | - | "札幌管区気象台" | "삿포로 관구 기상대" | | OfficeEnKR | - | "JPSP" | "삿포로 관구 기상대" |

참고

• 스프레드시트 에서 코드를 확인하실 수 있습니다.
• JMA 지진 화산 관련 XML 전문 해설 자료에서 코드의 적용 장소를 확인할 수 있습니다.
  • 해당 문서는 현재 미완성이며 오류가 있을 수 있습니다. 파일은 수시 업데이트 됩니다.

⚠️ 주의사항

• Node.js 20 이상 환경에서 사용하는 것을 권장합니다.
  (JSON import ... with { type: "json" } 문법은 Node.js 20+ 이상에서 정식 지원됩니다.)

• ES Module("type": "module") 환경을 사용해야 합니다.
  CommonJS(require)에서는 바로 사용할 수 없습니다.
  CommonJS 환경에서는 동적 import를 이용해 다음과 같이 사용할 수 있습니다:

  (async () => {
    const { earthquake } = await import('jma-lang-ko');
    console.log(earthquake.AreaEpicenterKR("350"));
  })();

• JSON 데이터(data/*.json)는 수시 업데이트됩니다.
  새로운 관측점 등 코드가 추가된 경우, npm update jma-lang-ko로 최신 버전을 받아주세요.

🧾 라이선스

MIT License © 2025 monggae0319

🐞 버그 신고

문제가 있거나 새로운 지역명이 필요하다면 이슈를 남겨주세요. Github Issues