osm-lib

A library for loading and indexing OSM PBF files for random access

License	BSD Two Clause
GroupId	com.conveyal
ArtifactId	osm-lib
Last Version	1.4.0
Release Date	Jun 20, 2018
Type	jar
Description	osm-lib A library for loading and indexing OSM PBF files for random access
Project URL	https://github.com/conveyal/osm-lib
Source Code Management	https://github.com/conveyal/osm-lib

Download osm-lib

Filename	Size
osm-lib-1.4.0.pom
osm-lib-1.4.0.jar	84 KB
osm-lib-1.4.0-sources.jar	56 KB
osm-lib-1.4.0-javadoc.jar	246 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.conveyal/osm-lib/ -->
<dependency>
    <groupId>com.conveyal</groupId>
    <artifactId>osm-lib</artifactId>
    <version>1.4.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.conveyal/osm-lib/
implementation 'com.conveyal:osm-lib:1.4.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.conveyal/osm-lib/
implementation ("com.conveyal:osm-lib:1.4.0")

Apache Buildr

'com.conveyal:osm-lib:jar:1.4.0'

Apache Ivy

<dependency org="com.conveyal" name="osm-lib" rev="1.4.0">
  <artifact name="osm-lib" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.conveyal', module='osm-lib', version='1.4.0')
)

Scala SBT

libraryDependencies += "com.conveyal" % "osm-lib" % "1.4.0"

Leiningen

[com.conveyal/osm-lib "1.4.0"]

Dependencies

compile (9)

Group / Artifact	Type	Version
net.sf.trove4j : trove4j	jar	3.0.3
com.beust : jcommander	jar	1.72
com.google.guava : guava	jar	24.0-jre
org.mapdb : mapdb	jar	1.0.8
org.slf4j : slf4j-api	jar	1.7.25
ch.qos.logback : logback-classic	jar	1.2.3
org.openstreetmap.osmosis : osmosis-osm-binary	jar	0.45
org.glassfish.grizzly : grizzly-http-server	jar	2.4.3
org.roaringbitmap : RoaringBitmap	jar	0.7.3

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

osm-lib

A library for random entity access inside OSM files of any size, up to and including planet.pbf.

Build the JAR

$ mvn clean package

Run Vanilla Extract

$ mvn exec:java -Dexec.mainClass="com.conveyal.osmlib.VanillaExtract" -Dexec.args=...

Replicate the planet or a smaller region

You'll want to load from a PBF source that contains a timestamp if you want minutely updates. Planet mirrors, Mapzen Metro Extracts, and Geofabrik extracts contain timestamps. Watch for the timestamp to appear as the load process begins just to make sure it was properly read.

VanillaExtract /mnt/ssd2/vexdata --loadURL http://ftp.snt.utwente.nl/pub/misc/openstreetmap/planet-latest.osm.pbf

VanillaExtract vex.data --loadURL https://s3.amazonaws.com/metro-extracts.mapzen.com/aarhus_denmark.osm.pbf

VanillaExtract /mnt/ssd2/vexdata --load /home/abyrd/france.osm.pbf

VanillaExtract /mnt/ssd2/vexdata --load /home/abyrd/belgium.vex

Load planet from an FTP server in the background

$ nohup time mvn exec:java -Dexec.mainClass="com.conveyal.osmlib.VanillaExtract" -Dexec.args="/mnt/ssd2/vexdata --loadURL ftp://ftp.spline.de/pub/openstreetmap/pbf/planet-latest.osm.pbf" &

Run an extract server with minutely updates

VanillaExtract /mnt/ssd2/vexdata

Fetch a geographic extract

Near Aarhus, Denmark as PBF

wget http://localhost:9001/56.12761,10.056558,56.179451,10.144608.pbf

Near Aarhus, Denmark in VEX format

wget http://localhost:9001/56.12761,10.056558,56.179451,10.144608.vex

Conveyal

Urban transport analysis

Versions

Version
1.4.0 Jun 20, 2018
1.3.0 Mar 2, 2018
1.2.0 May 8, 2017
1.1.1 Mar 21, 2017