Share via

Weather - Get Tropical Storm Forecast

  • 참조
Service:
Maps
API Version:
1.1

국가 일기 예보 기관에 의해 예측 된 열대 폭풍의 목록을 얻기 위해 사용합니다.

Get Tropical Storm Forecasts API는 정부에서 발급한 개별 열대 폭풍 예측을 반환하는 HTTP GET 요청입니다. 예측 된 열대 폭풍에 대한 정보는, 위치, 상태, 예측이 만들어진 날짜, 창, 풍속과 바람 반경을 포함한다.

GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
With optional parameters: 
GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&unit={unit}&details={details}&radiiGeometry={radiiGeometry}&windowGeometry={windowGeometry}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
format
 path True

JsonFormat

원하는 응답 형식입니다. json 형식만 지원됩니다.
api-version
 query True

string

Azure Maps API의 버전 번호.
basinId
 query True

basinId

분지 식별자
govId
 query True

integer

int32

정부 폭풍 ID
year
 query True

integer

int32

사이클론의 해
details
 query

boolean

true이면 wind radii 요약 데이터가 응답에 포함됩니다.
radiiGeometry
 query

boolean

true이면 wind radii 요약 데이터 및 geoJSON 세부 정보가 응답에 포함됩니다.
unit
 query

WeatherDataUnit

메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다.
windowGeometry
 query

boolean

true이면 응답에 geoJSON(창 기하 도형 데이터)이 포함됩니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-id

string

Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요.

응답

Name 형식 Description
200 OK

StormForecastResult

정상
Other Status Codes

ErrorResponse

예기치 않은 오류가 발생했습니다.

보안

AADToken

Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

참고

  • 이 보안 정의에서는 헤더를 사용하여 애플리케이션이 x-ms-client-id 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.

Authorization URL 은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다. * Azure Maps 웹 SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 허용합니다.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

이 키는 Azure Portal Azure Maps 계정을 Create PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정의 master 키로 사용할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.

Type: apiKey
In: query

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

Type: apiKey
In: header

예제

Get Tropical Storm Forecasts

Sample Request

GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year=2021&basinId=NP&govId=2

Sample Response

Status code:
200 
{
  "results": [
    {
      "dateTime": "2021-04-25T06:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 22,
        "longitude": 137.8
      },
      "maxWindGust": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "window": {
        "left": {
          "latitude": 22.56387,
          "longitude": 137.739517
        },
        "right": {
          "latitude": 21.4361,
          "longitude": 137.860489
        }
      }
    },
    {
      "dateTime": "2021-04-25T18:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 23.7,
        "longitude": 142.4
      },
      "maxWindGust": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "window": {
        "left": {
          "latitude": 24.45283,
          "longitude": 142.055313
        },
        "right": {
          "latitude": 22.94641,
          "longitude": 142.744675
        }
      }
    }
  ]
}

정의

Name Description
basinId

분지 식별자
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
GeoJsonGeometry

유효한 GeoJSON geometry 개체입니다. 이 형식은 Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon 및 GeometryCollection의 7가지 유효한 GeoJSON 기하 도형 형식 중 하나여야 합니다. 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonGeometryCollection

유효한 개체 형식입니다 GeoJSON GeometryCollection . 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonLineString

유효한 GeoJSON LineString 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonMultiLineString

유효한 GeoJSON MultiLineString 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonMultiPoint

유효한 GeoJSON MultiPoint 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonMultiPolygon

유효한 개체 형식입니다 GeoJSON MultiPolygon . 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonPoint

유효한 GeoJSON Point 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
GeoJsonPolygon

유효한 GeoJSON Polygon 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
JsonFormat

원하는 응답 형식입니다. json 형식만 지원됩니다.
LatLongPair

위도 및 경도로 표시되는 위치입니다.
RadiusSector

베어링 0-90 = NE 사분면; 90–180 = SE 사분면; 180–270 = SW 사분면; 270-360 = NW 사분면.
StormForecast

정부가 발행한 폭풍 예보
StormForecastResult

정부에서 발행한 예측 목록
StormWindRadiiSummary

