@maplibre/maplibre-gl-geocoder

MapLibre GL Geocoder

A geocoder control for maplibre-gl-js.

Usage

A full working example can be found here, which uses Nominatim: https://maplibre.org/maplibre-gl-js/docs/examples/geocoder/

Usage with a module bundler

npm install --save @maplibre/maplibre-gl-geocoder

import MaplibreGeocoder from '@maplibre/maplibre-gl-geocoder';
import '@maplibre/maplibre-gl-geocoder/dist/maplibre-gl-geocoder.css';
...
// Functions should return Carmen GeoJSON, see the relevant type in this project
// View config definitions in our [documentation](https://www.maplibre.org/maplibre-gl-geocoder/)
var Geo = {
  // required
  forwardGeocode: async (config) => { /* definition here */ },
  
  // optional
  reverseGeocode: async (config) => { /* definition here */ }, // reverse geocoding API
  getSuggestions: async (config) => { /* definition here */ }, // suggestion API
  searchByPlaceId: async (config) => { /* definition here */ } // search by Place ID API
};

// Pass in or define a geocoding API that matches the above
const geocoder = new MaplibreGeocoder(Geo, { maplibregl: maplibregl });
map.addControl(geocoder);

Using without a Map

It is possible to use the plugin without it being placed as a control on a maplibre-gl map.

Deeper dive

API Documentation

See here for complete reference.

Also check out the example in MapLibre docs: https://maplibre.org/maplibre-gl-js/docs/examples/geocoder/

Contributing

See CONTRIBUTING.md.

Licence

ISC © MapLibre © Mapbox

Changelog

1.7.1

Features / Improvements 🚀

• Add option to set proximity min zoom by @HarelM in https://github.com/maplibre/maplibre-gl-geocoder/pull/130
• Add once event registration capability by @HarelM in https://github.com/maplibre/maplibre-gl-geocoder/pull/127

Bug fixes 🐛

• fix(build): remove type: module from package.json to fix cjs dist by @thaddmt in https://github.com/maplibre/maplibre-gl-geocoder/pull/140