{
  "reference": "SCZ-2026-PILOTO-01",
  "version": "2026-09-pilot-1",
  "processed_at": "2026-10-01",
  "status": "pilot",
  "territory": {
    "territory_id": "santa-cruz/santa-cruz-de-la-sierra",
    "name": "Santa Cruz de la Sierra",
    "department": "Santa Cruz",
    "country": "Bolivia",
    "aoi": "Límite municipal GADM 4.1",
    "area_km2": 1301.699
  },
  "water_use": {
    "status": "observed",
    "observation_year": 2025,
    "geographic_scope": "Área de servicio de SAGUAPAC; no todo el municipio ni el área metropolitana",
    "produced_m3": 84416208,
    "billed_m3": 69740231,
    "production_billing_difference_m3": 14675977,
    "connections": 286060,
    "population_served": 1550064,
    "service_area_ha": 55559,
    "categories": [
      {
        "name": "Doméstica",
        "billed_m3": 53390608,
        "share_pct": 76.56,
        "connections": 249373
      },
      {
        "name": "Comercial",
        "billed_m3": 12003574,
        "share_pct": 17.21,
        "connections": 32580
      },
      {
        "name": "Industrial",
        "billed_m3": 854587,
        "share_pct": 1.23,
        "connections": 791
      },
      {
        "name": "Especial",
        "billed_m3": 3419745,
        "share_pct": 4.9,
        "connections": 3284
      },
      {
        "name": "Solidaria",
        "billed_m3": 40997,
        "share_pct": 0.06,
        "connections": 21
      },
      {
        "name": "Ciudadana",
        "billed_m3": 30720,
        "share_pct": 0.04,
        "connections": 11
      }
    ],
    "finding": "La categoría doméstica concentra la mayor parte del volumen facturado; la comercial es la segunda.",
    "limitation": "La memoria no aporta aquí un polígono operativo ni consumo desagregado por distrito o predio."
  },
  "soil_texture": {
    "depth": "0-5 cm",
    "source_resolution_m": 250,
    "components": {
      "sand": {
        "mean_pct": 49.52,
        "median_pct": 49.55,
        "p10_pct": 45.9,
        "p90_pct": 53.2
      },
      "silt": {
        "mean_pct": 22.22,
        "median_pct": 22.2,
        "p10_pct": 19.7,
        "p90_pct": 24.8
      },
      "clay": {
        "mean_pct": 28.26,
        "median_pct": 27.9,
        "p10_pct": 25.55,
        "p90_pct": 31.8
      }
    },
    "sand_class_area_km2": {
      "lt_45_pct": 64.42,
      "45_55_pct": 990.621,
      "55_70_pct": 30.714,
      "gte_70_pct": 0.0
    },
    "orientation": "franco arcillo-arenoso (orientativo a partir de promedios municipales)",
    "finding": "La fracción media de arena modelada es cercana al 50 %. Esto respalda una componente arenosa relevante, pero no permite afirmar que todo el municipio tenga sustrato arenoso."
  },
  "urban_expansion": {
    "baseline_year": 2016,
    "comparison_year": 2025,
    "classification_scale_m": 30,
    "probability_threshold": 0.5,
    "annual": [
      {
        "year": 2016,
        "status": "observed",
        "source_images": 25,
        "built_area_km2": 262.397
      },
      {
        "year": 2017,
        "status": "observed",
        "source_images": 37,
        "built_area_km2": 281.185
      },
      {
        "year": 2018,
        "status": "observed",
        "source_images": 72,
        "built_area_km2": 286.61
      },
      {
        "year": 2019,
        "status": "observed",
        "source_images": 94,
        "built_area_km2": 293.969
      },
      {
        "year": 2020,
        "status": "observed",
        "source_images": 114,
        "built_area_km2": 301.485
      },
      {
        "year": 2021,
        "status": "observed",
        "source_images": 92,
        "built_area_km2": 306.415
      },
      {
        "year": 2022,
        "status": "observed",
        "source_images": 92,
        "built_area_km2": 312.872
      },
      {
        "year": 2023,
        "status": "observed",
        "source_images": 89,
        "built_area_km2": 317.27
      },
      {
        "year": 2024,
        "status": "observed",
        "source_images": 91,
        "built_area_km2": 311.24
      },
      {
        "year": 2025,
        "status": "observed",
        "source_images": 92,
        "built_area_km2": 322.732
      },
      {
        "year": 2026,
        "status": "observed",
        "partial": true,
        "observed_to": "2026-08-31",
        "source_images": 71,
        "built_area_km2": 319.209
      }
    ],
    "gross_expansion_km2": 65.401,
    "classified_contraction_km2": 5.066,
    "net_change_km2": 60.335,
    "net_change_pct": 22.99,
    "ghsl_2020_built_surface_km2": 91.009,
    "finding": "La clasificación persistente identifica crecimiento de superficie construida entre 2016 y 2025. El resultado requiere contraste con cartografía municipal antes de usarse para regulación predial."
  },
  "sources": [
    {
      "source_id": "saguapac-memory-2025",
      "source": "SAGUAPAC · Memoria 2025",
      "source_url": "https://www.saguapac.com.bo/wp-content/uploads/2026/07/SAGUAPAC-memoria-2025_comprimido.pdf",
      "license": "Documento público; citar a SAGUAPAC",
      "observed_from": "2025-01-01",
      "observed_to": "2025-12-31",
      "retrieved_at": "2026-10-01",
      "processed_at": "2026-10-01",
      "spatial_resolution": "Área de servicio; sin geometría operativa publicada",
      "geographic_scope": "Área de servicio SAGUAPAC",
      "method": "Transcripción verificada de páginas 14, 90, 100 y 102",
      "uncertainty": "Las categorías son administrativas y no describen extracción por predio",
      "status": "observed"
    },
    {
      "source_id": "soilgrids-250m",
      "source": "ISRIC SoilGrids",
      "source_url": "https://docs.isric.org/globaldata/soilgrids/",
      "license": "CC BY 4.0",
      "observed_from": null,
      "observed_to": null,
      "retrieved_at": "2026-10-01",
      "processed_at": "2026-10-01",
      "spatial_resolution": "250 m",
      "geographic_scope": "Límite municipal",
      "method": "Media, mediana y percentiles de arena, limo y arcilla a 0-5 cm",
      "uncertainty": "Predicción global modelada; requiere calicatas o muestreo local para diseño",
      "status": "modeled"
    },
    {
      "source_id": "dynamic-world-v1",
      "source": "Google Dynamic World v1",
      "source_url": "https://developers.google.com/earth-engine/datasets/catalog/GOOGLE_DYNAMICWORLD_V1",
      "license": "CC BY 4.0",
      "observed_from": "2016-01-01",
      "observed_to": "2026-08-31",
      "retrieved_at": "2026-10-01",
      "processed_at": "2026-10-01",
      "spatial_resolution": "10 m fuente; análisis a 30 m",
      "geographic_scope": "Límite municipal",
      "method": "Mediana anual; built >= 0,50 y built > bare",
      "uncertainty": "Arena y suelo desnudo pueden confundirse; validación QGIS/local pendiente",
      "status": "modeled"
    },
    {
      "source_id": "ghsl-built-s-2020",
      "source": "JRC GHSL R2023A Built-up Surface 2020",
      "source_url": "https://human-settlement.emergency.copernicus.eu/ghs_buS2023.php",
      "license": "CC BY 4.0",
      "observed_from": "2020",
      "observed_to": "2020",
      "retrieved_at": "2026-10-01",
      "processed_at": "2026-10-01",
      "spatial_resolution": "100 m",
      "geographic_scope": "Límite municipal",
      "method": "Suma de superficie construida en celdas GHSL",
      "uncertainty": "Mide superficie edificada; no es directamente comparable con clase urbana de Dynamic World",
      "status": "modeled"
    }
  ],
  "downloads": {
    "water_csv": "data/water_use_saguapac_2025.csv",
    "soil_csv": "data/soil_texture_summary.csv",
    "urban_csv": "data/urban_expansion_annual.csv",
    "geopackage": "data/expediente_santa_cruz.gpkg",
    "soil_geotiff": "data/soilgrids_texture_0_5cm.tif",
    "urban_geotiff": "data/dynamic_world_change_2016_2025.tif",
    "bibliography": "data/bibliografia.bib"
  }
}