요청에 details=true 또는 radiiGeometry=true일 때 표시됩니다.
UnitType

표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요.
WeatherDataUnit

메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다.
WeatherUnit

날씨와 관련된 지정된 단위의 특정 값입니다.
WeatherWindow

폭풍에 대한 예측 창

basinId

분지 식별자

Name 형식 Description
AL

string

대서양
CP

string

중앙 태평양
EP

string

동부 태평양
NI

string

북인도양
NP

string

북서 태평양
SI

string

인도양 남서부
SP

string

남태평양

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

GeoJsonGeometry

유효한 GeoJSON geometry 개체입니다. 이 형식은 Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon 및 GeometryCollection의 7가지 유효한 GeoJSON 기하 도형 형식 중 하나여야 합니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
type

GeoJsonObjectType

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonGeometryCollection

유효한 개체 형식입니다 GeoJSON GeometryCollection . 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
geometries GeoJsonGeometry[]:

유효한 GeoJSON 기하 도형 개체 목록을 포함합니다. GeoJSON의 좌표는 x, y 순서(경도, 위도)입니다.
type string:

GeometryCollection

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonLineString

유효한 GeoJSON LineString 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

기하 도형의 GeoJson LineString 좌표입니다.
type string:

LineString

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonMultiLineString

유효한 GeoJSON MultiLineString 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

기하 도형의 GeoJson MultiLineString 좌표입니다.
type string:

MultiLineString

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonMultiPoint

유효한 GeoJSON MultiPoint 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

기하 도형의 GeoJson MultiPoint 좌표입니다.
type string:

MultiPoint

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonMultiPolygon

유효한 개체 형식입니다 GeoJSON MultiPolygon . 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

유효한 GeoJSON Polygon 개체 목록을 포함합니다. GeoJSON의 좌표는 x, y 순서(경도, 위도)입니다.
type string:

MultiPolygon

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonPoint

유효한 GeoJSON Point 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

Position 은 둘 이상의 요소가 있는 숫자 배열입니다. 처음 두 요소는 경도 와 위도이며 정확히 그 순서로 표시됩니다. 고도/상승 은 선택적 세 번째 요소입니다. 자세한 내용은 RFC 7946 을 참조하세요.
type string:

Point

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

GeoJsonPolygon

유효한 GeoJSON Polygon 기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.

Name 형식 Description
coordinates

number[]

기하 도형 형식의 GeoJson Polygon 좌표입니다.
type string:

Polygon

GeoJSON 유형을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature 및 FeatureCollection 등 9가지 유효한 GeoJSON 개체 형식 중 하나여야 합니다.

JsonFormat

원하는 응답 형식입니다. json 형식만 지원됩니다.

Name 형식 Description
json

string

JavaScript 개체 표기법 데이터 교환 형식

LatLongPair

위도 및 경도로 표시되는 위치입니다.

Name 형식 Description
latitude

number

위도 속성
longitude

number

경도 속성

RadiusSector

베어링 0-90 = NE 사분면; 90–180 = SE 사분면; 180–270 = SW 사분면; 270-360 = NW 사분면.

Name 형식 Description
beginBearing

number

사분면의 시작 부분의 베어링(도)입니다.
endBearing

number

사분면 끝의 베어링(도)입니다.
range

number

사분면의 반경(해상 마일)입니다.

StormForecast

정부가 발행한 폭풍 예보

Name 형식 Description
dateTime

string

예측이 유효한 날짜/시간이며 ISO8601 형식으로 표시됩니다.
initializedDateTime

string

예측이 만들어진 날짜/시간은 ISO8601 형식으로 표시됩니다.
location

LatLongPair

폭풍의 좌표
maxWindGust

WeatherUnit

폭풍과 관련된 최대 돌풍 속도입니다. NULL일 수 있습니다.
status

string

