Weather - Get Daily Forecast
다음 1일, 5일, 10일, 15일, 25일 또는 45일 동안의 자세한 일기 예보를 가져오는 데 사용합니다.
API는 Get Daily Forecast 지정된 좌표 위치에 대해 다음 1, 5, 10, 15, 25 또는 45일 동안의 일별 온도 및 바람과 같은 자세한 일기 예보를 반환하는 HTTP GET 요청입니다. 응답에는 온도, 바람, 강수량, 대기 질 및 UV 지수와 같은 세부 정보가 포함됩니다. 자세한 내용은 일일 일기 예보 데이터 요청을 참조하세요.
Gen1 S0 가격 책정 계층을 사용하는 경우 다음 1일, 5일, 10일 및 15일에 대한 일일 예측을 요청할 수 있습니다. Gen1 S1 또는 Gen2 가격 책정 계층을 사용하는 경우 향후 25일 및 45일에 대한 일일 예측을 요청할 수도 있습니다.
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
format
|
path | True |
원하는 응답 형식입니다.
|
|
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
|
query
|
query | True |
number[] |
위도와 경도로 구성된 쉼표로 구분된 문자열로 지정된 해당 쿼리입니다(예: "47.641268,-122.125679"). 날씨 정보는 일반적으로 육지, 육지로 둘러싸인 수역 및 해안선에서 약 50해리 이내에 있는 해양 지역의 위치에 대해 사용할 수 있습니다. |
|
duration
|
query |
integer |
일일 예측 응답이 반환되는 일 수를 지정합니다. 사용 가능한 값은 다음과 같습니다
|
|
|
language
|
query |
string |
검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어 참조하세요. |
|
|
unit
|
query |
데이터를 미터법 단위 또는 영국식 단위로 반환하도록 지정합니다. 기본값은 metric입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 나타냅니다. Azure Maps 계정에 대한 이 고유 ID는 Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하는 방법에 대한 자세한 내용은 Azure Maps에서 인증 관리를 참조하세요. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름에
시나리오를 구현하려면
Notes
- 이 보안 정의
x-ms-client-id헤더를 사용하여 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.
Authorization URL Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Azure Portal에서 Azure Maps 계정 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 키를 안전하게 저장할 수 있도록 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 Azure Maps REST API에 액세스하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Successfully retrieve detailed daily weather forecast for a given coordinate location
샘플 요청
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
샘플 응답
{
"summary": {
"startDate": "2019-11-17T09:00:00-08:00",
"endDate": "2019-11-17T15:00:00-08:00",
"severity": 5,
"phrase": "Rain Sunday evening",
"category": "rain"
},
"forecasts": [
{
"date": "2019-11-13T21:00:00-08:00",
"temperature": {
"minimum": {
"value": 0.8,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 5.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperature": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperatureShade": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.6,
"unit": "C",
"unitType": 17
}
},
"hoursOfSun": 1.1,
"degreeDaySummary": {
"heating": {
"value": 15,
"unit": "C",
"unitType": 17
},
"cooling": {
"value": 0,
"unit": "C",
"unitType": 17
}
},
"airAndPollen": [
{
"name": "AirQuality",
"value": 0,
"category": "Good",
"categoryValue": 1,
"type": "Ozone"
},
{
"name": "Grass",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Mold",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Ragweed",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Tree",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "UVIndex",
"value": 0,
"category": "Low",
"categoryValue": 1
}
],
"day": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Cloudy with a few showers",
"longPhrase": "Cloudy with a couple of showers, mainly later",
"precipitationProbability": 75,
"thunderstormProbability": 20,
"rainProbability": 75,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 16.7,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 48.2,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 3.5,
"hoursOfRain": 3.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 100
},
"night": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Breezy early; cloudy",
"longPhrase": "Breezy this evening; otherwise, low clouds",
"precipitationProbability": 65,
"thunderstormProbability": 0,
"rainProbability": 64,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 181,
"localizedDescription": "S"
},
"speed": {
"value": 20.4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 2.5,
"hoursOfRain": 2.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 98
},
"sources": [
"AccuWeather"
]
}
]
}
정의
| Name | Description |
|---|---|
|
Air |
AirAndPollen 객체는 포괄적인 환경 데이터를 제공합니다. 나무, 풀, 돼지풀, 곰팡이 등 다양한 꽃가루 유형과 PM2.5, PM10, O3, NO2, SO2, CO를 포함한 오염물질을 식별합니다. 또한, UV 지수를 1에서 10까지 측정하고, 대기질 또는 꽃가루 농도에 대한 정성적 설명을 제공하며, 공기 중 오염물질 또는 꽃가루 농도에 대한 수치적 측정도 제공합니다. 이 상세한 정보는 사용자가 이동 경로상의 대기질과 꽃가루 상태를 평가하는 데 도움을 줍니다. |
|
Daily |
특정 날짜의 기온, 바람, 강수량, 대기질, 자외선 지수 등 상세한 기상 정보를 제공합니다. |
|
Daily |
|
|
Daily |
요청된 기간의 기본 조건에 대한 요약입니다. 요약은 기간의 일부만 다룰 수 있습니다. |
|
Day |
|
|
Degree |
|
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Icon |
속성에서 |
|
Json |
원하는 응답 형식입니다.
|
|
Local |
지역 날씨 데이터 공급자 정보. |
|
Precipitation |
강수량 유형을 지정합니다. 유효한 값은 Rain, Snow, Ice 또는 Mix입니다. 이 속성은 dBZ가 0보다 클 때 응답에 포함됩니다. |
|
Unit |
단위 유형을 나타내는 정수입니다. 예를 들어, 섭씨는 17, 화씨는 18입니다. 단위 변환에 사용할 수 있습니다. 전체 목록은 Azure Maps의 날씨 서비스를 참조하세요. |
|
Weather |
데이터를 미터법 단위 또는 영국식 단위로 반환하도록 지정합니다. 기본값은 metric입니다. |
|
Weather |
날씨와 관련된 주어진 단위의 특정 값입니다. |
|
Weather |
반환된 온도 값. |
|
Wind |
속도와 방향을 포함한 바람 세부 정보가 반환됩니다. |
|
Wind |
풍향 |
AirAndPollen
AirAndPollen 객체는 포괄적인 환경 데이터를 제공합니다. 나무, 풀, 돼지풀, 곰팡이 등 다양한 꽃가루 유형과 PM2.5, PM10, O3, NO2, SO2, CO를 포함한 오염물질을 식별합니다. 또한, UV 지수를 1에서 10까지 측정하고, 대기질 또는 꽃가루 농도에 대한 정성적 설명을 제공하며, 공기 중 오염물질 또는 꽃가루 농도에 대한 수치적 측정도 제공합니다. 이 상세한 정보는 사용자가 이동 경로상의 대기질과 꽃가루 상태를 평가하는 데 도움을 줍니다.
| Name | 형식 | Description |
|---|---|---|
| category |
string |
지정된 언어로 예보 기간의 대기질 또는 꽃가루 수준을 한 단어로 정성적으로 설명합니다. 이 특성은 공기질 또는 꽃가루 수를 낮음, 높음, 좋음, 보통, 건강에 해롭거나 위험한 여러 수준으로 분류하여 사용자가 현재 상황을 이해하기 쉽게 평가할 수 있도록 합니다. |
| categoryValue |
integer (int32) |
대기질 또는 꽃가루 수준을 수치로 표현합니다. 이 값은 정성적 |
| name |
string |
꽃가루에 대해: 나무, 풀, 돼지풀, 곰팡이 등 꽃가루의 이름을 반환합니다.
오염물질에 대해: 재산이
UV 지수에 대해: 속성이
|
| type |
string |
측정 대상 대기 오염물질의 종류를 지정합니다. 부동산이 |
| value |
integer (int32) |
공기 중 오염물질 또는 꽃가루의 농도를 수치적으로 측정합니다. 이 값은 일반적으로 측정되는 오염물질 또는 꽃가루의 종류에 따라 단위로 표현되며, 미세먼지의 경우 마이크로그램/세제곱미터(μg/m³), 오존과 같은 기체의 경우 십억분의 일(ppb)로 표현됩니다. 공기질과 UV는 모두 지표이므로 단위가 없습니다. |
DailyForecast
특정 날짜의 기온, 바람, 강수량, 대기질, 자외선 지수 등 상세한 기상 정보를 제공합니다.
| Name | 형식 | Description |
|---|---|---|
| airAndPollen |
오염물질, 꽃가루 농도, 그리고 일일 예보용 자외선 지수가 포함된 목록입니다. 각 목록 항목에는 잠재적 건강 위험을 평가하기 위해 예측된 양과 범주(예: 낮음, 높음, 좋음, 보통, 중간, 비건강, 위험함)가 포함되어 있습니다. |
|
| date |
string (date-time) |
현재 관측의 날짜와 시간은 ISO 8601 형식으로 표시됨 (yyyy-mm-ddThh:mm:ss-hh:mm). 예를 들어, 2025-04-29T07:00:00-07:00. |
| day |
온도, 강수량, 바람 및 기타 주요 속성을 포함한 주간 일기예보에 대한 상세한 기상 정보를 제공합니다. |
|
| degreeDaySummary |
난방 및 냉방 등급 일수 요약을 제공합니다. 난방 등급일(HDD)은 하루 평균 기온이 65°F/18°C 이하인 도수를 기준으로 건물 난방에 필요한 에너지 수요를 측정합니다. 냉각 등급일수(CDD)는 하루 평균 기온이 65°F/18°C를 초과하는 도수를 기준으로 건물을 냉방하기 위한 에너지 수요를 측정합니다. 이 요약은 에너지 관리와 계획에 도움을 줍니다. |
|
| hoursOfSun |
number (float) |
지정된 날의 예상 일조 시간을 제공합니다. |
| night |
야간 기상 예보에 대한 기온, 강수량, 바람 및 기타 주요 속성 등 상세한 기상 정보를 제공합니다. |
|
| realFeelTemperature |
요청에 명시된 단위에 따라 섭씨(C) 또는 화씨(F) 단위로 측정된 RealFeel™ 온도 값을 제공합니다. AccuWeather가 개발한 이 지표는 습도, 풍속, 구름 덮개, 태양 강도 등 12개 이상의 요소를 포함해 실제 날씨가 어떻게 느껴지는지 종합적으로 측정할 수 있습니다. |
|
| realFeelTemperatureShade |
지정된 날의 그늘진 지역에서 RealFeel™ 온도 값을 제공합니다. AccuWeather가 개발한 이 지표는 습도, 풍속, 구름 덮개, 햇빛 강도 등 12개 이상의 요소를 포함해 그늘에서 실제로 느껴지는 날씨를 종합적으로 측정할 수 있습니다. |
|
| sources |
string[] |
기상 예보 데이터에 기여한 출처 목록입니다. |
| temperature |
요청에 명시된 조건 |
DailyForecastResult
| Name | 형식 | Description |
|---|---|---|
| forecasts |
요청된 각 날짜에 대한 데이터를 예측합니다. |
|
| summary |
요청된 기간의 기본 조건에 대한 요약입니다. 요약은 기간의 일부만 다룰 수 있습니다. |
DailyForecastSummary
요청된 기간의 기본 조건에 대한 요약입니다. 요약은 기간의 일부만 다룰 수 있습니다.
| Name | 형식 | Description |
|---|---|---|
| category |
string |
맑음, 부분 흐림, 비, 눈 등 예보된 기상 조건을 한두 단어로 요약합니다. |
| endDate |
string (date-time) |
예보 요약의 종료일과 시간은 ISO 8601 형식(yyyy-mm-ddThh:mm:ss-hh:mm)으로 제공됩니다. 예를 들어, 2025-04-29T07:00:00-07:00. |
| phrase |
string |
지정된 언어로 표시된 일일 기상 상황에 대한 간단한 텍스트 요약을 제공합니다. |
| severity |
integer (int32) |
예보된 날씨의 심각성을 정수로 나타냅니다. 낮은 숫자는 더 높은 중증도를 나타냅니다: 0 = 미지, 1 = 중요, 2 = 중대, 3 = 중간, 4 = 경미, 5 = 최소, 6 = 중요하지 않음, 7 = 정보 포함. |
| startDate |
string (date-time) |
예보 요약의 시작일과 시간은 ISO 8601 형식(yyyy-mm-ddThh:mm:ss-hh:mm)입니다. 예를 들어, 2025-04-29T07:00:00-07:00. |
DayOrNight
| Name | 형식 | Description |
|---|---|---|
| cloudCover |
integer (int32) |
구름 덮개를 나타내는 백분율입니다. |
| hasPrecipitation |
boolean |
지정된 기간 동안 강수량(비, 눈, 진눈깨비, 우박)이 예상되는지 나타내는 불리언 값입니다. 강수가 예상되면 참을 반환하고, 그렇지 않으면 거짓임을 반환합니다. |
| hoursOfIce |
number (float) |
얼음의 시간. |
| hoursOfPrecipitation |
number (float) |
강수량 시간 |
| hoursOfRain |
number (float) |
몇 시간 동안 비가 내립니다. |
| hoursOfSnow |
number (float) |
몇 시간 동안 눈이 내립니다. |
| ice |
Ice |
|
| iceProbability |
integer (int32) |
얼음이 있을 확률을 나타내는 백분율입니다. 예를 들어 '30'입니다. |
| iconCode |
Icon |
속성에서 |
| iconPhrase |
string |
아이콘에 대한 구문 설명입니다. 지정된 언어로 표시됩니다. 예를 들어 'Sunny'입니다. |
| localSource |
지역 날씨 데이터 공급자 정보. |
|
| longPhrase |
string |
지정된 언어로 된 예측에 대한 구문 설명입니다. Azure Maps는 이 구문의 길이를 100자 미만으로 유지하려고 시도하지만 일부 언어/날씨 이벤트로 인해 100자를 초과하여 구문 길이가 길어질 수 있습니다. |
| precipitationIntensity |
string |
강도에 대한 설명입니다. |
| precipitationProbability |
integer (int32) |
강수 확률을 나타내는 백분율입니다. 예를 들어 '20'입니다. |
| precipitationType |
강수량 유형을 지정합니다. 유효한 값은 Rain, Snow, Ice 또는 Mix입니다. 이 속성은 dBZ가 0보다 클 때 응답에 포함됩니다. |
|
| rain |
Rain |
|
| rainProbability |
integer (int32) |
비가 올 확률을 나타내는 백분율입니다. 예를 들어 '40'입니다. |
| shortPhrase |
string |
지정된 언어로 된 예측에 대한 구문 설명입니다. Azure Maps는 이 구문의 길이를 30자 미만으로 유지하려고 시도하지만 일부 언어/날씨 이벤트로 인해 30자를 초과하는 구문 길이가 길어질 수 있습니다. |
| snow |
Snow |
|
| snowProbability |
integer (int32) |
눈이 올 확률을 나타내는 백분율입니다. 예를 들어 '30'입니다. |
| thunderstormProbability |
integer (int32) |
뇌우의 확률을 나타내는 백분율입니다. 예를 들어 '80'입니다. |
| totalLiquid |
예측 기간 동안 강수량의 총 액체 등가물. |
|
| wind |
속도와 방향을 포함한 바람 세부 정보가 반환됩니다. |
|
| windGust |
돌풍. 돌풍은 바람의 속도가 갑작스럽고 짧게 증가하는 것입니다. |
DegreeDaySummary
| Name | 형식 | Description |
|---|---|---|
| cooling |
평균 온도가 65°F/18°C 이상인 각도입니다. |
|
| heating |
평균 온도가 화씨 65도/섭씨 18도 미만인 각도의 수입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
IconCode
속성에서 Phrase 설명하는 현재 기상 조건에 해당하는 이미지를 나타내는 숫자 값입니다. 자세한 내용은 Azure Maps의 날씨 서비스를 참조하세요. NULL일 수 있습니다.
| 값 | Description |
|---|---|
| 1 |
Sunny |
| 2 |
대체로 맑음 |
| 3 |
부분적으로 맑음 |
| 4 |
간헐적인 구름 |
| 5 |
흐릿한 선샤인 |
| 6 |
대체로 흐림 |
| 7 |
Cloudy |
| 8 |
음울한 (흐림) |
| 9 | |
| 10 | |
| 11 |
Fog |
| 12 |
Showers |
| 13 |
대부분 흐림, 적은 양의 비 |
| 14 |
부분적으로 맑음, 적은 양의 비 |
| 15 |
Thunderstorms |
| 16 |
대부분 흐림, 천둥번개 |
| 17 |
부분적으로 맑음, 천둥번개 |
| 18 |
Rain |
| 19 |
Flurries |
| 20 |
대부분 흐림, 적은 양의 눈 |
| 21 |
부분적으로 맑음, 적은 양의 눈 |
| 22 |
Snow |
| 23 |
대부분 흐림, 눈 |
| 24 |
Ice |
| 25 |
Sleet |
| 26 |
얼어붙은 비 |
| 27 | |
| 28 | |
| 29 |
비와 눈 |
| 30 |
Hot |
| 31 |
Cold |
| 32 |
Windy |
| 33 |
Clear |
| 34 |
대부분 맑음 |
| 35 |
부분적으로 흐림 |
| 36 |
간헐적인 구름 (밤) |
| 37 |
흐릿한 달빛 |
| 38 |
대체로 흐림 (밤) |
| 39 |
부분적으로 흐림, 적은 양의 비 |
| 40 |
대체로 흐리고 소나기 (밤) |
| 41 |
부분적으로 흐림, 천둥번개 |
| 42 |
대체로 구름 많고 천둥 번개가 치다 (밤) |
| 43 |
대체로 흐리고 바람이 불음 (밤) |
| 44 |
대체로 흐리고 눈이 내림 (밤) |
JsonFormat
원하는 응답 형식입니다.
json 형식만 지원됩니다.
| 값 | Description |
|---|---|
| json |
LocalSource
지역 날씨 데이터 공급자 정보.
| Name | 형식 | Description |
|---|---|---|
| id |
integer (int32) |
로컬 데이터 공급자에 고유한 숫자 식별자입니다. |
| name |
string |
로컬 데이터 공급자의 이름입니다. 이름은 URL의 언어 코드로 지정된 언어로 표시됩니다(사용 가능한 경우). 그렇지 않으면 Name이 영어 또는 이름이 제공된 언어로 표시됩니다. |
| weatherCode |
string |
로컬 데이터 공급자가 제공한 날씨 코드입니다. 이 날씨 코드를 사용하면 Azure Maps 아이콘 대신 로컬 데이터 공급자가 제공하는 아이콘과 예측을 일치시킬 수 있습니다. |
PrecipitationType
강수량 유형을 지정합니다. 유효한 값은 Rain, Snow, Ice 또는 Mix입니다. 이 속성은 dBZ가 0보다 클 때 응답에 포함됩니다.
| 값 | Description |
|---|---|
| Ice |
Ice |
| Mix |
Mix |
| Rain |
Rain |
| Snow |
Snow |
UnitType
단위 유형을 나타내는 정수입니다. 예를 들어, 섭씨는 17, 화씨는 18입니다. 단위 변환에 사용할 수 있습니다. 전체 목록은 Azure Maps의 날씨 서비스를 참조하세요.
| 값 | Description |
|---|---|
| 0 |
feet |
| 1 |
inches |
| 2 |
miles |
| 3 |
millimeter |
| 4 |
centimeter |
| 5 |
meter |
| 6 |
kilometer |
| 7 |
kilometersPerHour |
| 8 |
knots |
| 9 |
milesPerHour |
| 10 |
metersPerSecond |
| 11 |
hectoPascals |
| 12 |
inchesOfMercury |
| 13 |
kiloPascals |
| 14 |
millibars |
| 15 |
millimetersOfMercury |
| 16 |
poundsPerSquareInch |
| 17 |
Celsius |
| 18 |
Fahrenheit |
| 19 |
kelvin |
| 20 |
percent |
| 21 |
float |
| 22 |
integer |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
데이터를 미터법 단위 또는 영국식 단위로 반환하도록 지정합니다. 기본값은 metric입니다.
| 값 | Description |
|---|---|
| imperial |
온도의 경우 화씨(F), 거리의 경우 마일(mi)과 같은 영국식 단위를 사용하여 데이터를 반환합니다. |
| metric |
온도의 경우 섭씨(C), 거리의 경우 킬로미터(km)와 같은 미터법 단위를 사용하여 데이터를 반환합니다. |
WeatherUnit
날씨와 관련된 주어진 단위의 특정 값입니다.
| Name | 형식 | Description |
|---|---|---|
| unit |
string |
반환된 값의 단위 유형입니다. |
| unitType |
Unit |
단위 유형을 나타내는 정수입니다. 예를 들어, 섭씨는 17, 화씨는 18입니다. 단위 변환에 사용할 수 있습니다. 전체 목록은 Azure Maps의 날씨 서비스를 참조하세요. |
| value |
number (float) |
반올림된 값입니다. |
WeatherUnitRange
반환된 온도 값.
| Name | 형식 | Description |
|---|---|---|
| maximum |
해당 기간의 최대 온도 |
|
| minimum |
해당 기간의 최저 온도입니다. |
WindDetails
속도와 방향을 포함한 바람 세부 정보가 반환됩니다.
| Name | 형식 | Description |
|---|---|---|
| direction |
풍향 |
|
| speed |
지정된 단위의 바람 속도입니다. |
WindDirection
풍향
| Name | 형식 | Description |
|---|---|---|
| degrees |
integer (int32) |
방위각도의 바람 방향으로, 진북에서 시작하여 시계 방향으로 계속됩니다. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다. 가능한 값은 0-359입니다. |
| localizedDescription |
string |
지정된 언어의 방향 약어입니다. |