Planet.osm

From OpenStreetMap Wiki
(Redirected from Planet)
Jump to: navigation, search
Available languages — Planet.osm
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Basa Sunda · Baso Minangkabau · bosanski · brezhoneg · català · čeština · corsu · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tagalog · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · भोजपुरी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · བོད་ཡིག · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ‎ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 中文(繁體)‎ · 吴语 · 粵語 · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް

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 2017-06-05, the plain OSM XML variant takes over 803 GB when uncompressed from the 57.6 GB bzip2-compressed or 35.8GB PBF-compressed downloaded data file).

There are also files called Extracts which contain OpenStreetMap Data for individual continents, countries, and metropolitan areas.

Format

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.

Downloading

See below for usage instructions.

Planet.osm mirrors

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
Prefered URL Loc Updated Diffs .osm.pbf .osm.bz2 HTTP HTTPS FTP RSYNC Torrent IPv6
planet.openstreetmap.org/ (original source, use another mirror below as much as possible)
GB
(Source) yes yes yes yes yes yes yes no yes
ftp5.gwdg.de/pub/misc/openstreetmap/planet.openstreetmap.org/
DE
Daily yes yes yes yes yes yes yes no yes
free.nchc.org.tw/osm.planet/ (source: gwdg.de)
TW
Daily yes yes yes yes no yes yes no yes
ftp.heanet.ie/mirrors/openstreetmap.org/
IE
Weekly (+10h) yes yes yes yes yes yes yes no yes
archive.org/details/osmdata (Internet Archive, available under various items: you will loose time browsing every icons 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)
US
Weekly (variable delay) no yes yes yes yes no no yes no
ftp.snt.utwente.nl/pub/misc/openstreetmap/
NL
Weekly no yes yes yes no yes yes no yes
ftp.spline.de/pub/openstreetmap/
DE
Weekly no yes yes yes yes yes yes yes no
ftp.osuosl.org/pub/openstreetmap/
US
Weekly no yes yes yes yes yes yes no no
download.bbbike.org/osm/planet/
DE
Weekly no yes no yes yes no no no no

Country and area extracts

Worldwide extract sources

Mirror Area Updated Diffs HTTPS
www.overpass-api.de Overpass API excerpts up to ~300MB uncompressed Minutely yes, since v0.7.50 yes
Trimble Data Marketplace Worldwide coverage:
  • Clip to any area you want - draw a polygon by hand or use a KML (1,000 vertex limit) to define your clip area
  • Choose any and all Map Features tags
  • Reproject
  • Supported formats: SHP, Esri FGDB, Safe FFS, GML, CSV, KML and DWG

view quick walkthrough

Minutely yes yes
download.geofabrik.de daily extracts in PBF:
  • entire continents
  • all European countries
  • sub-country admin regions for France, Germany, UK, Italy, Russia and Poland
  • many countries outside Europe
  • States in the USA and Provinces in Canada
Daily yes yes
download.bbbike.org/osm/ Different extracts offered:
  • more than 200 cities and regions worldwide
  • extract your own individual area
  • many different formats: OSM XML, PBF, Garmin cycle map, Osmand, mapsforge, Navit, SVG, PNG, maps.me and ESRI shapefile

Note: Extracts are not suitable for editing OSM, because they omit metadata such as version number. See the FAQ.

Weekly no yes
mapzen.com/data/metro-extracts/ Individual cities: Weekly no yes
download.gisgraphy.com monthly extracts in PBF: Monthly no yes

Regional extract sources

Mirror Area Updated Diffs HTTPS
osm.kewl.lu/luxembourg.osm/ Luxembourg (beta) Hourly no no
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
download.freemap.sk/slovakia.osm/ Slovakia Daily no yes
osm.kyblsoft.cz/archiv/ Czech Republic Daily no no
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 extracts in PBF
  • daily Garmin maps
  • daily Osmand maps
  • Croatia archive
  • Croatia diff's
  • planet thematic extracts
Daily no no
osm.ramuno.lt Lithuania
  • daily extracts in PBF and O5m
  • daily garmin maps
  • daily osmand maps
  • daily extracts of transport layer
Daily no no
estratti.openstreetmap.it Italy
  • daily extracts in PBF, SHP, OSM XML formats
  • municipal and regional sizes.
  • mapping statistics per local area
Daily no yes
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)
yes no

Global thematic extracts

BitTorrent

Original source

The originating URL is https://planet.openstreetmap.org/. Please use a mirror if you can.

Update frequency

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 - see Planet.osm/FAQ. 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

Technical notes

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 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.

Other planet files

License

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.