Planning issue

[jywarren]

@sagarpreet-chadha ! 👍 😄

Planning issue :

A utility library​ for filtering locations to a specific precision level for use in Leaflet Blurred Location (LBL)

• [x] as a self-contained, tested node module that is included into LBL
• [x] determine input types and output formats and develop examples to be used in both tests and documentation
• [ ] integrate the module into LBLD, and also in other apps
• [x] the module would just do conversions - no UI or geocoding
• [Part of LBL] use the module to implement (and document) an option in LBL to limit map input to a precision range, with { max: 14, min: 4 } (i.e. the map would not zoom outside that range nor would coordinates generated fall outside that range of precisions)
• [x] can we have a pair of converters like BL.distanceToPrecision(meters, latitude) and BL.precisionToDistance(decimals, latitude)? If no latitude is specified, we could output a message explaining how precision changes with latitude, and mentioning the latitudes of two cities with very different values?

[sagarpreet-chadha]

Hi @jywarren 😄 ! What will this module do ? Kindly give more details 📝 .

[jywarren]

I think it would absorb some functions like:

https://github.com/publiclab/leaflet-blurred-location/blob/4f452d5cc486ac320fa168eeabbb46bedb1b8378/src/blurredLocation.js#L124-L134

https://github.com/publiclab/leaflet-blurred-location/blob/4f452d5cc486ac320fa168eeabbb46bedb1b8378/src/blurredLocation.js#L204-L207

What other very abstract utilities might be useful for people doing JavaScript work using blurred locations, that isn't specific to an interface or Leaflet? Maybe the conversions between precision and human-readable terms?

This library can be really simple. Let's also brainstorm any functions that'd be common between LBL and LBLD, that are also not Leaflet.

[jywarren]

I also just added this!

BL.distanceToPrecision() and BL.precisionToDistance()

[jywarren]

This is starting to be a great run through of what each function does; we could expand it a bit with more scenarios and situations, maybe?

https://github.com/publiclab/blurred-location/blob/main/spec/javascripts/test_spec.js

[jywarren]

Could this set of conversions be moved into this library? https://github.com/publiclab/leaflet-blurred-location/issues/98

[jywarren]

How hard would it be to integrate a function like this? https://github.com/publiclab/leaflet-blurred-location/issues/170

[jywarren]

I think perhaps we should copy this section of the docs from LBL to here -- we can leave it there too but this is the underlying library that brings this to life: https://github.com/publiclab/leaflet-blurred-location#human-readable-blurring