Struct CensusClient 

pub struct CensusClient { /* private fields */ }

Client for US Census Bureau API

Provides access to:

• Decennial Census data
• American Community Survey (ACS)
• Economic indicators
• Population estimates

Example

use ruvector_data_framework::CensusClient;

let client = CensusClient::new(None);
let population = client.get_population(2020, "state:*").await?;
let acs_data = client.get_acs5(2021, vec!["B01001_001E"], "county:*").await?;
let datasets = client.get_available_datasets().await?;

Implementations

impl CensusClient

pub fn new(api_key: Option<String>) -> Self

Create a new Census Bureau client

Arguments

• api_key - Optional Census API key (500 req/day without key, unlimited with key) Get key at: https://api.census.gov/data/key_signup.html

pub fn with_config( api_key: Option<String>, embedding_dim: usize, use_mock: bool, ) -> Self

Create a new Census client with custom configuration

Arguments

• api_key - Optional Census API key
• embedding_dim - Dimension for embeddings
• use_mock - Use mock data when API is unavailable

pub async fn get_population( &self, year: u32, geography: &str, ) -> Result<Vec<SemanticVector>>

Get population data for a specific year and geography

Arguments

• year - Census year (e.g., 2020, 2010)
• geography - Geography filter (e.g., “state:*”, “county:06”, “us:1”)

Example

// Get all states population
let pop = client.get_population(2020, "state:*").await?;

// Get California counties
let ca_counties = client.get_population(2020, "county:*&in=state:06").await?;

pub async fn get_acs5( &self, year: u32, variables: Vec<&str>, geography: &str, ) -> Result<Vec<SemanticVector>>

Get American Community Survey 5-year estimates

Arguments

• year - Survey year (2009-2021+)
• variables - Variable codes (e.g., [“B01001_001E”] for total population)
• geography - Geography filter

Example

// Get median household income for all states
let income = client.get_acs5(
    2021,
    vec!["B19013_001E"],
    "state:*"
).await?;

pub async fn get_available_datasets(&self) -> Result<Vec<SemanticVector>>

Get available Census datasets

Example

let datasets = client.get_available_datasets().await?;
for ds in datasets {
    println!("Dataset: {}", ds.metadata.get("title").unwrap());
}

pub async fn search_variables( &self, dataset: &str, query: &str, ) -> Result<Vec<SemanticVector>>

Search for variables in a dataset

Arguments

• dataset - Dataset identifier (e.g., “acs/acs5”, “dec/pl”)
• query - Search query for variable names/labels

Example

let vars = client.search_variables("acs/acs5", "income").await?;