PyWorldAtlas

Start here

  • Quickstart
    • Install
    • Meet a country
    • Look up, search, and collect
    • Combine facts with geography
    • What to remember
    • Where to go next
  • Playground
    • What is running?
    • Things worth trying
    • Use the package locally
  • Installation
    • Requirements
    • Published package
    • Optional 3D maps
    • Install a source checkout
    • Install the built wheel offline
    • Verify the installation

Examples and learning

  • Learning activities
    • A country in one friendly call
    • A gallery of writing systems
    • Turn coordinates into a compass activity
    • Explore nearby cities
    • Build a repeatable multiple-choice lesson
    • Where to go next
  • Example programs
    • Build a world snapshot
    • Print a country dossier
    • Cross four writing systems
    • Create a comparison table
    • Build a distance toolkit
    • Search and explore nearby cities
    • Trace geographic relationships
    • Explore a climate profile
    • Compose search, filters, and rankings
    • Create a repeatable lesson
    • Export a portable Unicode profile
    • Continue exploring

Explore the atlas

  • Country profiles
    • Profile example
    • Current field coverage
    • Convenience and discovery views
    • Physical geography
    • Names and aliases
    • Capital and cities
    • Sources
    • Immutability
  • Interactive 3D maps
    • Choose a map edition
    • Open your first map
    • Select a quality explicitly
    • Notebooks, customization, and export
    • Data meaning and limits
  • Physical geography
    • A country in four lines
    • Area and coastline
    • Elevation and named extremes
    • Rivers and lakes
    • Climate profiles
    • Physical filters and rankings
    • Learning prompts
    • Executable example
  • Country reference facts
    • Anthem titles
    • Reviewed mottos
    • Demonyms
    • Practical metadata
    • Coverage
    • Source inspection
  • Rankings and nearby capitals
    • Profile filters
    • Country rankings
    • Nearest capitals
  • Local names and writing systems
    • Coverage at a glance
    • Understand the English fields
    • Start with one country
    • Explore writing systems
    • Inspect the evidence level
    • Romanization is source data
    • Discover coverage
    • How the language is selected
    • Source and review rules
    • Try the example
  • Capitals and major cities
    • Capital records
      • Missing capitals
    • Major cities
    • Search city names
    • Find nearby cities
  • Coordinates and distances
    • Look up coordinates
    • Distance between places
    • Country and model inputs
    • Raw latitude and longitude
    • Friendly coordinate labels
    • Country coordinates
  • Land borders and paths
    • API at a glance
    • Neighbors
    • Shared neighbors
    • Shortest land paths
    • Land connectivity
    • Connected land regions
    • Border flashcards
    • Where each value comes from
    • Data policy
    • Executable example
  • Discovery tools
    • Readable country summaries
    • Flag emoji
    • Derived profile facts
    • Discovery cards
    • Reproducible country samples
    • Structured flashcards
    • Multiple-choice questions
      • Supported topics
    • Data and interpretation
    • Executable example
  • Lookup and search
    • Exact lookup
    • Safe lookup
    • Ranked search
    • City-name search
    • Filtering
  • Serialization
    • Dictionary output
    • JSON output
    • Local-name provenance
    • Discovery values
    • Reference facts and ranking results
    • Border paths

Data and trust

  • Why PyWorldAtlas?
    • The product promise
    • Who is it for?
    • What it is not
  • Educational purpose and editorial policy
    • Editorial commitments
    • How sources are selected
    • Names, areas, and borders
    • Publication boundaries
    • Using the package in education
    • Community and corrections
    • Version 0.5.0
  • Data sources and freshness
    • Field-specific source policy
    • United Nations M49
    • GeoNames
    • Natural Earth
    • Reviewed border decisions
    • Unicode CLDR 48.2
    • IANA Language Subtag Registry
    • CIA World Factbook structured country profiles
    • Köppen-Geiger climate classification maps
    • NOAA NCEI ETOPO 2022
    • Wikidata national-motto statements
    • United Nations Protocol and Liaison Service
    • Wikidata official-name statements
    • UNGEGN List of Country Names
    • Derived discovery values
    • Source priority in the 0.9.0 release
    • Inspect sources in Python
  • Data quality and limitations
    • Educational and editorial quality
    • Validation layers
    • Coverage
    • Missing data is a valid value
    • Interpretation cautions
    • Run the validation suite
  • Project status
    • Coverage at a glance
    • Detailed coverage
    • Build identity
  • Roadmap
  • What 0.9 adds
  • Deferred work

Reference

  • API reference
    • Profile conventions
    • Country identity provenance
    • Reference-fact provenance
    • Discovery calculations
    • Physical-geography provenance
    • Distance input contract
    • City discovery
    • Border API provenance
    • Profile field notes
    • Atlas
      • Atlas
    • Country models
      • Country
      • CountryCodes
      • LocalizedName
      • Currency
      • Language
      • Timezone
      • PostalCodeFormat
      • NationalAnthem
      • NationalMotto
      • Demonym
      • CountryReference
      • CountryDiscoveryCard
    • Geographic models
      • Coordinate
      • Area
      • ElevationPoint
      • River
      • Lake
      • ClimateZone
      • ClimateProfile
      • PhysicalGeography
      • Geography
      • Capital
      • City
    • Results and metadata
      • BorderPathResult
      • CountryRanking
      • CapitalDistance
      • CityDistance
      • CountryMatch
      • Flashcard
      • QuizQuestion
      • DatasetInfo
      • SourceReference
    • Exceptions
      • AtlasError
      • AtlasClosedError
      • DatasetError
      • DatasetNotFoundError
      • DatasetVersionError
      • DatasetIntegrityError
      • CountryNotFoundError
      • AmbiguousCountryError
      • PlaceNotFoundError
      • AmbiguousPlaceError
      • CapitalNotFoundError
      • MapSupportNotInstalledError
    • Optional maps
      • CountryMap
      • available_map_qualities()
      • MapDataError
  • Changelog
    • 0.9.0
    • 0.8.1
    • 0.8.0
    • 0.7.0
    • 0.6.0
    • 0.5.0
    • 0.4.0 — Reserved tag; not published to PyPI
    • 0.3.1
    • 0.3.0
    • 0.2.1
    • 0.2.0 — Unpublished candidate
    • 0.1.0
PyWorldAtlas
  • Search

© Copyright 2026, PyWorldAtlas maintainers.

Built with Sphinx using a theme provided by Read the Docs.