Add metadata API request usage tracking

Author: kmg0308

Sources/StreetViewWander/AppMain.swift

@@ -175,13 +175,28 @@ struct ContentView: View {
                 .lineLimit(2)
                 .font(.system(size: 13, weight: .semibold))
                 .foregroundStyle(model.errorText == nil ? Color.white.opacity(0.86) : Color(red: 1, green: 0.82, blue: 0.76))
+                .layoutPriority(1)
+
+            Spacer(minLength: 8)
+
+            Text(metadataUsageStatus)
+                .lineLimit(1)
+                .font(.system(size: 12, weight: .bold))
+                .foregroundStyle(.white.opacity(0.72))
         }
         .padding(.horizontal, 14)
         .padding(.vertical, 10)
         .background(.black.opacity(0.58), in: RoundedRectangle(cornerRadius: 8))
         .frame(maxWidth: .infinity, alignment: .leading)
     }
 
+    private var metadataUsageStatus: String {
+        if let remaining = model.metadataRequestsRemaining {
+            return "Metadata API \(formatCount(model.metadataRequestsUsed))/\(formatCount(model.metadataRequestLimit)) · \(formatCount(remaining)) left"
+        }
+        return "Metadata API used \(formatCount(model.metadataRequestsUsed)) · no limit"
+    }
+
     private var sidePanel: some View {
         HStack {
             Spacer()
@@ -382,6 +397,32 @@ struct SettingsView: View {
                     .textFieldStyle(.roundedBorder)
             }
 
+            Divider()
+
+            VStack(alignment: .leading, spacing: 10) {
+                Text("Metadata API Request Count")
+                    .font(.system(size: 13, weight: .semibold))
+
+                HStack(spacing: 16) {
+                    requestMetric("Total", model.metadataRequestLimit > 0 ? formatCount(model.metadataRequestLimit) : "No limit")
+                    requestMetric("Used", formatCount(model.metadataRequestsUsed))
+                    requestMetric("Remaining", model.metadataRequestsRemaining.map(formatCount) ?? "No limit")
+                }
+
+                HStack(spacing: 10) {
+                    TextField("Total request limit", value: $model.metadataRequestLimit, format: .number)
+                        .textFieldStyle(.roundedBorder)
+                        .frame(width: 180)
+                    Text("0 means no limit")
+                        .font(.system(size: 12))
+                        .foregroundStyle(.secondary)
+                    Spacer()
+                    Button("Reset Used Count") {
+                        model.resetMetadataRequestUsage()
+                    }
+                }
+            }
+
             HStack {
                 Button("Import .env") {
                     model.importEnvFile()
@@ -396,6 +437,18 @@ struct SettingsView: View {
         .padding(20)
         .frame(width: 520)
     }
+
+    private func requestMetric(_ label: String, _ value: String) -> some View {
+        VStack(alignment: .leading, spacing: 3) {
+            Text(label)
+                .font(.system(size: 11, weight: .medium))
+                .foregroundStyle(.secondary)
+            Text(value)
+                .font(.system(size: 13, weight: .bold))
+                .foregroundStyle(.primary)
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+    }
 }
 
 private func panelHeader(_ text: String) -> some View {
@@ -420,6 +473,10 @@ private func formatCoord(_ value: Double) -> String {
     String(format: "%.5f", value)
 }
 
+private func formatCount(_ value: Int) -> String {
+    NumberFormatter.localizedString(from: NSNumber(value: value), number: .decimal)
+}
+
 private func mapsURL(for panorama: Panorama) -> URL {
     var components = URLComponents(string: "https://www.google.com/maps/search/")!
     components.queryItems = [

Sources/StreetViewWander/WanderModel.swift

@@ -11,6 +11,8 @@ final class WanderModel: ObservableObject {
         static let metadataAPIKey = "metadataAPIKey"
         static let selectedContinentId = "selectedContinentId"
         static let selectedCountryId = "selectedCountryId"
+        static let metadataRequestLimit = "metadataRequestLimit"
+        static let metadataRequestsUsed = "metadataRequestsUsed"
     }
 
     @Published var browserAPIKey: String {
@@ -37,13 +39,26 @@ final class WanderModel: ObservableObject {
             }
         }
     }
+    @Published var metadataRequestLimit = 0 {
+        didSet {
+            if metadataRequestLimit < 0 {
+                metadataRequestLimit = 0
+            }
+            defaults.set(metadataRequestLimit, forKey: DefaultsKey.metadataRequestLimit)
+        }
+    }
 
     @Published private(set) var panorama: Panorama?
     @Published private(set) var history: [HistoryEntry] = []
     @Published private(set) var locationOptions = LocationOptions.empty
     @Published private(set) var isLoading = false
     @Published private(set) var statusText = "Add API keys in Settings, then pick a random place."
     @Published private(set) var errorText: String?
+    @Published private(set) var metadataRequestsUsed = 0 {
+        didSet {
+            defaults.set(metadataRequestsUsed, forKey: DefaultsKey.metadataRequestsUsed)
+        }
+    }
     @Published var activePanel: Panel = .none
     @Published var isSettingsPresented = false
 
@@ -78,6 +93,8 @@ final class WanderModel: ObservableObject {
         self.metadataAPIKey = keychainStore.string(for: DefaultsKey.metadataAPIKey) ?? legacyMetadataAPIKey ?? ""
         self.selectedContinentId = defaults.string(forKey: DefaultsKey.selectedContinentId) ?? ""
         self.selectedCountryId = defaults.string(forKey: DefaultsKey.selectedCountryId) ?? ""
+        self.metadataRequestLimit = max(0, defaults.integer(forKey: DefaultsKey.metadataRequestLimit))
+        self.metadataRequestsUsed = max(0, defaults.integer(forKey: DefaultsKey.metadataRequestsUsed))
 
         persistSecret(browserAPIKey, key: DefaultsKey.browserAPIKey)
         persistSecret(metadataAPIKey, key: DefaultsKey.metadataAPIKey)
@@ -92,6 +109,13 @@ final class WanderModel: ObservableObject {
         !metadataAPIKey.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
     }
 
+    var metadataRequestsRemaining: Int? {
+        guard metadataRequestLimit > 0 else {
+            return nil
+        }
+        return max(metadataRequestLimit - metadataRequestsUsed, 0)
+    }
+
     var selectedScopeLabel: String {
         if let country = locationOptions.countries.first(where: { $0.id == selectedCountryId }) {
             return country.label
@@ -162,7 +186,10 @@ final class WanderModel: ObservableObject {
                 let next = try await panoramaFinder.findRandomPanorama(
                     metadataAPIKey: metadataAPIKey,
                     selection: selection,
-                    recentContinents: recentContinents
+                    recentContinents: recentContinents,
+                    onMetadataRequest: { [weak self] in
+                        await self?.recordMetadataRequest()
+                    }
                 )
                 panorama = next
                 history = try historyStore.append(next)
@@ -177,6 +204,14 @@ final class WanderModel: ObservableObject {
         }
     }
 
+    func resetMetadataRequestUsage() {
+        metadataRequestsUsed = 0
+    }
+
+    private func recordMetadataRequest() {
+        metadataRequestsUsed += 1
+    }
+
     private func persistSecret(_ value: String, key: String) {
         let trimmed = value.trimmingCharacters(in: .whitespacesAndNewlines)
         if trimmed.isEmpty {

Sources/StreetViewWanderCore/PanoramaFinder.swift

@@ -46,7 +46,8 @@ public actor PanoramaFinder {
     public func findRandomPanorama(
         metadataAPIKey: String,
         selection: SearchSelection,
-        recentContinents: [String] = []
+        recentContinents: [String] = [],
+        onMetadataRequest: (@Sendable () async -> Void)? = nil
     ) async throws -> Panorama {
         let apiKey = metadataAPIKey.trimmingCharacters(in: .whitespacesAndNewlines)
         guard !apiKey.isEmpty else {
@@ -65,7 +66,11 @@ public actor PanoramaFinder {
                 globalPlan: globalPlan,
                 attempt: attempt
             )
-            let metadata = try await metadata(apiKey: apiKey, location: candidate.requestedLocation)
+            let metadata = try await metadata(
+                apiKey: apiKey,
+                location: candidate.requestedLocation,
+                onRequest: onMetadataRequest
+            )
             lastStatus = metadata.errorMessage ?? metadata.status
 
             if metadata.status == "OK",
@@ -98,7 +103,11 @@ public actor PanoramaFinder {
         throw PanoramaFinderError.noPanoramaFound(SearchSampler.maxAttempts, lastStatus)
     }
 
-    private func metadata(apiKey: String, location: PanoramaLocation) async throws -> PanoramaMetadata {
+    private func metadata(
+        apiKey: String,
+        location: PanoramaLocation,
+        onRequest: (@Sendable () async -> Void)?
+    ) async throws -> PanoramaMetadata {
         var components = URLComponents(string: "https://maps.googleapis.com/maps/api/streetview/metadata")
         components?.queryItems = [
             URLQueryItem(name: "key", value: apiKey),
@@ -111,6 +120,7 @@ public actor PanoramaFinder {
             throw PanoramaFinderError.googleResponseInvalid
         }
 
+        await onRequest?()
         let (data, response) = try await session.data(from: url)
         guard let http = response as? HTTPURLResponse else {
             throw PanoramaFinderError.googleResponseInvalid