Weather API는 태풍의 위치, 속도, 이동 경로 등의 상세 데이터를 실시간으로 제공합니다.
제공된 데이터는 해양 기상 분석 및 선박 위험 회피, 기상 리스크 예측 등에 활용하실 수 있습니다.
인증 방법
본 API는 Swagger UI 기반의 Basic 인증 방식을 사용합니다.
인증 절차
1.
Swagger 문서에 접속합니다.
2.
화면 우측 상단의 [Authorize] 버튼을 클릭합니다.
3.
제공받은 아이디와 비밀번호를 입력합니다.
4.
다시 [Authorize] 버튼을 클릭하여 인증을 완료합니다.
5.
인증 창을 닫습니다.
인증이 완료되면 Swagger UI를 통해 호출되는 모든 API 요청에 인증 정보가 자동으로 포함됩니다.
요청 정보
1. 요청 URL
bash
복사편집
[GET] https://insight.seavantage.com/api/weather/cyclone?source=JTWC
Plain Text
복사
2. 실행 절차
1.
Swagger 문서에서 우측 상단 Select a definition 메뉴에서 Weather를 선택합니다.
2.
/weather/cyclone 항목으로 이동합니다.
3.
[Try it Out] 버튼을 클릭하여 요청 입력창을 활성화합니다.
4.
source 파라미터 값을 아래 표에 따라 입력합니다.
source 값 | 설명 |
JTWC | 미국 합동태풍경보센터 (Joint Typhoon Warning Center) |
NOAA | 미국 해양대기청 (National Oceanic and Atmospheric Administration) |
1.
[Execute] 버튼을 클릭하여 결과를 확인합니다.
문서 링크: Swagger 문서 바로가기
응답 정보
응답 예시
json
복사편집
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2024-12-01T12:00:00",
"response": [
{
"cycloneName": "string",
"cycloneNumber": 0,
"basin": "string",
"details": [
{
"dateTime": "2025-05-15T00:44:11.133Z",
"fixHour": 0,
"latitude": 0,
"longitude": 0,
"pressure": 0,
"speed": 0
}
],
"geoJson": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [50, -10, 0]
},
"properties": {
"name": "SOME CYCLONE",
"visibility": true,
"open": true,
"description": "",
"Style": {
"description": {
"title": null,
"abstract": null},
"name": "name",
"transformation": null,
"options": {},
"featureInstanceIDs": null,
"onlineResource": null,
"rules": []
}
},
"id": "abc-aaaaaaaa_18dc1a851c8_-abcd"
}
]
}
}
]
}
JSON
복사
응답 필드 설명
상위 응답 구조
필드명 | 예시 | 설명 |
code | 200 | 응답 상태 코드 |
message | OK | 응답 메시지 |
error | false | 오류 발생 여부 (true 또는 false) |
timestamp | 2025-05-15T10:56:59 | 응답 생성 시각 (UTC 기준) |
response | 배열 또는 null | 태풍 데이터 객체 목록 또는 null 값 |
response 객체 (Depth 1)
필드명 | 예시 | 설명 |
cycloneName | string | 태풍 이름입니다. |
cycloneNumber | 0 | 태풍 고유 번호입니다. |
basin | string | 태풍이 형성된 해역(분지)입니다. |
details 배열 (Depth 2)
필드명 | 예시 | 설명 |
dateTime | 2025-05-15T00:44:11 | 관측 시간 |
fixHour | 0 | 관측 시간 이후 경과 시간 |
latitude | 0 | 위도 좌표 |
longitude | 0 | 경도 좌표 |
pressure | 0 | 중심 기압 (hPa) |
speed | 0 | 이동 속도 (kt 또는 km/h 기준) |
geoJson 객체 (Depth 3)
FeatureCollection 구조
필드명 | 예시 | 설명 |
type | FeatureCollection | GeoJSON 최상위 타입 |
Feature 내부 항목
필드명 | 예시 | 설명 |
type | Feature | 공간 객체 타입 |
geometry.type | Point | 좌표 형태 |
geometry.coordinates | [50, -10, 0] | 위치 좌표 (경도, 위도, 고도 순) |
properties 객체
필드명 | 예시 | 설명 |
name | SOME CYCLONE | 태풍 명칭 |
visibility | true | 지리 객체 표시 여부 |
open | true | 편집 가능 여부 또는 펼침 상태 |
description | (빈 문자열) | 객체 설명 |
Style | 객체 구조 | 시각화 및 스타일 속성 정보 |
id | abc-... | 고유 식별자 (UUID 또는 문자열) |
응답 코드 목록
코드 | 설명 |
200 | 요청이 정상적으로 처리되었습니다. |
201 | 리소스가 정상적으로 생성되었습니다. |
400 | 잘못된 파라미터 또는 요청 형식입니다. |
401 | 인증이 필요합니다. |
403 | 권한이 없습니다. |
422 | 요청을 처리할 수 없습니다. |
429 | 요청 허용 횟수를 초과하였습니다. |