Roadmap
PyWorldAtlas grows through small, installable releases with explicit data, documentation, and compatibility boundaries. Planned work is not part of the public API until it is implemented, tested, documented, and published.
Current release
0.13.0 is friendly by default: one naming style, results that read well, built-in help, world maps of statistics, and a cheat sheet, quests, and dark mode in the docs.
Next milestone
0.14 adds generated reference entries for every country, place, and landmark, and an offline site export.
On the way to 1.0
1.0 comes once the public API has proven stable in real use.
Version |
Status |
Main boundary |
Publication |
|---|---|---|---|
0.1.0 |
Complete |
Rebuilt runtime, generated database, countries, capitals, and cities |
Published |
0.2.1 |
Complete |
Rich profiles, coordinates, distances, and initial discovery tools |
Published |
0.3.1 |
Complete |
Reviewed neighbors, shortest land paths, and border learning tools |
Published |
0.5.0 |
Complete |
Local identities, English formal names, and editorial policy |
Published |
0.6.0 |
Complete |
Reference facts, practical metadata, filters, and rankings |
Published |
0.7.0 |
Complete |
Physical geography, climate classes, feature search, and learning prompts |
Published |
0.8.0 |
Complete |
Summaries, city discovery, coordinate helpers, quizzes, and documentation UX |
Published |
0.9.1 |
Complete |
Optional 3D elevation and climate maps, river overlays, and HTML export |
Published |
0.9.2 |
Complete |
Terrain-height controls, selectable labels, and sharper map presentation |
Published |
0.9.3 |
Complete |
Installation, API-reference, Explore, and project-page polish |
Published |
0.9.4 |
Complete |
Map rotation, speed controls, PNG export, and documentation animation |
Published |
0.9.5 |
Complete |
Installed command, lookup clarity, clean-wheel checks, and documentation audit |
Published |
0.10.0 |
Complete |
Stable API, instant lookups, zero-dependency maps, data packs, and accessibility |
Published |
0.11.0 |
Complete |
Every place on Earth, one search for everything, and places on 3D maps |
Published |
0.12.0 |
Complete |
Statistics and landmarks packs, place quizzes, and the new playground |
Published |
0.13.0 |
Complete |
One naming style, readable results, help, world maps, and friendlier docs |
Published |
0.14.0 |
Planned |
Generated reference entries and offline site export |
Not yet |
What 0.9 adds
The map release is an optional presentation layer over documented geographic sources:
map()resolves any existing country query;show()opens a local browser view;figure()supports notebooks and direct Plotly customization;write_html()creates a standalone offline document with configurable initial rotation;standalone viewers provide rotation-speed and high-resolution PNG controls; and
Overview and Standard editions offer the same 248-profile API at different elevation sampling intervals.
See Interactive 3D maps for installation, examples, sources, and interpretation limits.
Deferred work
Boundary geometry, GeoJSON export, bounding boxes, polygon centroids, and point-in-country lookup remain outside the current plan. The 0.9 viewer uses generalized outlines internally for display but does not expose them as a public geographic geometry API.
Native desktop rendering, Detailed and Ultra map editions, anthem lyrics, audio, contributor histories, and adoption dates also remain outside the current release.