Skip to content

bblocks-places

Resolve and standardize places and work with political and geographic groupings.

GitHub Repo GitHub License PyPI - Version Codecov

Working with country data can be tedious. One source calls it “South Korea” another says “Republic of Korea” a third uses “KOR” — and suddenly your analysis breaks and you spend hours manually standardizing all the names. These inconsistencies are common in cross-geographic datasets and can lead to data cleaning headaches, merge errors, or misleading conclusions.

bblocks-places eliminates this hassle by offering a simple, reliable interface to resolve, standardize, and work with country, region, and other place names.

Key features:

  • Disambiguate and standardize free-text country names (e.g. "Ivory Coast" → “Côte d’Ivoire”)
  • Convert between place formats like ISO codes and official names
  • Filter and retrieve countries by attributes like region, income group, or UN membership
  • Customize resolution logic with your own concordance or override mappings

Built on top of Google's Data Commons, an open knowledge graph integrating public data from the UN, World Bank, and more.