Editing SimTX API v24/Packets/WeatherMapRequest

{{SimTX API v24 navigation}}
{{SimTX packet v24
| name = WeatherMapRequest
| id = 8
| hex = 0x08
| direction = c2s
| session = [[SimTX API v24/Control session|Control]]
| size = 42 + type name length
| permission = None
| reply = [[SimTX API v24/Packets/WeatherMapResponse|WeatherMapResponse]]
| group = control
}}
'''WeatherMapRequest''' asks for a raster of the simulated tropospheric weather over an area. Tropospheric conditions, especially ducting, rain and cloud, affect VHF, UHF and microwave propagation. The server answers with [[SimTX API v24/Packets/WeatherMapResponse|WeatherMapResponse]].

== Layout ==
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>packetId</code> || <code>u8</code> || Always <code>8</code>.
|-
| <code>centerLatitudeDeg</code> || <code>f64</code> || Centre latitude, −90 to 90.
|-
| <code>centerLongitudeDeg</code> || <code>f64</code> || Centre longitude, −180 to 180.
|-
| <code>latitudeSpanDeg</code> || <code>f64</code> || Height of the area in degrees, greater than 0 and at most 180.
|-
| <code>longitudeSpanDeg</code> || <code>f64</code> || Width of the area in degrees, greater than 0 and at most 360.
|-
| <code>width</code> || <code>i32</code> || Raster columns, 2–128.
|-
| <code>height</code> || <code>i32</code> || Raster rows, 2–64.
|-
| <code>type</code> || <code>UTF</code> || Quantity to map. See below.
|}

== Map types ==
{| class="wikitable"
! <code>type</code> !! Quantity !! Unit
|-
| <code>DUCT_STRENGTH</code> || Strength of the strongest tropospheric duct (drop in modified refractivity); 0 where there is none || M-units
|-
| <code>RAIN_RATE</code> || Rain rate || mm/h
|-
| <code>CLOUD_WATER</code> || Cloud liquid water content || g/m³
|-
| <code>SURFACE_TEMPERATURE</code> || Air temperature at the surface || °C
|-
| <code>LIGHTNING_RATE</code> || Lightning flash rate || flashes/min
|}

== Behaviour ==
Heavy request, no permission needed. Invalid values close the connection.

{{SimTX API v24 navbox}}
[[Category:SimTX API v24]]