Weather - Get Weather Along Route
A használatával pontos, naprakész előrejelzést kaphat, amely időjárás-veszélyfelméréseket és értesítéseket tartalmaz egy útvonal mentén.
Az Get Weather Along Route
API egy HTTP-kérés GET
, amely hiper helyi (egy vagy kevesebb kilométeres), azonnali időjárás-előrejelzést, időjárási veszélyfelméréseket és értesítéseket ad vissza az útpontok sorozataként leírt útvonal mentén.
Ez tartalmazza az útpontot vagy az útvonalat érintő időjárási veszélyek listáját, és az egyes útpontok összesített veszélyindexe felhasználható az útvonal egyes részeinek festésére annak megfelelően, hogy mennyire biztonságos a vezető számára. Az útpontok beküldésekor ajánlott a 120 percen belül vagy röviddel utána megtett távolságon belül vagy ahhoz közel maradni. Az adatok öt percenként frissülnek.
A szolgáltatás kiegészíti az Azure Maps Route Service-t , amely lehetővé teszi, hogy először útvonal kérését kérje egy forrás és egy cél között, és ezt használja bemenetként a Weather Along Route végponthoz.
Emellett a szolgáltatás olyan forgatókönyveket is támogat, amelyek időjárási értesítéseket hoznak létre olyan útpontokhoz, amelyeknél az időjárás-veszély intenzitása nő. Ha például a jármű várhatóan nagy esőzést fog tapasztalni, amikor eléri az útpontot, a rendszer időjárási értesítést küld a nagy esőzésről az adott útponthoz, amely lehetővé teszi, hogy a végfelhasználó megjelenítse a nagy esőről szóló értesítést, mielőtt a vezető eléri ezt az útpontot. Egy útpont értesítésének megjelenítésére szolgáló eseményindító alapulhat például egy geokerítésen vagy az útponttól való választható távolságon.
Az API a bolygó összes régióját lefedi, kivéve a Grönland és az Antarktisz feletti szélességeket.
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-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
format
|
path | True |
A válasz kívánt formátuma. Csak |
|
api-version
|
query | True |
string |
Az Azure Maps API verziószáma. |
query
|
query | True |
string |
Az útvonal kiszámításának koordinátái kettősponttal (:) és időrendben megadva. Legalább két útpont szükséges. Egyetlen API-hívás legfeljebb 60 útpontot tartalmazhat. Egy útpont a helyet, az ETA-t és a választható címsort jelzi: szélesség,hosszúság,ETA,címsor, ahol
Javasoljuk, hogy maradjon a 120 percen belül vagy röviddel utána megtett távolságon belül vagy közel. Így pontosabb értékelést lehet biztosítani az utazáshoz, és megakadályozhatja, hogy az elkülönített események ne legyenek rögzítve az útpontok között. Az információk frissíthetők és frissíthetők az útvonal mentén (különösen a 2 óránál hosszabb utak esetén), hogy folyamatosan új útpontokat húzzanak előre, de annak biztosítása érdekében is, hogy a csapadéktípusra és az intenzitásra vonatkozó információk pontosak legyenek, amikor a viharok idővel fejlődnek és eloszlanak. |
language
|
query |
string |
Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvcímkék egyikének kell lennie, a kis- és nagybetűk nem különböztethetők meg. Ha a megadott nyelvű adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg a támogatott nyelveket ismertető cikket. |
Kérelem fejléce
Name | Kötelező | Típus | Description |
---|---|---|---|
x-ms-client-id |
string |
Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID security Azure Mapsben való használatához az alábbi cikkek nyújtanak útmutatást. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Váratlan hiba történt. |
Biztonság
AADToken
Ezek a Microsoft Entra OAuth 2.0-folyamatok . Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.
A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.
Jegyzetek
- Ehhez a biztonsági definícióhoz a
x-ms-client-id
fejléc használatával kell jelezni, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Maps management API-ból szerezhető be.
A Authorization URL
az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek.
* Az Azure-beli szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.
* Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.
- További információ a Microsoft identitásplatformról: A Microsoft identitásplatformjának áttekintése.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy PowerShell, CLI, Azure SDK-k vagy REST API használatával.
Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.
Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.
Típus:
apiKey
In:
query
SAS Token
Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázása műveletéből jön létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.
Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.
Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.
Típus:
apiKey
In:
header
Példák
Successfully retrieve detailed weather casts along a route described as a sequence of waypoints
Mintakérelem
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
Mintaválasz
{
"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": []
}
]
}
Definíciók
Name | Description |
---|---|
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Hazard |
|
Hazard |
Súlyossági/veszélyességi index.
|
Icon |
A képet megjelenítő |
Json |
A válasz kívánt formátuma. Csak |
Sun |
Egy minősítés, amely azt jelzi, hogy mennyire vakítja a napot a vezető. |
Unit |
A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. További részletekért tekintse meg az Azure Maps időjárási szolgáltatásaival foglalkozó cikket. |
Weather |
Az útvonal mentén várható időjárás előrejelzése. |
Weather |
Ezt az objektumot egy sikeres Weather Along Route-ból adja vissza a rendszer. |
Weather |
Rövid összefoglaló az útvonal mentén várható időjárásról. |
Weather |
Az utazást érintő időjárási veszély leírása. |
Weather |
|
Weather |
Egy adott egység adott, időjárással kapcsolatos értéke. |
Weather |
|
Wind |
A visszaadott széladatok, beleértve a sebességet és az irányt. |
Wind |
Szélirány |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további adattípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
HazardDetail
Name | Típus | Description |
---|---|---|
hazardCode |
string |
Egyedi azonosító (nem megjeleníthető) minden veszélytípushoz: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Súlyossági/veszélyességi index.
|
|
shortPhrase |
string |
Megjeleníthető rövid kifejezés, amely leírja az előrejelzett feltételeket és a csapadék intenzitását/típusát. |
HazardIndex
Súlyossági/veszélyességi index.
-
0
- Nincs veszély. -
1
- Legyen tájékozott, legyen tisztában. -
2
- Figyeljen, készüljön fel. -
3
- Tegyen lépéseket. -
4
- Életveszélyes, vészhelyzet.
Name | Típus | Description |
---|---|---|
0 |
Integer |
|
1 |
Integer |
|
2 |
Integer |
|
3 |
Integer |
|
4 |
Integer |
IconCode
A képet megjelenítő iconPhrase
numerikus érték. További részletekért tekintse meg az Azure Maps időjárási szolgáltatásaival foglalkozó cikket.
Name | Típus | 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
A válasz kívánt formátuma. Csak json
a formátum támogatott.
Name | Típus | Description |
---|---|---|
json |
string |
SunGlare
Egy minősítés, amely azt jelzi, hogy mennyire vakítja a napot a vezető.
Name | Típus | Description |
---|---|---|
calculatedVehicleHeading |
integer |
Ha a jármű címsorértéke nincs megadva egy útponthoz, akkor a szolgáltatás a szomszédos útpontok helyétől függően kiszámít egy címsort, ha meg van adva. |
glareIndex |
integer |
Egy 0 és 100 közötti index, amely a járművezető napfényének intenzitását jelzi. Az 50-et meghaladó érték veszélyesnek tekinthető egyes járművezetők számára, és a 100 érték azt jelzi, hogy a vezető egyenesen a napba vezet, és a légköri körülmények egyértelműek, ami lehetővé teszi, hogy a nap teljes intenzitása elvakítja a vezetőt. |
UnitType
A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. További részletekért tekintse meg az Azure Maps időjárási szolgáltatásaival foglalkozó cikket.
Name | Típus | 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
Az útvonal mentén várható időjárás előrejelzése.
Name | Típus | Description |
---|---|---|
dbz |
number |
Az előrejelzett csapadékintenzitás dBZ-ben (decibelek a Z-hez viszonyítva) 0,0 és 100,0 között. |
type |
string |
Csapadék típusa. Csapadék esetén a típus a következő lesz: "ESŐ", "JÉGESŐ", "HÓ", "JÉG" vagy "MIX". |
WeatherAlongRouteResult
Ezt az objektumot egy sikeres Weather Along Route-ból adja vissza a rendszer.
Name | Típus | Description |
---|---|---|
summary |
Rövid összefoglaló az útvonal mentén várható időjárásról. |
|
waypoints |
Az egyes útpontok adatai a kérelemben megadott sorrendben adhatók vissza. |
WeatherAlongRouteSummary
Rövid összefoglaló az útvonal mentén várható időjárásról.
Name | Típus | Description |
---|---|---|
hazards |
Az utazást érintő időjárási veszély leírása. |
|
iconCode |
A képet megjelenítő |
WeatherHazards
Az utazást érintő időjárási veszély leírása.
Name | Típus | Description |
---|---|---|
hazardDetails |
Az utazást érintő időjárási veszélyek részletei. |
|
maxHazardIndex |
Súlyossági/veszélyességi index.
|
WeatherNotification
Name | Típus | Description |
---|---|---|
hazardCode |
string |
Egyedi azonosító (nem megjeleníthető) minden veszélytípushoz: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning. |
hazardIndex |
Súlyossági/veszélyességi index.
|
|
shortPhrase |
string |
Megjeleníthető rövid kifejezés, amely leírja az előrejelzett feltételeket és a csapadék intenzitását/típusát. |
type |
string |
Olyan értesítéstípus, amely arra figyelmezteti a járművezetőket, hogy a veszély keletkezéséről vagy a veszély intenzitásának növekedéséről szólnak. |
WeatherUnit
Egy adott egység adott, időjárással kapcsolatos értéke.
Name | Típus | Description |
---|---|---|
unit |
string |
A visszaadott érték egységtípusa. |
unitType |
A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. További részletekért tekintse meg az Azure Maps időjárási szolgáltatásaival foglalkozó cikket. |
|
value |
number |
Kerekített érték. |
WeatherWaypoint
Name | Típus | Description |
---|---|---|
cloudCover |
integer |
A felhőfedés százalékos aránya. |
hazards |
Az utazást érintő időjárási veszély leírása. |
|
iconCode |
A képet megjelenítő |
|
isDayTime |
boolean |
A nap időpontját jelzi. Az igaz érték a "day" értéket, a hamis pedig az "éjszaka" értéket jelöli. |
lightningCount |
integer |
A zivatarok intenzitásának becslése nyílt skálán. A 0 érték azt jelenti, hogy nincs zivatar; az 1 és a magasabb értékek növekvő intenzitású zivatart jelentenek. |
notifications |
Az időjárási veszélyekre figyelmeztető értesítések listája. |
|
precipitation |
Az útvonal mentén várható időjárás előrejelzése. |
|
shortPhrase |
string |
Megjeleníthető rövid kifejezés, amely leírja az előrejelzett feltételeket és a csapadék intenzitását/típusát. |
sunGlare |
Egy minősítés, amely azt jelzi, hogy mennyire vakítja a napot a vezető. |
|
temperature |
Egy adott egység adott, időjárással kapcsolatos értéke. |
|
wind |
A visszaadott széladatok, beleértve a sebességet és az irányt. |
|
windGust |
A visszaadott széladatok, beleértve a sebességet és az irányt. |
WindDetails
A visszaadott széladatok, beleértve a sebességet és az irányt.
Name | Típus | Description |
---|---|---|
direction |
Szélirány |
|
speed |
A szél sebessége a megadott egységben. |
WindDirection
Szélirány
Name | Típus | Description |
---|---|---|
degrees |
integer |
Szélirány az Azimuth fokban, a valódi északtól kezdve és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugat 270 fok. Lehetséges értékek: 0-359. |
localizedDescription |
string |
Irány rövidítése a megadott nyelven. |