esri-leaflet-geocoder
esri-leaflet-geocoder copied to clipboard
Update documentation to include examples of ES6-style imports (`import * as .... from 'esri-leaflet-geocoder'`)
I installed this project via npm as well as it's types for my Gatsby (react) project, but I am unable to use it thru the leaflet package as the documentation suggests.
I ran npm i esri-leaflet-geocoder --save and npm i @types/esri-leaflet-geocoder --save which installed properly, but when I go to use the geocode like the documentation suggests:
L.esri.Geocoder.reverseGeocode(...
I get a runtime error that Geocoder is undefined.
I can get around this by importing the package directly:
import * as ELG from 'esri-leaflet-geocoder'
ELG.reverseGeocode(....
However, when I do it this way. I run into issues with the api key that I've opened another issue about
Hi, I think that import style is correct when using ES6 import style.
Import style works, but the way the documentation shows to use it does not.
Hi, thanks for the feedback. Which documentation are you referring to?
Under the API Reference section of this repo's README, it shows to use L.esri.Geocoding. indicating it extends the L import of Leaflet, but it does not. You have to import it and use it separately
Thanks...
- if you import using the script tag (for example,
<script src="https://unpkg.com/esri-leaflet-geocoder"></script>), then you access viaL.esri.Geocoding.... - if you import using the newer
import * as .... from 'esri-leaflet-geocoder'then you'd refer to it directly using the imported name.
Either are valid, but the documentation focuses on number 1 since that is the pattern that most Leaflet users are following. I think your confusion is that number 2 is not really mentioned in the documentation, and that's a fair critique, as more people start to use the import... style. I'll rename this issue so that we can tackle that documentation update. PRs welcome!