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 2018-09-01, the plain OSM XML variant takes over 964 GB when uncompressed from the 69.3 GB bzip2-compressed or 41.4GB PBF-compressed downloaded data file).
There are also files called Extracts which contain OpenStreetMap Data for individual continents, countries, and metropolitan areas.
- 1 Format
- 2 Downloading
- 3 Technical notes
- 4 Other planet files
- 5 License
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 have a look at OSM file formats.
If you are using traditional GIS tools you may want to look at Processed data providers.
See below for usage instructions.
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.
All files also come with a .md5 signature file. Use it to check your downloads (especially when using FTP: using RSYNC or Torrent will generaly 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 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)||
|ftp.heanet.ie/mirrors/openstreetmap.org/ (stopped mirroring OSM after some major incident)||
|archive.org/details/osmdata (Internet Archive, available under various items: you will lose time browsing every icon to find what you are looking for! Select the list view instead, and enable details below titles to see dates of initial publication instead of date of last synchronization)||
|Weekly (variable delay)||no||yes||yes||yes||yes||no||no||yes||no|
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|
|download.openstreetmap.fr/||Minutely diffs and daily extracts in PBF:
|download.geofabrik.de||Daily extracts in PBF:
|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.
|download.gisgraphy.com||monthly extracts in PBF:
Regional extract sources
|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|
|planet.openstreetmap.ie||Ireland (Republic of Ireland and Northern Ireland) extract||Hourly||yes||no|
|ftp5.gwdg.de/pub/misc/openstreetmap/||Germany, other countries in the European Economic Area (European Union, and European Free Trade Area).||Daily||yes||yes|
|gis-lab.info/projects/osm_dump/||Russia regions, Belarus, Lithuania, Latvia, Ukraine, and other present (or past) member countries of CIS or the former USSR.||Daily||yes||yes|
|data.osm-hr.org/||Countries in the former Yugoslavia (Croatia, Slovenia, Bosnia and Herzegovina, Montenegro, Macedonia, Serbia, and Kosovo), Albania, Bulgaria, Hungary, Romania, and Latvia (Geofabrik copy)||Daily||no||no|
|www.geodati.fmach.it/gfoss_geodata/osm/italia_osm.html||Italy and regions||Weekly||no||no|
|planet.openstreetmap.nl||Benelux (Belgium, the Netherlands, and Luxembourg), and Dutch dependencies (Aruba, Bonaire, Curaçao, Saba, Sint Eustatius, and Sint Maarten)||Unknown
(last updated 2014-11-22)
Global thematic extracts
- OpenStreetMapData provides shapefiles of global coastlines, land polygons or water polygons.
- Bittorrent service at osm-torrent.torres.voyager.hr has been shut down as of 2014-09-15
- As a replacement mainly for Osm2Garmin users, torrents for PBF files are available starting from 2014-09-24 at this site.
- A Weekly mirror of the continents-files from download.geofabrik.de is made available on IPFS at `/ipns/ipfs.placebazaar.org`, Accessible with any IPFS client, or via a gateway. For example ipfs.io/ipns/ipfs.placebazaar.org. A server is dedicated to seeding this data for a week.
The originating URL is https://planet.openstreetmap.org/. Please use a mirror if you can.
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 is about 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
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 it 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 possibly to 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 missed 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.