Skip to content

mosh11/L.GeoSearch

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

#Leaflet.GeoSearch Adds support for geocoding (address lookup, a.k.a. geoseaching) to Leaflet.

Check out the demo

#About the control The control uses so-called "providers" to take care of building the correct service URL and parsing the retrieved data into a uniform format. Thanks to this architecture, it is pretty easy to write your own providers, so you can use your own geocoding service(s).

The control comes with a default set of three providers:

  • L.GeoSearch.Provider.Esri
  • L.GeoSearch.Provider.Google
  • L.GeoSearch.Provider.OpenStreetMap

Using these is pretty simple.

#Using the control

For example, to use the Esri provider:

new L.Control.GeoSearch({
    provider: new L.GeoSearch.Provider.Esri()
}).addTo(map);

Or if you prefer using Google

new L.Control.GeoSearch({
    provider: new L.GeoSearch.Provider.Google()
}).addTo(map);

Or, for open-source lovers who like OpenStreetMap:

new L.Control.GeoSearch({
    provider: new L.GeoSearch.Provider.OpenStreetMap()
}).addTo(map);

I really can't make it any harder. Checkout the providers to see how easy it is to write your own. There are other configurable options like setting the position of the search input and whether or not a marker should be displayed at the position of the search result.

new L.Control.GeoSearch({
    provider: new L.GeoSearch.Provider.OpenStreetMap(),
    position: 'topcenter',
    showMarker: true,
    retainZoomLevel: false,
}).addTo(map);

If you want to have your custom GeoSearch control you can directly use one of the providers.

var googleGeocodeProvider = new L.GeoSearch.Provider.Google(),
  addressText = 'Amsterdam';

googleGeocodeProvider.GetLocations( addressText, function ( data ) {
  // in data are your results with x, y, label and bounds (currently availabel for google maps provider only)
});

I really can't make it any easier. Check out the providers to see how easy it is to write your own.

About

Leaflet geosearching/geocoding control

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 70.2%
  • HTML 25.9%
  • CSS 3.9%