使用Tidycensus调用ACS数据时遇API错误，如何解决？

针对你用tidycensus的get_acs函数提取加州2020年ACS tract级职业数据（B24010表）时出现的API错误，可按以下步骤排查解决：

• 验证Census API密钥配置
  首次使用tidycensus必须配置Census API密钥，若之前配置过可能存在密钥失效或输入错误的情况。重新执行以下代码设置密钥（替换为你的有效密钥），并重启R：

  census_api_key("你的Census API密钥", install = TRUE)
  

• 检查地理层级与表的兼容性
  部分ACS表并非支持所有地理层级，先暂时移除geometry = TRUE参数，测试纯数据请求是否正常：

  occupation <- get_acs(
      geography = "tract", 
      table = "B24010",
      state = "CA", 
      year = 2020,
      cache_table = TRUE
  )
  

  如果请求成功，再添加geometry = TRUE，同时确保已安装并更新sf包（tidycensus依赖sf处理空间数据）：

  install.packages("sf")
  

• 清理损坏的变量缓存
  错误提示已缓存B24010的变量集，若缓存文件损坏会导致API调用异常。找到tidycensus的默认缓存目录~/.cache/tidycensus，删除与B24010相关的缓存文件后，重新运行代码。

• 规避API调用频率限制
  Census API有调用频率限制（每秒最多5次，每日最多5000次），短时间内多次调用可能触发限流。可添加slow = TRUE参数降低请求速率，或暂停几分钟后重试：

  occupation <- get_acs(
      geography = "tract", 
      table = "B24010",
      state = "CA", 
      year = 2020,
      geometry = TRUE,
      cache_table = TRUE,
      slow = TRUE
  )
  

• 更新相关R包
  旧版本的tidycensus或依赖包可能存在API兼容性问题，更新所有相关包后重试：

  install.packages(c("tidycensus", "sf", "tidyverse"))
  

内容的提问来源于stack exchange，提问作者SiH