leaflet-control-geocoder

Leaflet Control Geocoder

A simple geocoder for Leaflet that by default uses OSM/Nominatim to locate places, but also supports Bing Locations API and can easily be extended to support other providers.

See the Leaflet Control Geocoder Demo.

Usage

var map = L.map('map').setView([0, 0], 2);
L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png', {
    attribution: '&copy; <a href="http://osm.org/copyright">OpenStreetMap</a> contributors'
}).addTo(map);
L.Control.geocoder().addTo(map);

API

L.Control.Geocoder

This is the geocoder control. It works like any other Leaflet control, and is added to the map.

Constructor

L.Control.Geocoder(options)

Options

Option	Type	Default	Description
collapsed	Boolean	true	Collapse control unless hovered/clicked
position	String	"topright"	Control position
placeholder	String	"Search..."	Placeholder text for text input
errorMessage	String	"Nothing found."	Message when no result found / geocoding error occurs
geocoder	IGeocoder	new L.Control.Geocoder.Nominatim()	Object to perform the actual geocoding queries

Methods

Method	Returns	Description
markGeocode( result)	this	Marks a geocoding result on the map

L.Control.Geocoder.Nominatim

Uses Nominatim to respond to geocoding queries. This is the default geocoding service used by the control, unless otherwise specified in the options. Implements IGeocoder.

Unless using your own Nominatim installation, please refer to the Nominatim usage policy.

Constructor

L.Control.Geocoder.Nominatim(options)

Options

Option	Type	Default	Description
serviceUrl	String	"http://nominatim.openstreetmap.org/search/"	URL of the service

L.Control.Geocoder.Bing

Uses Bing Locations API to respond to geocoding queries. Implements IGeocoder.

Note that you need an API key to use this service.

Constructor

L.Control.Geocoder.Bing(<String> key)

IGeocoder

An interface implemented to respond to geocoding queries.

Methods

Method	Returns	Description
geocode( query, callback, context)	GeocodingResult[]	Performs a geocoding query and returns the results to the callback in the provided context

GeocodingResult

An object that represents a result from a geocoding query.

Properties

Property	Type	Description
name	String	Name of found location
bounds	L.LatLngBounds	The bounds of the location
center	L.LatLng	The center coordinate of the location