Class MapLibre

This class will help you add or use search bar for geocoding with a MapLibre GL JS map.

const jawgPlaces = new JawgPlaces.MapLibre({
  accessToken: 'Access-Token',
})
map.addControl(jawgPlaces)

Hierarchy (View Summary)

Constructors

constructor

Methods

attachMap close destroy getDefaultPosition getValue search setValue showError showResults submit

Constructors

constructor

Methods

attachMap

  • attachMap(map: Map | Map$1): this

  • When Jawg Places is not used as a control within your map, you will need to call this function.

    Parameters

    Returns this

    itself

close

  • close(): void

  • Close the result list.

    Returns void

destroy

  • destroy(): void

  • Destroy all created DOM elements and listeners. This could be useful when you recreate a JawgPlace instance for the same input.

    Returns void

getDefaultPosition

  • getDefaultPosition(): "top-left"

  • The default position of the control in the map.

    Returns "top-left"

getValue

  • getValue(): string

  • Returns string

    The value of the <input>.

search

  • search(text: string): Promise<FeatureCollection>

  • Search a random text, lat/lon or GID using Jawg Places.

    All features are points with properties, more details on our documentation.

    See JawgPlacesOptions.reverse for lat/lon search and JawgPlacesOptions.place for GID search.

    Parameters

    • text: string

      The text to search using Jawg Places

    Returns Promise<FeatureCollection>

    A promise with the feature collection received from Jawg Places

setValue

  • setValue(value: string): void

  • Parameters

    • value: string

      The new value for the <input>.

    Returns void

showError

  • showError(error: any): void

  • Open the result list with the error message. This will trigger JawgPlacesOptions.onError.

    Parameters

    • error: any

      The error to show, can be a string or an object.

    Returns void

showResults

  • showResults(results: FeatureCollection): void

  • Open the result list with elements from the FeatureCollection. We use the properties.label field of each features. This will trigger JawgPlacesOptions.onFeatures callback. Use it if you want to display specific results or add new elements.

    Parameters

    Returns void

submit

  • submit(): void

  • Submit the search using the value of the <input>. This will trigger JawgPlacesOptions.onFeatures.

    Returns void

Settings

Member Visibility

On This Page

Constructors
Methods