Real Auckland weather in the bus scenes

Open-Meteo (free, no key) every 15 minutes: cloud cover greys the sky and
thickens the clouds, drizzle and rain fall on a slant, fog hazes the
skyline, thunderstorms flash; the header shows the temperature.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011C2fAvFFcMRkaF7qSvRA1v

Author: claude

README.md

@@ -19,8 +19,11 @@ Britomart and 8664 to Waikowhai. Stops and route can be changed in Settings.
 - **A live scene per direction.** The bus drives toward the stop as its arrival
   counts down, and its wheels turn while it's moving. The sky follows the real
   time of day: sunrise, the sun's arc, sunset, then stars and a crescent moon,
-  with lit windows and the Sky Tower's beacon. The city lane has the Auckland
-  skyline; the Waikowhai lane has houses and pōhutukawa in flower.
+  with lit windows and the Sky Tower's beacon. The weather is Auckland's real
+  weather ([Open-Meteo](https://open-meteo.com)): cloud cover greys the sky, and
+  it drizzles, rains, fogs over or flashes with thunder when Auckland does. The
+  city lane has the skyline with Rangitoto behind; the Waikowhai lane has houses,
+  pōhutukawa in flower and Maungakiekie's obelisk.
 - **The next bus in detail.** It shows the expected arrival against the
   timetable, on time or minutes late, and a track of the stops between the bus
   and you with the last one it passed. From its GPS it also shows how far away

app/src/main/java/nz/aryan/akllive/AppViewModel.kt

@@ -21,6 +21,7 @@ import nz.aryan.akllive.data.TrainRepo
 import nz.aryan.akllive.data.TrainState
 import nz.aryan.akllive.data.TripDetail
 import nz.aryan.akllive.data.Fleet
+import nz.aryan.akllive.data.Weather
 import nz.aryan.akllive.ui.Basemap
 import kotlin.math.atan2
 import kotlin.math.hypot
@@ -73,6 +74,9 @@ class AppViewModel(app: Application) : AndroidViewModel(app) {
     private val _linzKey = MutableStateFlow(prefs.linzKey)
     val linzKey: StateFlow<String> = _linzKey
 
+    private val _weather = MutableStateFlow<Weather?>(null)
+    val weather: StateFlow<Weather?> = _weather
+
     private val _trains = MutableStateFlow(TrainState())
     val trains: StateFlow<TrainState> = _trains
 
@@ -88,6 +92,7 @@ class AppViewModel(app: Application) : AndroidViewModel(app) {
         Fleet.load(app)
         viewModelScope.launch { loop(30_000) { refreshBuses() } }
         viewModelScope.launch { loop(15_000) { refreshTrains() } }
+        viewModelScope.launch { loop(900_000) { Weather.fetch()?.let { _weather.value = it } } }
     }
 
     /** Poll only while the app is on screen; refresh straight away when it comes back. */

app/src/main/java/nz/aryan/akllive/data/Weather.kt

@@ -0,0 +1,60 @@
+package nz.aryan.akllive.data
+
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import org.json.JSONObject
+import java.net.HttpURLConnection
+import java.net.URL
+
+/** Auckland's weather right now, from Open-Meteo (free, no key), for the bus scenes. */
+data class Weather(
+    val tempC: Double,
+    /** WMO weather code: 0 clear, 1-3 cloud, 45/48 fog, 51-67 drizzle/rain, 80-82 showers, 95+ thunder */
+    val code: Int,
+    val cloudCover: Int,
+    val precipMm: Double,
+) {
+    val foggy get() = code == 45 || code == 48
+    val thunder get() = code >= 95
+    /** 0 none, 1 drizzle, 2 rain, 3 heavy */
+    val rain: Int get() = when {
+        code in 51..57 -> 1
+        code in 61..67 || code in 80..82 || thunder -> if (code == 65 || code == 67 || code == 82 || precipMm > 4) 3 else 2
+        precipMm > 0.2 -> 1
+        else -> 0
+    }
+
+    fun describe(night: Boolean): String = when {
+        thunder -> "⛈ Thunder"
+        rain >= 2 && code in 80..82 -> "🌦 Showers"
+        rain >= 2 -> "🌧 Rain"
+        rain == 1 -> "🌦 Drizzle"
+        foggy -> "🌫 Fog"
+        code == 3 || cloudCover > 85 -> "☁ Overcast"
+        code in 1..2 || cloudCover > 30 -> if (night) "☁ Partly cloudy" else "⛅ Partly cloudy"
+        else -> if (night) "☾ Clear" else "☀ Sunny"
+    }
+
+    companion object {
+        suspend fun fetch(): Weather? = withContext(Dispatchers.IO) {
+            val c = URL("https://api.open-meteo.com/v1/forecast?latitude=-36.87&longitude=174.76" +
+                        "&current=temperature_2m,weather_code,cloud_cover,precipitation&timezone=Pacific%2FAuckland")
+                .openConnection() as HttpURLConnection
+            c.connectTimeout = 15_000
+            c.readTimeout = 20_000
+            try {
+                if (c.responseCode != 200) return@withContext null
+                val cur = JSONObject(c.inputStream.bufferedReader().use { it.readText() }).obj("current")
+                    ?: return@withContext null
+                Weather(
+                    tempC = cur.optDouble("temperature_2m"),
+                    code = cur.optInt("weather_code"),
+                    cloudCover = cur.optInt("cloud_cover"),
+                    precipMm = cur.optDouble("precipitation", 0.0),
+                )
+            } finally {
+                c.disconnect()
+            }
+        }
+    }
+}

app/src/main/java/nz/aryan/akllive/ui/BusScene.kt

@@ -12,6 +12,7 @@ import androidx.compose.ui.graphics.drawscope.rotate
 import androidx.compose.ui.graphics.lerp
 import androidx.compose.ui.text.TextLayoutResult
 import androidx.compose.ui.text.drawText
+import nz.aryan.akllive.data.Weather
 import kotlin.math.PI
 import kotlin.math.cos
 import kotlin.math.sin
@@ -28,6 +29,7 @@ class Scenery(val city: Boolean, seed: Int) {
     val trees = ArrayList<Tree>()
     val stars: List<Triple<Float, Float, Float>>
     val clouds: List<FloatArray>              // offset, y, scale, speed
+    val drops: List<FloatArray>               // x, phase, speed
 
     init {
         val r = Random(seed * 7919 + 17)
@@ -63,6 +65,7 @@ class Scenery(val city: Boolean, seed: Int) {
                 }
             }
         }
+        drops = List(120) { floatArrayOf(r.nextFloat(), r.nextFloat(), r.nextFloat()) }
     }
 }
 
@@ -108,13 +111,21 @@ private val Lit = Color(0xFFFFD98A)
  */
 fun DrawScope.drawBusScene(
     s: Scenery, hour: Float, t: Float, progress: Float?, moving: Boolean,
-    cancelled: Boolean, dest: TextLayoutResult?, dp: Float, look: BusLook = BusLook(),
+    cancelled: Boolean, dest: TextLayoutResult?, dp: Float, look: BusLook = BusLook(), wx: Weather? = null,
 ) {
     val w = size.width
     val h = size.height
     val ground = h * 0.74f
-    val sky = skyAt(hour)
     val night = isNight(hour)
+    // the real weather: cloud cover greys the sky, rain darkens it further
+    val cover = (wx?.cloudCover ?: 30) / 100f
+    val rain = wx?.rain ?: 0
+    val gloom = (((cover - 0.5f) / 0.5f).coerceIn(0f, 1f) * 0.5f + rain * 0.08f).coerceAtMost(0.7f)
+    val grey = if (night) Color(0xFF141922) else Color(0xFF8C95A5)
+    val clear = skyAt(hour)
+    val sky = Sky(lerp(clear.top, grey, gloom), lerp(clear.bottom, lerp(grey, Color.White, 0.25f), gloom),
+                  lerp(clear.hills, grey, gloom * 0.5f), lerp(clear.near, grey, gloom * 0.4f))
+    val sunShow = (1f - gloom * 1.7f).coerceIn(0f, 1f)
 
     // sky
     drawRect(Brush.verticalGradient(listOf(sky.top, sky.bottom), 0f, ground), size = Size(w, ground))
@@ -126,31 +137,37 @@ fun DrawScope.drawBusScene(
         val sy = ground - sin(p * PI).toFloat() * ground * 0.78f
         val low = 1f - sin(p * PI).toFloat()
         val sun = lerp(Color(0xFFFFF4D6), Color(0xFFFFB066), low)
-        drawCircle(Brush.radialGradient(listOf(sun.copy(alpha = 0.55f), Color.Transparent),
+        drawCircle(Brush.radialGradient(listOf(sun.copy(alpha = 0.55f * sunShow), Color.Transparent),
                                         Offset(sx, sy), 46 * dp), 46 * dp, Offset(sx, sy))
-        drawCircle(sun, 13 * dp, Offset(sx, sy))
+        drawCircle(sun.copy(alpha = sunShow), 13 * dp, Offset(sx, sy))
     }
-    if (night) {
+    if (night && sunShow > 0f) {
         s.stars.forEachIndexed { i, (x, y, ph) ->
-            val a = 0.45f + 0.45f * sin(t * (0.8f + (i % 5) * 0.3f) + ph)
+            val a = (0.45f + 0.45f * sin(t * (0.8f + (i % 5) * 0.3f) + ph)) * (1f - cover).coerceIn(0f, 1f)
             drawCircle(Color.White.copy(alpha = a), (if (i % 7 == 0) 1.4f else 0.9f) * dp,
                        Offset(x * w, y * ground))
         }
         val mc = Offset(w * 0.82f, h * 0.2f)
-        drawCircle(Brush.radialGradient(listOf(Color(0x55FFF3D0), Color.Transparent), mc, 30 * dp), 30 * dp, mc)
-        drawCircle(Color(0xFFFBF3DA), 10 * dp, mc)
+        drawCircle(Brush.radialGradient(listOf(Color(0x55FFF3D0).copy(alpha = 0.33f * sunShow), Color.Transparent),
+                                        mc, 30 * dp), 30 * dp, mc)
+        drawCircle(Color(0xFFFBF3DA).copy(alpha = sunShow), 10 * dp, mc)
         drawCircle(sky.top, 9 * dp, mc + Offset(4.5f * dp, -2.5f * dp))      // crescent
     }
 
-    // clouds drift by (daytime and dusk)
-    if (!night) {
-        val alpha = if (hour < 7.5f || hour > 18f) 0.7f else 0.92f
-        for (c in s.clouds) {
+    // clouds drift by: as many as the real cover, grey when it's raining, dark at night
+    val clouds = if (wx == null) (if (night) 0 else 5) else Math.round(cover * 5.4f).coerceIn(0, 5)
+    val cloudCol = when {
+        night -> Color(0xFF2A3246).copy(alpha = 0.85f)
+        rain > 0 || gloom > 0.3f -> lerp(Color.White, Color(0xFF8E98A8), 0.35f + gloom * 0.5f).copy(alpha = 0.95f)
+        else -> Color.White.copy(alpha = if (hour < 7.5f || hour > 18f) 0.7f else 0.92f)
+    }
+    run {
+        for (c in s.clouds.take(clouds)) {
             val span = w + 160 * dp
             val cx = ((c[0] * span + t * c[3] * dp) % span) - 80 * dp
             val cy = c[1] * ground
-            val k = c[2] * dp
-            val col = Color.White.copy(alpha = alpha)
+            val k = c[2] * dp * (1f + gloom * 0.6f)
+            val col = cloudCol
             drawCircle(col, 11 * k, Offset(cx, cy + 3 * k))
             drawCircle(col, 15 * k, Offset(cx + 14 * k, cy - 2 * k))
             drawCircle(col, 11 * k, Offset(cx + 30 * k, cy + 3 * k))
@@ -176,6 +193,12 @@ fun DrawScope.drawBusScene(
 
     if (s.city) drawCity(s, sky, night, t, w, h, ground, dp) else drawSuburb(s, sky, night, w, h, ground, dp)
 
+    if (wx?.foggy == true) {
+        drawRect(Brush.verticalGradient(listOf(Color.White.copy(alpha = if (night) 0.08f else 0.2f),
+                                               Color.White.copy(alpha = if (night) 0.22f else 0.5f)), 0f, ground),
+                 size = Size(w, ground))
+    }
+
     // road
     val road = if (night) Color(0xFF22262F) else Color(0xFF3B414D)
     drawRect(Color(0xFF8A919C).copy(alpha = if (night) 0.5f else 1f), Offset(0f, ground), Size(w, 3 * dp))
@@ -202,6 +225,23 @@ fun DrawScope.drawBusScene(
         val bx = x0 + (x1 - x0) * progress.coerceIn(0f, 1f)
         drawBus(bx, ground + 2 * dp + (h - ground) * 0.12f, bl, bh, t, night, moving, cancelled, dest, dp, look)
     }
+
+    // rain, falling on a slant
+    if (rain > 0) {
+        val n = intArrayOf(0, 40, 80, 120)[rain]
+        val len = (if (rain == 1) 6f else 11f) * dp
+        val col = Color(0xFFD6E6FF).copy(alpha = if (rain == 1) 0.35f else 0.5f)
+        for (i in 0 until n) {
+            val d = s.drops[i]
+            val y = ((d[1] + t * (1.1f + d[2] * 0.8f)) % 1f) * (h + len) - len
+            val x = d[0] * (w + 30 * dp) - y * 0.2f
+            drawLine(col, Offset(x, y), Offset(x - len * 0.2f, y + len), strokeWidth = 1.1f * dp, cap = StrokeCap.Round)
+        }
+    }
+    if (wx?.thunder == true) {
+        val ph = t % 9f
+        if (ph < 0.1f || ph in 0.22f..0.3f) drawRect(Color.White.copy(alpha = 0.35f))
+    }
 }
 
 /** Rangitoto's low, even shield, with its summit bump, as seen from the city. */

app/src/main/java/nz/aryan/akllive/ui/BusScreen.kt

@@ -81,6 +81,7 @@ import nz.aryan.akllive.data.Nz
 import nz.aryan.akllive.data.RouteData
 import nz.aryan.akllive.data.StopBoard
 import nz.aryan.akllive.data.Vehicle
+import nz.aryan.akllive.data.Weather
 import nz.aryan.akllive.data.occupancyText
 import kotlin.math.asin
 import kotlin.math.cos
@@ -127,6 +128,7 @@ fun BusScreen(vm: AppViewModel, modifier: Modifier) {
     val pulling by vm.pulling.collectAsStateWithLifecycle()
     val basemap by vm.basemap.collectAsStateWithLifecycle()
     val linzKey by vm.linzKey.collectAsStateWithLifecycle()
+    val weather by vm.weather.collectAsStateWithLifecycle()
     val now by rememberNow()
     val frameT = rememberFrameTime()
     var mapOpen by rememberSaveable { mutableStateOf(false) }
@@ -143,8 +145,8 @@ fun BusScreen(vm: AppViewModel, modifier: Modifier) {
             contentPadding = PaddingValues(start = 14.dp, end = 14.dp, top = 12.dp, bottom = 20.dp),
             verticalArrangement = Arrangement.spacedBy(14.dp),
         ) {
-            item { BusHeader(vm.prefs.place, vm.prefs.route, now, boards, error) { vm.pullRefresh() } }
-            itemsIndexed(boards, key = { _, b -> b.code }) { i, b -> BusCard(b, now, frameT, i) }
+            item { BusHeader(vm.prefs.place, vm.prefs.route, now, boards, error, weather) { vm.pullRefresh() } }
+            itemsIndexed(boards, key = { _, b -> b.code }) { i, b -> BusCard(b, now, frameT, i, weather) }
             item {
                 RouteMapCard(boards, now, vm.prefs.place, basemap, linzKey, frameT) { mapOpen = true }
             }
@@ -160,7 +162,7 @@ fun BusScreen(vm: AppViewModel, modifier: Modifier) {
 
 @Composable
 private fun BusHeader(place: String, route: String, now: Long, boards: List<StopBoard>, error: String?,
-                      onRefresh: () -> Unit) {
+                      weather: Weather?, onRefresh: () -> Unit) {
     Column {
         Row(verticalAlignment = Alignment.CenterVertically) {
             Column(Modifier.weight(1f)) {
@@ -171,6 +173,10 @@ private fun BusHeader(place: String, route: String, now: Long, boards: List<Stop
             }
             Column(horizontalAlignment = Alignment.End) {
                 Text(Nz.time(now), style = MaterialTheme.typography.headlineSmall, fontWeight = FontWeight.Bold)
+                weather?.let {
+                    Text("${Math.round(it.tempC)}° · ${it.describe(isNight(Nz.hour()))}",
+                         style = MaterialTheme.typography.labelMedium, color = MaterialTheme.colorScheme.onSurfaceVariant)
+                }
                 LiveBadge(boards.maxOfOrNull { it.updated } ?: 0L, now)
             }
             IconButton(onClick = onRefresh) { Icon(Icons.Filled.Refresh, "Refresh") }
@@ -227,7 +233,7 @@ fun LiveBadge(updated: Long, now: Long) {
 }
 
 @Composable
-private fun BusCard(b: StopBoard, now: Long, frameT: State<Float>, index: Int) {
+private fun BusCard(b: StopBoard, now: Long, frameT: State<Float>, index: Int, weather: Weather?) {
     val next = b.departures.firstOrNull()
     val city = b.headsign.contains("Britomart", true) || b.headsign.contains("City", true)
     val scenery = remember(city, index) { Scenery(city, index) }
@@ -252,7 +258,8 @@ private fun BusCard(b: StopBoard, now: Long, frameT: State<Float>, index: Int) {
                 drawBusScene(scenery, Nz.hour(), frameT.value,
                              if (next == null || eta == null || eta > 1500) null else progress.value,
                              moving = next?.live == true && (eta ?: 0) > 30,
-                             cancelled = next?.cancelled == true, dest = dest, dp = density, look = look)
+                             cancelled = next?.cancelled == true, dest = dest, dp = density, look = look,
+                             wx = weather)
             }
             // legibility veil over the top of the sky
             Box(Modifier.fillMaxWidth().height(90.dp).background(

app/src/main/java/nz/aryan/akllive/ui/SettingsScreen.kt

@@ -95,6 +95,7 @@ fun SettingsScreen(vm: AppViewModel, modifier: Modifier, keepOn: Boolean, setKee
             Text("Live data from the Auckland Transport developer API. Not affiliated with Auckland Transport. " +
                  "The train map follows AT's post-CRL network map; the bus art is inspired by MSMGreen/at-departure-board. " +
                  "Maps by MapLibre, with imagery from Esri or LINZ and streets from OpenFreeMap / OpenStreetMap. " +
+                 "Weather by Open-Meteo.com (CC BY 4.0). " +
                  "Bus models come from a community fleet list and may be incomplete.",
                  style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.onSurfaceVariant)
         }