BasicUsage.swift

import BigDataCloudClient
import SwiftUI

// MARK: - Example 1: Simple SwiftUI view

struct LocationView: View {
    @State private var result: GeocodeResult?
    @State private var error: String?
    @State private var loading = false

    private let client = BigDataCloudClient()

    var body: some View {
        VStack(spacing: 16) {
            if loading {
                ProgressView("Locating…")
            } else if let result {
                VStack(alignment: .leading, spacing: 8) {
                    Text(result.response.city)
                        .font(.title2.bold())
                    Text(result.response.countryName)
                        .foregroundStyle(.secondary)

                    // Always show accuracy level — never silently use IP-based
                    accuracyBadge(for: result.accuracy)
                }
            } else if let error {
                Text(error).foregroundStyle(.red)
            }

            Button("Get My Location") {
                Task { await locate() }
            }
            .buttonStyle(.borderedProminent)
        }
        .padding()
    }

    @ViewBuilder
    private func accuracyBadge(for accuracy: AccuracyLevel) -> some View {
        switch accuracy {
        case .fine:
            Label("GPS location", systemImage: "location.fill")
                .font(.caption)
                .foregroundStyle(.green)
        case .coarse:
            Label("Approximate location", systemImage: "location")
                .font(.caption)
                .foregroundStyle(.orange)
        case .ipBased:
            // Always inform the user when falling back to IP
            Label("IP-based location — enable location for better accuracy", systemImage: "location.slash")
                .font(.caption)
                .foregroundStyle(.red)
        }
    }

    @MainActor
    private func locate() async {
        loading = true
        error = nil
        do {
            result = try await client.reverseGeocode()
        } catch {
            self.error = error.localizedDescription
        }
        loading = false
    }
}

// MARK: - Example 2: Roaming detection

struct RoamingView: View {
    @State private var roaming: RoamingResponse?
    private let client = BigDataCloudClient()

    var body: some View {
        VStack {
            if let roaming {
                if roaming.isRoaming == true {
                    Text("You are roaming in \(roaming.roamingCountryName ?? "unknown")")
                } else {
                    Text("Not roaming — home network detected")
                }
            }
            Button("Check Roaming") {
                Task {
                    roaming = try? await client.amIRoaming()
                }
            }
        }
    }
}

// MARK: - Fair use policy
//
// This API is governed by BigDataCloud's Fair Use Policy:
// https://www.bigdatacloud.com/docs/article/fair-use-policy-for-free-client-side-reverse-geocoding-api
//
// Only real-time coordinates from the calling device are permitted.
// Pre-stored, cached or externally-sourced coordinates are NOT allowed and
// will result in a 402 error and IP ban.
//
// Need to geocode coordinates you already have? Use the server-side API —
// it includes 50,000 free queries/month with an API key:
// https://www.bigdatacloud.com/docs/sdks