Planet.osm is the OpenStreetMap data in one file: all the nodes, ways and relations that make up our map. A new version is released every week. It's a big file (on 2022-07-01, the plain OSM XML variant takes over 1606.7 GB when uncompressed from the 116.8 GB bzip2-compressed or 64.1 GB PBF-compressed downloaded data file).
There are also files called Extracts which contain OpenStreetMap Data for individual continents, countries, and metropolitan areas.
The two main formats used are PBF or bzip2-compressed OSM XML. PBF (Protocol Buffer Format) is a compact binary format that is smaller to download and much faster to process and should be used when possible. Most common tools using OSM data support PBF.
For an overview over all osm file formats and conversion tools have a look at OSM file formats.
If you are using traditional GIS tools you may want to look at Processed data providers.
See downloading data for tools to make downloading easier, including an option to use all mirrors at once, automatically do md5 hash validation, and other features.
As of Nov/2020, official torrents have now been implemented!
BitTorrent RSS/Atom feed
If you have bandwidth and disk space as well as BitTorrent client which supports Broadcatching (RSS), and would like to help with reducing load on OSM servers and improving download speeds for everyone, please join the BitTorrent swarm by using following RSS feeds (first and second are probably the most popular, but it you have resources please do share all of them):
There is no pressing need to continue seeding old files after a month, unless you really want to (the most help is in first 7-14 days).
If your client does not support RSS, but you run a GNU/Linux system, you can use scripts like https://github.com/osm-hr/planet-mirror in your cron to automate joining the BitTorrent swarm and removing old planet files.
For security reasons, consider using HTTPS sources if available, rather than HTTP or FTP. Some Internet users may experience problems with IPv4-only sources when their Internet access (notably mobile accesses) offers native routing only though IPv6, and where IPv4 is only supported by their ISP using temporary NAT sessions via proxies (which may not be reliable for very large file downloads, even if HTTPS is used).
Mirrors are encouraged to support connections from IPv6, and to support secured protocols to reliably authenticate their sources (encryption is not required as the data is published, so this should not be a performance issue on servers, but this requires installing server-side certificates and renew them regularly before they expire). The support of RSYNC on these sources is also useful to allow fast incremental synchronization to other local mirrors, and it should be secured as well. Some mirrors also support peer-to-peer delivery with BitTorrent protocol as active webseeds.
All files also come with a .md5 signature file. Use it to check your downloads (especially when using FTP: using RSYNC or Torrent will generally avoid download issues such as truncated files) ! You should first check for the existence of the .md5 file before trying to download actual data (which may sometimes be in a transient state while a mirror is being synchronized with a recent dump). Also make sure your browser or downloader client supports the transfer of large files over 2 GB, as well as your local OS and file system for storing such files.
|Mirror||Available Planet data||Network protocols|
|planet.openstreetmap.org/ (original source, use another mirror below as much as possible)||
|free.nchc.org.tw/osm.planet/ (source: gwdg.de)||
|archive.org/details/osmdata (Internet Archive, available under various items. Instructions on searching items is available in the "About" tab. Not part of official torrent swarm)||
|osm.cquest.org/torrents/ Since 2021-04-21 does not act as (hidden) webseed anymore, and publishes regular torrents||
but in test and manual update.
|planet.osm-hr.org Last 15 days||
Country and area extracts
Worldwide extract sources
|www.overpass-api.de||Overpass API excerpts up to ~300MB uncompressed||Minutely||yes, since v0.7.50||yes||Optional|
|download.openstreetmap.fr/||Minutely diffs and daily extracts in PBF:
|download.geofabrik.de||Daily extracts in PBF stripped from personal metadata (user names, user IDs, changeset IDs):
Note: Extracts are not suitable for editing.
|Daily||yes||yes||Version and timestamp only|
|osm-internal.download.geofabrik.de||Same as download.geofabrik.de but with full personal metadata:
Note: Login with OSM account required. Files are subject to data protection regulation.
|download.bbbike.org/osm/||Different extracts offered:
Note: Extracts are not suitable for editing OSM, because they omit metadata such as version number. See the FAQ.
|protomaps.com/extracts||Extracts up to ~100 million nodes in PBF
||Minutely||no||yes||Version for all objects; Timestamp for ways, relations and tagged nodes|
Regional extract sources
|osm.kewl.lu/luxembourg.osm/||Luxembourg (beta)||Hourly||Yes but not Osmosis/Pyosmium compatible directory structure||yes||Partially|
|planet.osm.ch||Swiss extract from the Swiss OpenStreetMap association. Including all lakes crossing the Swiss boundary and a few km of the surrounding countries.||Hourly||yes||yes||All fields|
|osm.fit.vutbr.cz/extracts/czech_republic/||Czech Republic||Daily||no||yes||version and timestamp only|
|data.osm-hr.org||Croatia, Slovenia, Bosnia and Herzegovina, Montenegro, Macedonia, Serbia, and Kosovo, Albania, Bulgaria, Hungary, Romania||Daily||yes||yes||all fields|
|osmit-estratti.wmcloud.org||Italy; daily extracts for Italian regions, provinces and municipalities; supported file formats: PBF, GeoPackage and OsmAnd OBF (Regions only).||Daily||no||yes||Partially|
|osm.kcwu.csie.org/download/tw-extract/||Taiwan; only o5m format||Daily||Yes but not Osmosis/Pyosmium compatible directory structure||yes||all fields|
Global thematic extracts
- OpenStreetMapData provides shapefiles of global coastlines, land polygons or water polygons.
- osmdata.xyz provides monthly, global GeoPackages of each primary feature key.
A new version of planet.osm is released weekly (currently every Wednesday morning). We have these, going back to the start of April 2006.
The size of a planet.osm file can be seen in the header information on the planet download page. Planet files are very large (tens of GBs) so please check the size before starting to download.
The weekly dump normally starts at around 01:10am UK time on Monday morning and is guaranteed to contain all updates prior to that time. The dump is constructed from a database dump using conversion software, and the result should ensure referential integrity. Please note that this doesn't always apply to extracts. The dump and conversion normally takes around 48 hours to complete, in total, and the result is usually ready on Wednesday morning.
Note: The timestamp of the file is recorded in it like this : <osm version="0.6" generator="OpenStreetMap planet.c" (...) timestamp="2013-01-02T01:10:14Z"> it will be useful to decide what "diffs" to use if you want them :
Additionally we offer regular diffs. These are produced daily (under the 'daily' subdirectory) and more recently we also offer hourly diffs and minutely diffs. These have been produced with Osmosis and can be used to reconstruct the full dataset (see examples at OSM Wiki pages Osmosis and osmupdate). Since these only contain the differences, they are much smaller files; A daily diff is generally about 40 MB compressed. For more information please see Planet.osm/diffs
Small region OSM DB-only copy
Q: I would like to set up a copy of OSM DB only for a small region and then keep it up to date with the replicates
You will need to apply the full diffs and afterwards cut off anything you're not interested in.
If you intend to do it for a rather small area then it is really quite easy and performs well with Osmosis. Assuming you have a current extract of your area in "current.osm" and you have the Osmosis replication set up properly (--rrii), then you simply run
osmosis --rri --simc --rx current.osm --ac --bb left=42 right=42 top=42 bottom=42 clipIncompleteEntities=yes --wx new.osm && mv new.osm current.osm
as often as you like (adapt the 42's in the bounding box).
Processing the file
See Databases and data access APIs#Database Schemas for loading a planet file into a database.
See OSM file formats#Map-data for a list of tools which are able to manipulate osm files.
See Frameworks for accessing osm files from your software.
Unpacking .bz2 files
Osmosis and osm2pgsql allow you to use the files in bz2-compressed form. If you need to unpack it from bz2 format, use 7-zip on Windows; on Linux just type bzip2 -d planet.osm.bz2; or your OS may support double-click unpacking. See Wikipedia's list of compression programs.
If you are handling the compression yourself with libbzip2, then note that the files are compressed with pbzip2 and contain multiple streams that need to be handled as described in section 3.4.8 of the bzip2 documentation.
During download, the network will be your bottleneck. Once you have the file you will need to unpack it, and then disk I/O will be your bottleneck. Or you can work with the bzip'ed file, but then the CPU will be your bottleneck. If you have sufficient space to unpack the full planet file, you can save a lot of time and disk thrashing by unpacking it on the fly while downloading it: try
curl -L https://planet.openstreetmap.org/planet_latest.osm.bz2 | pbzip2 -cd >planet_latest.osm.
In most cases, using import tools supporting the PBF format will be a faster and more efficient solution. They can be processed directly without unpacking to plain OSM XML format and PBF-compressed OSM files are always smaller than bzip2-compressed OSM files and faster to download.
Additional technical notes
wget: Alternatively to curl,
wget -O - may be used. Due to the size of the planet files, older distributions of wget may fail to work since they may not support file sizes larger than 2 GiB, and attempting to download files larger than that will report a negative file size and fail.
pbzip2: may be replaced by the single-threaded
bzip2 -cd /
bzcat as well.
Note that planet download have ways that reference nodes that are not in the same file.
Due to performance reasons it isn't possible oto get a fully consistent snapshot of the database. Although the dump is run in a transaction, the isolation level required for a "snapshot"-style dump dramatically increases the running time. You might find that, if you have been editing while the export has been running, that the way may be in there but the nodes are not. You can take a planet file and apply the daily diffs using Osmosis to create a consistent planet file (however you may still have some problems with old bad data in OpenStreetMap from before the introduction of the API 0.6).
Country extract may have ways that reference nodes that are not in the same file.
This is perfectly normal depending on the settings used in the extraction process. There are two options; either the ways at the boundary have been truncated (such as in the GeoFabrik downloads), or the nodes are just left out and the ways are left as is (for example the CloudMade downloads).
Handling missing references
This really depends on what you are doing with the data. You can either drop the node references or you can go to another data source, such as the API, to fetch the missing nodes.
Other planet files
- GPS Traces can be found in planet.gpx
- Old versions of the planet file are available at https://planet.openstreetmap.org/ and the mirrors as well.
- An experimental full history file is available, containing every revision of each object.
Planet files remain licensed under the same license as the master OpenStreetMap geo-database from which they are extracted - currently this is the Open Database License. Planet files from before September 12, 2012 have a Creative Commons Attribution-ShareAlike 2.0 license.