Weather - Get Weather Along Route
를 사용하여 경로를 따라 기상 위험 평가 및 알림을 포함하는 위치 정확하고 최신 예측을 가져옵니다.
Get Weather Along Route
API는 하이퍼 로컬(1킬로미터 이하), 최신 날씨 지금 캐스팅, 날씨 위험 평가 및 일련의 웨이포인트로 설명된 경로를 따라 알림을 반환하는 HTTP GET
요청입니다.
여기에는 웨이포인트 또는 경로에 영향을 주는 기상 위험 목록이 포함되며, 각 웨이포인트에 대해 집계된 위험 인덱스를 사용하여 운전자에게 얼마나 안전한지에 따라 경로의 각 부분을 그릴 수 있습니다. 웨이포인트를 제출할 때는 120분 이내 또는 그 직후에 이동할 수 있는 거리 내에 있거나 가까운 거리에 머무르는 것이 좋습니다. 데이터는 5분마다 업데이트됩니다.
이 서비스는 먼저 원본과 대상 간의 경로를 요청하고 이를 Weather Along Route 엔드포인트에 대한 입력으로 사용할 수 있는 Azure Maps Route Service 를 보완합니다.
또한 이 서비스는 날씨 위험 강도가 증가하는 웨이포인트에 대한 날씨 알림을 생성하는 시나리오를 지원합니다. 예를 들어, 차량이 중간 지점에 도달할 때 폭우가 발생하기 시작할 것으로 예상되는 경우, 해당 웨이포인트에 대한 날씨 알림이 생성되어 최종 제품이 운전자가 해당 웨이포인트에 도달하기 전에 폭우 알림을 표시할 수 있습니다. 웨이포인트에 대한 알림을 표시하는 경우에 대한 트리거는 예를 들어 지오펜스 또는 웨이포인트까지의 선택 가능한 거리를 기반으로 할 수 있습니다.
API는 그린란드와 남극 대륙 위의 위도를 제외한 지구의 모든 지역을 다룹니다.
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}&language={language}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다.
|
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. |
query
|
query | True |
string |
경로를 계산하고 콜론(:))으로 구분하고 시간순으로 입력하는 좌표입니다. 최소 두 개의 웨이포인트가 필요합니다. 단일 API 호출에는 최대 60개의 웨이포인트가 포함될 수 있습니다. 웨이포인트는 위치, ETA 및 선택적 제목을 나타냅니다. 위도, 경도, ETA, 제목, 위치
120분 이내 또는 그 직후에 이동할 수 있는 거리 내에 있거나 가까운 거리에 머무르는 것이 좋습니다. 이렇게 하면 여정에 대해 보다 정확한 평가를 제공하고 웨이포인트 간에 격리된 이벤트가 캡처되지 않도록 방지할 수 있습니다. 정보는 경로를 따라 업데이트될 수 있으며(특히 2시간 초과의 경우) 지속적으로 새로운 웨이포인트를 끌어오고 강수량 유형 및 강도와 같은 콘텐츠에 대한 예측 정보가 시간이 지남에 따라 폭풍이 발전하고 사라질 때 정확한지 확인할 수 있도록 해야 합니다. |
language
|
query |
string |
검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어를 참조하세요. |
요청 헤더
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 |
정상 |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 페어링하면 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.
참고
- 이 보안 정의 에서는 헤더를 사용하여 애플리케이션이
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 웹 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 Maps 리소스 의 SAS 나열 작업에서 생성된 공유 액세스 서명 토큰입니다.
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Successfully retrieve detailed weather casts along a route described as a sequence of waypoints
샘플 요청
GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query=38.907,-77.037,0:38.907,-77.009,10:38.926,-76.928,20:39.033,-76.852,30:39.168,-76.732,40:39.269,-76.634,50:39.287,-76.612,60
샘플 응답
{
"summary": {
"iconCode": 35,
"hazards": {
"maxHazardIndex": 0
}
},
"waypoints": [
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 70,
"temperature": {
"value": 3.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 142
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 3,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 90,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 65,
"temperature": {
"value": 3.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 166
},
"speed": {
"value": 1,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 77,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 43,
"temperature": {
"value": 3.2,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 163
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 44,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 34,
"temperature": {
"value": 1.6,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 189
},
"speed": {
"value": 2,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 32,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 38,
"shortPhrase": "Mostly cloudy",
"isDayTime": false,
"cloudCover": 54,
"temperature": {
"value": 0.5,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 202
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 36,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 46,
"temperature": {
"value": 2.4,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 222
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 38,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
},
{
"iconCode": 35,
"shortPhrase": "Partly cloudy",
"isDayTime": false,
"cloudCover": 39,
"temperature": {
"value": 2.3,
"unit": "C",
"unitType": 17
},
"wind": {
"direction": {
"degrees": 231
},
"speed": {
"value": 4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"speed": {
"value": 5,
"unit": "km/h",
"unitType": 7
}
},
"precipitation": {
"dbz": 0,
"type": "SNOW"
},
"lightningCount": 0,
"sunGlare": {
"calculatedVehicleHeading": 43,
"glareIndex": 0
},
"hazards": {
"maxHazardIndex": 0
},
"notifications": []
}
]
}
정의
Name | Description |
---|---|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Hazard |
|
Hazard |
심각도/위험 인덱스입니다.
|
Icon |
를 표시하는 이미지를 나타내는 숫자 값입니다 |
Json |
원하는 응답 형식입니다.
|
Sun |
운전자에게 태양이 얼마나 눈을 멀게 하는지를 나타내는 등급입니다. |
Unit |
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps의 날씨 서비스를 참조하세요. |
Weather |
경로를 따라 날씨의 강수량 예측. |
Weather |
이 개체는 성공적인 날씨 경로에서 반환됩니다. |
Weather |
경로를 따라 날씨의 짧은 요약. |
Weather |
여행에 영향을 주는 날씨 위험에 대한 설명입니다. |
Weather |
|
Weather |
날씨와 관련된 지정된 단위의 특정 값입니다. |
Weather |
|
Wind |
속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다. |
Wind |
풍향 |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
HazardDetail
Name | 형식 | Description |
---|---|---|
hazardCode |
string |
각 위험 유형에 대한 고유 식별자(표시할 수 없음): LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, SevereThunderstormWarning. |
hazardIndex |
심각도/위험 인덱스입니다.
|
|
shortPhrase |
string |
예측 조건과 강수량 강도/유형을 설명하는 표시 가능한 짧은 구입니다. |
HazardIndex
심각도/위험 인덱스입니다.
-
0
- 위험이 없습니다. -
1
- 정보를 알고 있어야 합니다. -
2
- 주의, 준비. -
3
- 작업을 수행합니다. -
4
- 생명을 위협, 비상.
Name | 형식 | Description |
---|---|---|
0 |
Integer |
|
1 |
Integer |
|
2 |
Integer |
|
3 |
Integer |
|
4 |
Integer |
IconCode
를 표시하는 이미지를 나타내는 숫자 값입니다 iconPhrase
. 자세한 내용은 Azure Maps의 날씨 서비스를 참조하세요.
Name | 형식 | Description |
---|---|---|
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 |
|
23 |
Integer |
|
24 |
Integer |
|
25 |
Integer |
|
26 |
Integer |
|
27 |
Integer |
|
28 |
Integer |
|
29 |
Integer |
|
3 |
Integer |
|
30 |
Integer |
|
31 |
Integer |
|
32 |
Integer |
|
33 |
Integer |
|
34 |
Integer |
|
35 |
Integer |
|
36 |
Integer |
|
37 |
Integer |
|
38 |
Integer |
|
39 |
Integer |
|
4 |
Integer |
|
40 |
Integer |
|
41 |
Integer |
|
42 |
Integer |
|
43 |
Integer |
|
44 |
Integer |
|
5 |
Integer |
|
6 |
Integer |
|
7 |
Integer |
|
8 |
Integer |
|
9 |
Integer |
JsonFormat
원하는 응답 형식입니다.
json
형식만 지원됩니다.
Name | 형식 | Description |
---|---|---|
json |
string |
SunGlare
운전자에게 태양이 얼마나 눈을 멀게 하는지를 나타내는 등급입니다.
Name | 형식 | Description |
---|---|---|
calculatedVehicleHeading |
integer |
차량 제목 값이 웨이포인트에 대해 제공되지 않으면 서비스는 제공된 경우 인접한 웨이포인트의 위치에 따라 제목을 계산합니다. |
glareIndex |
integer |
드라이버의 태양 눈부심 강도를 나타내는 0에서 100까지의 인덱스입니다. 50 이상의 값은 일부 운전자에게 위험으로 간주될 수 있으며 값 100은 운전자가 태양으로 바로 운전하고 대기 조건이 명확하여 태양의 전체 강도가 운전자를 눈멀게 할 수 있음을 의미합니다. |
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 |
WeatherAlongRoutePrecipitation
경로를 따라 날씨의 강수량 예측.
Name | 형식 | Description |
---|---|---|
dbz |
number |
dBZ의 예상 강수량(Z를 기준으로 하는 데시벨)은 0.0에서 100.0으로 예측됩니다. |
type |
string |
강수량 유형입니다. 강수량이 발생하면 "RAIN", "HAIL", "SNOW", "ICE" 또는 "MIX"가 될 형식입니다. |
WeatherAlongRouteResult
이 개체는 성공적인 날씨 경로에서 반환됩니다.
Name | 형식 | Description |
---|---|---|
summary |
경로를 따라 날씨의 짧은 요약. |
|
waypoints |
요청에 지정된 것과 동일한 순서로 반환되는 각 웨이포인트의 데이터입니다. |
WeatherAlongRouteSummary
경로를 따라 날씨의 짧은 요약.
Name | 형식 | Description |
---|---|---|
hazards |
여행에 영향을 주는 날씨 위험에 대한 설명입니다. |
|
iconCode |
를 표시하는 이미지를 나타내는 숫자 값입니다 |
WeatherHazards
여행에 영향을 주는 날씨 위험에 대한 설명입니다.
Name | 형식 | Description |
---|---|---|
hazardDetails |
여행에 영향을 미치는 날씨 위험의 세부 정보입니다. |
|
maxHazardIndex |
심각도/위험 인덱스입니다.
|
WeatherNotification
Name | 형식 | Description |
---|---|---|
hazardCode |
string |
각 위험 유형에 대한 고유 식별자(표시할 수 없음): LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, SevereThunderstormWarning. |
hazardIndex |
심각도/위험 인덱스입니다.
|
|
shortPhrase |
string |
예측 조건과 강수량 강도/유형을 설명하는 표시 가능한 짧은 구입니다. |
type |
string |
운전자에게 위험 발생을 경고하거나 위험 강도를 높이기 위해 생성된 알림 유형입니다. |
WeatherUnit
날씨와 관련된 지정된 단위의 특정 값입니다.
Name | 형식 | Description |
---|---|---|
unit |
string |
반환된 값의 단위 유형입니다. |
unitType |
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps의 날씨 서비스를 참조하세요. |
|
value |
number |
반올림된 값입니다. |
WeatherWaypoint
Name | 형식 | Description |
---|---|---|
cloudCover |
integer |
클라우드 커버를 나타내는 백분율입니다. |
hazards |
여행에 영향을 주는 날씨 위험에 대한 설명입니다. |
|
iconCode |
를 표시하는 이미지를 나타내는 숫자 값입니다 |
|
isDayTime |
boolean |
하루 중 시간을 나타냅니다. True는 'day'를 나타내고, false는 'night'를 나타냅니다. |
lightningCount |
integer |
열린 규모에서 뇌우 강도의 추정. 값이 0이면 뇌우가 없음을 의미합니다. 값이 1 이상이면 강도가 높아지는 뇌우가 있음을 의미합니다. |
notifications |
날씨 위험 알림 목록입니다. |
|
precipitation |
경로를 따라 날씨의 강수량 예측. |
|
shortPhrase |
string |
예측 조건과 강수량 강도/유형을 설명하는 표시 가능한 짧은 구입니다. |
sunGlare |
운전자에게 태양이 얼마나 눈을 멀게 하는지를 나타내는 등급입니다. |
|
temperature |
날씨와 관련된 지정된 단위의 특정 값입니다. |
|
wind |
속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다. |
|
windGust |
속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다. |
WindDetails
속도 및 방향을 포함하여 반환되는 바람 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
direction |
풍향 |
|
speed |
지정된 단위의 바람 속도입니다. |
WindDirection
풍향
Name | 형식 | Description |
---|---|---|
degrees |
integer |
진북에서 시작하여 시계 방향으로 계속되는 아지무스도의 바람 방향. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다. 가능한 값은 0-359입니다. |
localizedDescription |
string |
지정된 언어의 방향 약어입니다. |