duebbert / mapbox-gl-geocoder

Geocoder control for mapbox-gl-js using Mapbox Geocoding API

Home Page:https://mapbox.com/mapbox-gl-js/example/mapbox-gl-geocoder/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Mapbox GL Geocoder Build Status

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.

Usage

https://www.mapbox.com/mapbox-gl-js/example/mapbox-gl-geocoder/

If you are supporting older browsers, you will need a Promise polyfill. es6-promise is a good one, if you're uncertain.

Usage with a module bundler

npm install --save @mapbox/mapbox-gl-geocoder
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
});

Using without a Map

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.

Deeper dive

API Documentation

See API.md for complete reference.

Examples

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

Contributing

See CONTRIBUTING.md.

About

Geocoder control for mapbox-gl-js using Mapbox Geocoding API

https://mapbox.com/mapbox-gl-js/example/mapbox-gl-geocoder/

License:ISC License


Languages

Language:JavaScript 96.4%Language:CSS 3.6%