가능한 상태 값은 다음과 같습니다.

  • 사이클로닉 폭풍
  • 깊은 우울증
  • 우울증
  • 매우 심각한 순환 폭풍
  • 허리케인 범주(1-5)
  • 강렬한 열대 저기압
  • 적당한 열대 폭풍
  • 열대 후 저기압
  • 잠재적인 열대 저기압
  • 심한 순환 폭풍
  • 심한 열대 폭풍
  • 아열대
  • 슈퍼 사이클론 폭풍
  • 열대 저기압
  • 열대 저기압 범주(1-5)
  • 열대 우울증
  • 열대 교란
  • 열대 폭풍
  • 태풍
  • 매우 강렬한 열대 저기압
  • 매우 심각한 순환 폭풍
  • 매우 강한 태풍
  • 폭력적인 태풍
sustainedWind

WeatherUnit

폭풍과 관련된 최대 지속 풍속입니다. NULL일 수 있습니다.
windRadiiSummary

StormWindRadiiSummary[]

요청에 details=true 또는 radiiGeometry=true일 때 표시됩니다.
window

WeatherWindow

지정된 기간 동안 폭풍에 대한 예측 창에 대한 정보를 포함합니다(전체 원뿔이 아님). 요청에서 windowGeometry=true이면 이 개체에는 창 기하 도형에 대한 geoJSON 세부 정보가 포함됩니다.

StormForecastResult

정부에서 발행한 예측 목록

Name 형식 Description
nextLink

string

는 반환된 기능의 다음 페이지에 대한 링크입니다. 마지막 페이지인 경우 이 필드가 없습니다.
results

StormForecast[]

정부에서 발행한 예측 목록

StormWindRadiiSummary

요청에 details=true 또는 radiiGeometry=true일 때 표시됩니다.

Name 형식 Description
dateTime

string

바람 반지름 요약 데이터가 유효한 DateTime이며 ISO8601 형식으로 표시됩니다.
radiiGeometry GeoJsonGeometry:

GeoJSON 개체입니다. 요청에 radiiGeometry=true일 때 표시됩니다. 바람 반경 사분면의 윤곽선을 설명합니다.
radiusSectorData

RadiusSector[]

바람 반경 사분면을 그리는 데 필요한 정보를 포함합니다. 베어링 0-90 = NE 사분면; 90-180 = SE 사분면; 180–270 = SW 사분면; 270-360 = NW 사분면.
windSpeed

WeatherUnit

radiusSectorData와 연결된 풍속입니다.

UnitType

표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요.

Name 형식 Description
0

Integer

1

Integer

10

Integer

11

Integer

12

Integer

13

Integer

14

Integer

15

Integer

16

Integer

17

Integer

18

Integer

19

Integer

2

Integer

20

Integer

21

Integer

22

Integer

3

Integer

31

Integer

4

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

WeatherDataUnit

메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다.

Name 형식 Description
imperial

string

임페리얼 단위로 데이터를 반환합니다. 제국 시스템의 몇 가지 예 단위는 화씨와 마일입니다.
metric

string

메트릭 단위로 데이터를 반환합니다. 메트릭 시스템의 몇 가지 예제 단위는 섭씨 및 킬로미터입니다.

WeatherUnit

날씨와 관련된 지정된 단위의 특정 값입니다.

Name 형식 Description
unit

string

반환된 값의 단위 유형입니다.
unitType

UnitType

표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요.
value

number

반올림된 값입니다.

WeatherWindow

폭풍에 대한 예측 창

Name 형식 Description
beginDateTime

string

ISO8601 형식으로 표시된 이동 창의 시작 부분의 DateTime입니다.
beginStatus

string

창의 시작 부분에 폭풍 상태.
endDateTime

string

이동 창 끝의 DateTime이며 ISO8601 형식으로 표시됩니다.
endStatus

string

창 끝에 폭풍 상태.
geometry GeoJsonGeometry:

요청에서 windowGeometry=true일 때 표시됩니다. 지정된 기간 동안의 이동 창을 설명하는 좌표를 포함하는 GeoJSON 개체입니다.
left

LatLongPair

기간의 시간에 창의 왼쪽에 있는 점의 위치입니다.
right

LatLongPair

기간의 끝에 있는 창의 오른쪽에 있는 지점의 위치입니다.