@mapbox/mapbox-gl-geocoder

Mapbox GL Geocoder 
---

A geocoder control for mapbox-gl-js using the Mapbox Geocoding API. For a JavaScript geocoder without a graphical user interface see the Mapbox SDK for JS.

$3

* https://docs.mapbox.com/mapbox-gl-js/example/mapbox-gl-geocoder/
* https://docs.mapbox.com/mapbox-gl-js/example/?search=mapbox-gl-geocoder

If you are supporting older browsers, you will need to use a polyfill. We recommend working with @babel/polyfill.

$3

``bash
npm install --save @mapbox/mapbox-gl-geocoder
`

`js
import MapboxGeocoder from '@mapbox/mapbox-gl-geocoder';
import '@mapbox/mapbox-gl-geocoder/dist/mapbox-gl-geocoder.css';
...
const geocoder = new MapboxGeocoder({
accessToken: mapboxgl.accessToken,
mapboxgl: mapboxgl
});

`

$3


It is possible to use the plugin without it being placed as a control on a mapbox-gl map. Keep in mind that the Mapbox Terms of Service require that POI search results be shown on a Mapbox map. If you don't need POIs, you can exclude them from your search results with the options.types` parameter when constructing a new Geocoder.

$3

#### API Documentation

See API.md for complete reference.

#### Examples

See https://docs.mapbox.com/mapbox-gl-js/examples/#geocoder.

$3

See CONTRIBUTING.md.