Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Leaflet Layer OverPass

Bower version

What is it?

A Leaflet plugin to create a custom POI overlay - thanks to the OSM dataset and the Overpass API

checkout the demo


You can use bower to install leaflet-layer-overpass.

Simply run

$ bower install --save leaflet-layer-overpass

After that you can include and use the OverpassLayer.css and OverpassLayer.js files (or OverPassLayer.min.js if you want the minified version) from the dist folder in your html.

How to use it?

var attr_osm = 'Map data &copy; <a href="">OpenStreetMap</a> contributors',
attr_overpass = 'POI via <a href="">Overpass API</a>';
var osm = new L.TileLayer('http://{s}{z}/{x}/{y}.png', {opacity: 0.7, attribution: [attr_osm, attr_overpass].join(', ')});

var map = new L.Map('map').addLayer(osm).setView(new L.LatLng(52.265, 10.524), 14);

//OverPassAPI overlay
var opl = new L.OverPassLayer({
  query: "node(BBOX)['amenity'='post_box'];out;",


In order to get a valid query the Overpass-turbo IDE might help.

What are the options?

You can specify an options object as an argument of L.OverPassLayer.

options: {
  endpoint: "",
  query: "node(BBOX)['amenity'='post_box'];out;",
  debug: false,
  callback: function(data) {
    for(var i=0;i<data.elements.length;i++) {
      var e = data.elements[i];

      if ( in this.instance._ids) return;
      this.instance._ids[] = true;
      var pos = new L.LatLng(, e.lon);
      var popup = this.instance._poiInfo(e.tags,;
      var color = e.tags.collection_times ? 'green':'red';
      var circle =, 50, {
        color: color,
        fillColor: '#fa3',
        fillOpacity: 0.5
  minZoomIndicatorOptions: {
    position: 'topright',
    minZoomMessageNoLayer: "no layer assigned",
    minZoomMessage: "current Zoom-Level: CURRENTZOOM all data at Level: MINZOOMLEVEL"

Used by


  • Leaflet (tried with version 0.6.2, 0.7.3)


In order to contribute to the project you should first clone the repository. The javascript source files reside in the src folder and are concatenated and minified by gulp. If you want to make changes make them in the src folder and then build the dist file with gulp. For that you first need to install gulp if you do not have installed it yet

$ npm install --global gulp

Then install all the needed packages for this project:

$ npm install 

And then just run


after you made your changes. This will combine (and minify) the files and put them into the dist folder.

Further Ideas

  • OverPass result to -> geoJSON to -> Leaflet Layer to support ways and areas as well (see also PoiMap, OverPassTurbo)
  • improve popup text. use links, format addresses and contact details (compare with OpenLinkMap)
  • improve caching - allow to store data for some days in browser


This is an simple way to bring OSM data as POI overlay on your leaflet Map



You can’t perform that action at this time.