/ngx-leaflet-starter

A soup of Angular and Leaflet

Primary LanguageTypeScriptMIT LicenseMIT

ngx-leaflet-starter

Build Status

A web mapping application starter based on Angular X and Leaflet. This project demo includes basic mapping features:

  • Display base maps from different sources

  • Initialize map based on user's IP address location

  • Geocode address and zoom to result location

  • Add/remove markers on the map

  • Use unofficially typed Leaflet plugin

  • Built with Angular CLI

Support Angular 7 and Leaflet 1.3 now!

See how it looks at demo page.

FAQ

Was it named angular2-leaflet-starter?

Yes, but no longer. Angular is evolving rapidly and has moved further from 2.0. This project is renamed to ngx-leaflet-starter, meaning that it will evolve with Angular and stay close to the latest version.

How about new features?

Since this project has been reached its initial goal to provide a small and clean code base for Angular and Leaflet integration, currently there is no plan for new feature development. But I am open to suggestions and PRs. If you think it's beneficial to add something new (not for very specific use cases), please feel free to submit an issue for dicussion.

Oops, this plugin is not typed!?

Most Leaflet plugins are not typed, but it doesn't mean they are not usable. To use them in a TypeScript project, one way is to provide a minimal type declaration file.

In the starter, a minimal type declaration file is created for the Leaflet.VectorGrid. This plugin is used to add the global airport sites (from openflights.org) as a vector tile layer.

How to start?

This project requires npm (or yarn).

  1. Run npm install to install dependencies.

  2. Run npm run start to set up the dev server.

  3. See the app at localhost:4200.

Thanks to these awesome people!

Looking for other demos?