Share via


Weather - Get Tropical Storm Locations

개별 국가 일기 예보 기관에서 열대 폭풍의 위치를 얻기 위해 사용합니다.

Get Tropical Storm Locations API는 정부에서 발급한 개별 열대 폭풍의 위치를 반환하는 HTTP GET 요청입니다. 열대 폭풍에 대한 정보에는 위치 좌표, 기하 도형, 분지 ID, 날짜, 바람 세부 정보 및 바람 반경이 포함됩니다.

GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&details={details}&radiiGeometry={radiiGeometry}&unit={unit}&current={current}

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

사이클론의 해

current
query

boolean

true이면 현재 폭풍 위치를 반환합니다.

details
query

boolean

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

radiiGeometry
query

boolean

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

unit
query

WeatherDataUnit

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

요청 헤더

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

StormLocationsResult

정상

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 Current Location
Get Tropical Storm Locations

Get Tropical Storm Current Location

Sample Request

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

Sample Response

{
  "results": [
    {
      "dateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 21.7,
        "longitude": 134.1
      },
      "maxWindGust": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 115,
          "localizedDescription": "ESE"
        },
        "speed": {
          "value": 22.2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    }
  ]
}

Get Tropical Storm Locations

Sample Request

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

Sample Response

{
  "results": [
    {
      "dateTime": "2021-02-22T00:00:00+00:00",
      "location": {
        "latitude": 10.4,
        "longitude": 125.7
      },
      "maxWindGust": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 46.3,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 305,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Depression"
    },
    {
      "dateTime": "2021-02-21T18:00:00+00:00",
      "location": {
        "latitude": 10.2,
        "longitude": 125.9
      },
      "maxWindGust": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 46.3,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 300,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 22.2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Depression"
    },
    {
      "dateTime": "2021-02-21T12:00:00+00:00",
      "location": {
        "latitude": 10.3,
        "longitude": 125.8
      },
      "maxWindGust": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 300,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 42.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-19T06:00:00+00:00",
      "location": {
        "latitude": 7.2,
        "longitude": 129.8
      },
      "maxWindGust": {
        "value": 101.9,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 270,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 18.5,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-19T00:00:00+00:00",
      "location": {
        "latitude": 7.2,
        "longitude": 131.2
      },
      "maxWindGust": {
        "value": 101.9,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 270,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-18T18:00:00+00:00",
      "location": {
        "latitude": 7.2,
        "longitude": 131.7
      },
      "maxWindGust": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 270,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-18T12:00:00+00:00",
      "location": {
        "latitude": 7.3,
        "longitude": 131.8
      },
      "maxWindGust": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 270,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-18T06:00:00+00:00",
      "location": {
        "latitude": 7.3,
        "longitude": 132.1
      },
      "maxWindGust": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 305,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-18T00:00:00+00:00",
      "location": {
        "latitude": 7,
        "longitude": 132.6
      },
      "maxWindGust": {
        "value": 83.3,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 290,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Storm"
    },
    {
      "dateTime": "2021-02-17T18:00:00+00:00",
      "location": {
        "latitude": 7,
        "longitude": 132.7
      },
      "maxWindGust": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 55.6,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 290,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Depression"
    },
    {
      "dateTime": "2021-02-17T12:00:00+00:00",
      "location": {
        "latitude": 6.8,
        "longitude": 132.4
      },
      "maxWindGust": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 55.6,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 285,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Depression"
    },
    {
      "dateTime": "2021-02-17T06:00:00+00:00",
      "location": {
        "latitude": 6.6,
        "longitude": 133.1
      },
      "maxWindGust": {
        "value": 64.8,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 46.3,
        "unit": "km/h",
        "unitType": 7
      },
      "movement": {
        "direction": {
          "degrees": 270,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 22.2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "status": "Tropical Depression"
    }
  ]
}

정의

Name Description
basinId

분지 식별자

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

GeoJsonGeometry

유효한 GeoJSON 기하 도형 개체입니다. 형식은 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 사분면.

StormLocation

정부가 발행한 개별 폭풍의 위치

StormLocationsResult

정부가 발행한 개별 폭풍의 위치

StormWindRadiiSummary

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

UnitType

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

WeatherDataUnit

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

WeatherUnit

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

WindDetails

속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다.

WindDirection

풍향

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 기하 도형 개체입니다. 형식은 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

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

StormLocation

정부가 발행한 개별 폭풍의 위치

Name 형식 Description
dateTime

string

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

hasTropicalPotential

boolean

폭풍이 열대 시스템으로 발전 할 수있는 경우 True입니다.

isPostTropical

boolean

폭풍이 약해지고 더 이상 열대 시스템이 되지 않을 때 True입니다.

isSubtropical

boolean

우울증이 아열대 사이클론으로 분류 될 때 사실입니다.

location

LatLongPair

폭풍의 좌표

maxWindGust

WeatherUnit

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

minimumPressure

WeatherUnit

폭풍과 관련된 최소 압력입니다. NULL일 수 있습니다.

movement

WindDetails

폭풍 이동 정보입니다.

status

string

Storm 상태 영어로 제공됩니다.

sustainedWind

WeatherUnit

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

windRadiiSummary

StormWindRadiiSummary[]

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

StormLocationsResult

정부가 발행한 개별 폭풍의 위치

Name 형식 Description
nextLink

string

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

results

StormLocation[]

정부가 발행한 개별 폭풍의 위치

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

반올림된 값입니다.

WindDetails

속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다.

Name 형식 Description
direction

WindDirection

풍향

speed

WeatherUnit

지정된 단위의 바람 속도입니다.

WindDirection

풍향

Name 형식 Description
degrees

integer

진북에서 시작하여 시계 방향으로 계속되는 아지무스도의 바람 방향. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다. 가능한 값은 0-359입니다.

localizedDescription

string

지정된 언어의 방향 약어입니다.