Planet.osm

From OpenStreetMap

Jump to: navigation, search

Planet.osm is a snapshot of the OpenStreetMap database

Contents

What's included?

Planet.osm is the latest revision of the nodes, ways, and relations in the database. This of course includes all the tags. It does not include the editing history. It does not include GPS traces behind the data.

The file is XML formatted and follows an XML Schema (though this is out-of-date)

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 current size of a planet.osm file is over 60 gigabytes (reduced to 3.6GB with bzip2 compression).

The weekly dump starts at 01:00 each Wednesday night and is guaranteed to contain all updates prior to that time. It may contain updates from after the start time, but these may not have referential integrity (eg ways that reference nodes that are not included).

Additionally we offer regular diffs. There 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 under the osmosis page for usage in various scenarios). Since these only contain the differences, they are much smaller files; A daily diff is around 2 or 3 MB.

Downloading

Due to the size of the planet files, some older distributions of wget do not work anymore. They are restricted to files of < 2GB, and attempting to download files larger than that will report a negative file size and fail -- obtain a newer version if that happens to you.

Originating URL:

Please try use a mirror first!

Mirrors

Full Mirrors (probably faster and you don't disturb the osm server ;)

planet.osm-only Mirrors

Extracts

Unpacking the File

To unpack the file on Windows download the 7-zip uncompression tool. On Linux just write bzip2 -d planet.osm.bz2. If you want to do it differently, then check out this list of compression programs.

Processing the File

The file is in the OSM XML format. There are a number of scripts to process the file available in SVN, including ones to put it back into a database.

  • Osmosis is a new Java tool that can import a planet file into your db.
  • planetosm-to-db.pl creates a current-ruby-server-database too (or a slightly different one for PostgreSQL, as used by Where Are They, including the db schema). It stores the node and segment ids in memory, so it can import only some of the data (exclude or include), and normally only uses about 100MB. It is not fast, taking several hours to load a UK-only planet excerpt.
  • If you need a db for testing purposes only, http://richard.dev.openstreetmap.org/osm05.sql.gz is a 75Mb SQL dump of the UK from January 2008. (current_ tables only - but you can populate the other tables from there - and no relations tables.)
  • (Other tools in svn have not been updated for the 0.5 database structure and are consequently not usable.)

Stuff done with planet.osm

  • Script to clip Planet.osm into smaller data file but still keep osm data format (goto www.digitalmobilemap.com and click on FAQ to download the script) using java to clip Planet.osm into a smaller data file that contains only osm map data (nodes/segments/ways) within bounds. The clipped data file not only keeps osm data format but also keeps node's labels and way's labels in Unicode UTF-8 format. The java script does not require much memory and can process large planet.osm file very fast (< 8 minutes). You can use this script to create a smaller planet.osm file. A smaller planet.osm file may be useful for you if you want to import it to your local database server for local development as it will take less time to import and debug.

Past versions of the planet file

Old versions of the planet file are available at http://planet.openstreetmap.org/ as well. The Historical Coverage page describes a service that allows you to view data from the past and how it developed.

Statistics

Personal tools
recent changes