Repository navigation
Update the app and the mod (Mod Hub or realmap-mod-1.3.0.zip, then restart the game). The mod only changes its version number, which must match the app's.
Why this release
Players importing a whole country (Poland) hit two problems: first the preview stopped with « Maximum call stack size exceeded » (fixed in 1.2.2), then the map had no towns and no water, only the relief and the industries. The OpenStreetMap servers (Overpass) cannot handle a country in one request: they stop it after a few minutes and still answer « OK » with an empty list. RealMap took that empty answer as real data and even kept it in its cache. This release fixes the cause, and changes the way very large areas get their data.
Whole countries: Geofabrik extracts
Areas over 20,000 km² (a large region or a whole country) no longer use Overpass. The Overpass documentation itself says that country-sized extractions belong to downloadable extracts. RealMap now uses the free daily extracts of Geofabrik (OpenStreetMap data, ODbL).
Choosing what to download
- RealMap finds the extracts that cover your area, as fine as possible: Polish voivodeships, German Länder, Czech regions, small countries. It never picks a whole continent just because a corner of the map is at sea.
- Before anything is downloaded, a checklist shows each region with:
- its download size (or « in the cache », or « ready » if it was already read for this map);
- its estimated time (download and reading);
- the share of your area it covers.
- The total size and the total time update as you tick and untick. « Tick all » and « Untick all » are there too.
- Heavy neighbouring countries that only touch a thin strip of the map (under 1 % of the area, over 100 MB) start unticked; tick them back if you want their towns. A region left unticked gets no real towns, water or industries, and the journal names it.
- For the whole of Poland, the usual choice is about 6 GB (38 regions).
Downloading and reading
- Downloads are streamed straight to disk, resume after a cut where they stopped (on the same dated file, never mixing two versions), and check their size.
- Each region is read on your computer (in Rust, on all processor cores) as soon as it is downloaded, while the next one downloads. A 55 MB region reads in under a second.
- The step shows « 1.2 / 6.2 GB · region 5/38 · reading region 3/38 ».
- The estimated times learn from your own connection and computer after each run.
- Files stay in the cache for 30 days: the next maps in the same area start at once. Each region is read once per map frame and kept: ticking one more region only reads that one.
Same result as Overpass: on a test region (Opolskie), the extract gives the same places (111 / 111), roads (2,103 / 2,103), industrial sites (13 / 13) and land use (706 / 706) as Overpass, and 963 water areas against 961.
Very large areas: memory and data quality
- Relief: for a very large area, the Copernicus relief tiles are read at a resolution that suits the map (1/2 to 1/8, only the part needed is downloaded) instead of full 30 m resolution: a whole country needed about 2.5 GB of relief in memory (5 GB at peak), now a few tens of MB. The export reads them again at the finer level it needs.
- OpenStreetMap shapes are simplified to the map's precision (on maps where one cell covers more than about 40 m of real ground), keeping every road junction, and data outside the map frame is left out.
- Sea floor: the EMODnet sea floor of a very large area is requested at a suitable resolution (it used to ask for over 200 MB, fail, and silently fall back to the coarser ETOPO data).
- Project files: if the data of an area is too large for the project file, the project is saved without it (a warning says so); the data is read again from the cache when the project is opened.
- Usual maps are not affected: every reduction only starts beyond a threshold that regular map sizes and scales do not reach.
Lists of towns and industries
- You choose when the map is updated. Ticking or unticking towns, industries, roads or railways (in the lists or on the map) no longer recomputes the map every time. The bottom of the Lists panel shows « N changes pending » and an « Update the map » button. Tick « Update automatically » to get the old behaviour back. Changed lines are marked « pending » until the update.
- Many at once.
- Towns: filter by name, type (city, town, village), minimum population, ticked or not.
- Industries: filter by name, industry type and origin (OpenStreetMap, land cover, chain, added by hand).
- Then « Tick the N » or « Untick the N » applies to everything in the filter, in one click.
- A whole country has tens of thousands of places: the list shows the first 300 lines, the buttons always act on the whole filter.
- A warning shows when more towns are ticked than the game puts on a map of that size (they are placed if there is room).
- The automatic update of the advanced options only follows the options now, not these choices.
- The Lists panel is wider (520 px) and can be resized by dragging its right edge; its width is remembered.
Usual areas (Overpass)
- Towns no longer depend on the water. Places have their own light request. If a request fails, you get a clear error instead of a map without towns.
- Following the Overpass rules (usage policy):
- each request declares the time and memory it really needs, so busy servers accept it sooner (the maximum used to be requested from about 4,000 km² on);
- when a server asks to slow down (HTTP 429), RealMap waits 30 seconds as the documentation asks;
- it never runs more requests at once than the server allows;
- an answer cut short by the server (« runtime error », out of time or memory) is detected, never kept in the cache, and requested again in up to 256 smaller pieces.
Other fixes
- Download caches are written safely: an interrupted download no longer leaves a broken file that blocked the next imports. Empty answers kept by earlier versions are downloaded again.
- The technical journal now says when a download falls back to another source, is cut short, or is split, and gives the download and reading speeds.
- Region names from Geofabrik no longer show HTML tags («
»). - New texts are translated into German, Italian, Spanish and Simplified Chinese.
Thanks to the players who reported the Poland imports!
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.