Feature/geolocation outside extent or boundary

packages/plugins/GeoLocation/CHANGELOG.md

@@ -3,6 +3,7 @@
 ## unpublished
 
 - Fix: Adjust documentation to properly describe optionality of configuration parameters.
+- Feature: Position is now tracked when user is outside of the view extent.
 
 ## 1.3.1
 

packages/plugins/GeoLocation/README.md

@@ -12,8 +12,8 @@ either `true` or `false`. When a users denies the location tracking, the button
 
 | fieldName | type | description |
 | - | - | - |
-| boundaryLayerId | string? | Id of a vector layer to restrict geolocation markers and zooms to. When geolocation outside of its features occurs, an information will be shown once and the feature is stopped. The map will wait at most 10s for the layer to load; should it not happen, the geolocation feature is turned off. |
-| boundaryOnError | ('strict' \| 'permissive')? | If the boundary layer check does not work due to loading or configuration errors, style `'strict'` will disable the geolocation feature, and style `'permissive'` will act as if no boundaryLayerId was set. Defaults to `'permissive'`. |
+| boundaryLayerId | string? | Id of a vector layer to restrict geolocation markers and zooms to. When geolocation outside of its features occurs, an information will be shown. When loading the boundary layer, the map will wait at most 10s; should it not happen, the geolocation feature is turned off. |
+| boundaryOnError | ('strict' \| 'permissive')? | If the boundary layer check does not work due to loading or configuration errors, style `'strict'` will disable the geolocation feature, and style `'permissive'` will act as if no boundaryLayerId was set.  Defaults to `'permissive'`. |
 | checkLocationInitially | boolean? | If `true` the location gets checked on page load. When `false` this can be triggered with a button. Defaults to `false`. |
 | keepCentered | boolean? | If `true`, the map will re-center on the user on any position change. If `false`, only the first position will be centered on. Defaults to `false`. |
 | renderType | 'iconMenu' \| 'independent'? | If nested in `IconMenu`, select 'iconMenu' to match styling. Defaults to 'independent'. |

packages/plugins/GeoLocation/src/store/actions.ts

@@ -1,5 +1,4 @@
 import { PolarActionTree } from '@polar/lib-custom-types'
-import { passesBoundaryCheck } from '@polar/lib-passes-boundary-check'
 import VectorLayer from 'ol/layer/Vector'
 import Point from 'ol/geom/Point'
 import { Vector } from 'ol/source'
@@ -11,8 +10,10 @@ import Geolocation from 'ol/Geolocation.js'
 import { transform as transformCoordinates } from 'ol/proj'
 import Overlay from 'ol/Overlay'
 import { getTooltip } from '@polar/lib-tooltip'
+import { passesBoundaryCheck } from '@polar/lib-passes-boundary-check'
 import { GeoLocationState, GeoLocationGetters } from '../types'
 import geoLocationMarker from '../assets/geoLocationMarker'
+import positionChanged from '../utils/positionChanged'
 
 const actions: PolarActionTree<GeoLocationState, GeoLocationGetters> = {
   setupModule({ getters, commit, dispatch }): void {
@@ -118,8 +119,8 @@ const actions: PolarActionTree<GeoLocationState, GeoLocationGetters> = {
   async positioning({
     rootGetters: { map, configuration },
     getters: {
-      boundaryLayerId,
       boundaryOnError,
+      boundaryLayerId,
       geolocation,
       configuredEpsg,
       position,
@@ -132,38 +133,34 @@ const actions: PolarActionTree<GeoLocationState, GeoLocationGetters> = {
       Proj.get('EPSG:4326') as Proj.Projection,
       configuredEpsg
     )
-
-    const boundaryCheckPassed =
-      typeof boundaryLayerId === 'string'
-        ? await passesBoundaryCheck(map, boundaryLayerId, transformedCoords)
-        : containsCoordinate(
-            // NOTE: The fallback is the default value set by @masterportal/masterportalApi
-            configuration?.extent || [510000.0, 5850000.0, 625000.4, 6000000.0],
-            transformedCoords
-          )
-    const boundaryErrorOccurred = typeof boundaryCheckPassed === 'symbol'
-
-    if (
-      boundaryCheckPassed === false ||
-      (boundaryErrorOccurred && boundaryOnError !== 'permissive')
-    ) {
-      dispatch('printPositioningFailed', boundaryErrorOccurred)
-      // if check initially breaks or user leaves boundary, turn off tracking
+    const coordinateInExtent = containsCoordinate(
+      // NOTE: The fallback is the default value set by @masterportal/masterportalApi
+      configuration?.extent || [510000.0, 5850000.0, 625000.4, 6000000.0],
+      transformedCoords
+    )
+    const boundaryCheckPassed = await passesBoundaryCheck(
+      map,
+      boundaryLayerId,
+      transformedCoords
+    )
+    const showBoundaryLayerError =
+      typeof boundaryCheckPassed === 'symbol' && boundaryOnError === 'strict'
+    if (!coordinateInExtent || showBoundaryLayerError) {
+      dispatch('printPositioningFailed', showBoundaryLayerError)
       dispatch('untrack')
       return
     }
-
-    if (
-      position[0] !== transformedCoords[0] ||
-      position[1] !== transformedCoords[1]
-    ) {
+    if (positionChanged(position, transformedCoords)) {
       commit('setPosition', transformedCoords)
       dispatch('addMarker', transformedCoords)
+      if (!boundaryCheckPassed) {
+        dispatch('printPositioningFailed', false)
+      }
     }
   },
   printPositioningFailed(
     { dispatch, getters: { toastAction } },
-    boundaryErrorOccurred: string
+    boundaryErrorOccurred: boolean
   ) {
     if (toastAction) {
       const toast = boundaryErrorOccurred
@@ -213,7 +210,6 @@ const actions: PolarActionTree<GeoLocationState, GeoLocationGetters> = {
         }),
       })
     )
-
     if (keepCentered || !hadPosition) {
       dispatch('zoomAndCenter')
     }

packages/plugins/GeoLocation/src/store/getters.ts

@@ -38,7 +38,11 @@ const getters: PolarGetterTree<GeoLocationState, GeoLocationGetters> = {
     return rootGetters.configuration?.geoLocation?.toastAction
   },
   zoomLevel: (_, __, ___, rootGetters): number => {
-    return rootGetters.configuration?.geoLocation?.zoomLevel || 7
+    const zoomLevel = rootGetters.configuration?.geoLocation?.zoomLevel
+    if (zoomLevel !== undefined && zoomLevel !== null) {
+      return zoomLevel
+    }
+    return 7
   },
   geoLocationMarkerLayer(_, __, ___, rootGetters) {
     return rootGetters?.map

packages/plugins/GeoLocation/src/utils/positionChanged.ts

@@ -0,0 +1,8 @@
+export default function positionChanged(
+  position: number[],
+  transformedCoords: number[]
+): boolean {
+  return (
+    position[0] !== transformedCoords[0] || position[1] !== transformedCoords[1]
+  )
+}