feat: Provider-agnostic map architecture with Google Maps support

[roncodes]

Summary

This PR introduces a provider-agnostic map architecture for FleetOps, decoupling the codebase from Leaflet-specific APIs and enabling multiple map providers to coexist. Google Maps is implemented as the first alternative provider with 1-to-1 feature parity against the existing Leaflet implementation.

The architecture is designed so that any developer can add a new map provider (Mapbox, MapLibre, HERE, etc.) by creating a single adapter service — with zero changes to business logic, components, or other services.

---

Architecture Overview

MapManagerService (provider-agnostic hub)
├── resolves adapter from config/environment or runtime settings
├── delegates all map calls to the active adapter
│
├── MapAdapterInterface (abstract base class, ~30 methods)
│   ├── map-adapter/leaflet.js  ← wraps existing Leaflet implementation
│   └── map-adapter/google.js   ← new Google Maps implementation
│
└── Components / Services call mapManager.* (never Leaflet directly)

---

New Files (14 files)

File	Description
addon/services/map-adapter-interface.js	Abstract base class defining the full adapter contract
addon/services/map-manager.js	Central provider-agnostic service replacing leaflet-map-manager
addon/services/map-adapter/leaflet.js	Leaflet adapter wrapping existing implementation
addon/services/map-adapter/google.js	Full Google Maps JS API adapter
addon/components/map/google-live-map.{js,hbs}	Google Maps surface component (mirrors leaflet-live-map)
addon/components/map-settings.{js,hbs}	Admin settings panel for map provider selection
app/services/map-manager.js	Re-export
app/services/map-adapter-interface.js	Re-export
app/services/map-adapter/leaflet.js	Re-export
app/services/map-adapter/google.js	Re-export
app/components/map-settings.js	Re-export
app/components/map/google-live-map.js	Re-export

Modified Files (10 files)

File	Change
addon/components/map/leaflet-live-map.{js,hbs}	Injects mapManager; template conditionally renders Google or Leaflet branch
addon/services/movement-tracker.js	Uses mapManager.updateMarkerPosition() / setMarkerRotation()
addon/services/position-playback.js	Uses mapManager.updateMarkerPosition() / setMarkerRotation()
addon/services/geofence.js	Uses mapManager.showDrawControl() / editPolygon()
config/environment.js	Adds mapProvider, googleMapsApiKey, googleMapsLibraries
index.js	Adds contentFor('head') to inject Google Maps script tag
server/src/Http/Controllers/Internal/v1/SettingController.php	Adds getMapSettings() and saveMapSettings()
server/src/routes.php	Registers GET/POST fleet-ops/settings/map
translations/en-us.yaml	Adds map-settings.* translation keys

---

Google Maps Feature Parity

Feature	Leaflet	Google Maps
Live driver/vehicle markers	✅ L.Marker	✅ google.maps.Marker
Smooth marker animation	✅ slideTo()	✅ rAF interpolation loop
Marker rotation (heading)	✅ leaflet-marker-rotate	✅ CSS transform on icon
Service area polygons	✅ L.Polygon	✅ google.maps.Polygon
Zone polygons	✅ L.Polygon	✅ google.maps.Polygon
Route polylines	✅ L.Polyline	✅ google.maps.Polyline
Geofence drawing	✅ leaflet-draw	✅ DrawingManager
Geofence editing	✅ leaflet-draw edit	✅ Polygon setEditable()
Context menus	✅ leaflet-contextmenu	✅ InfoWindow-based menus
Position playback	✅ marker.slideTo()	✅ rAF interpolation
Fit bounds	✅ map.fitBounds()	✅ map.fitBounds()
Fly to / pan to	✅ map.flyTo()	✅ map.panTo()
GeoJSON overlay	✅ L.geoJSON()	✅ map.data.addGeoJson()
Traffic layer	❌ (tile-based)	✅ TrafficLayer
Transit layer	❌ (tile-based)	✅ TransitLayer
Map type switching	❌ tile swap	✅ setMapTypeId()

---

How to Enable Google Maps

Via environment variables (build-time):

MAP_PROVIDER=google
GOOGLE_MAPS_API_KEY=AIza...

Via admin settings panel (runtime, no rebuild):
Settings → Map Settings → Select "Google Maps" → Enter API key → Save

Required Google Cloud APIs:

• Maps JavaScript API
• Drawing Library
• Geometry Library
• Geocoding API

---

Adding a New Map Provider (for developers)

1. Create addon/services/map-adapter/<name>.js extending MapAdapterInterface
2. Create app/services/map-adapter/<name>.js re-export
3. Set mapProvider: '<name>' in config/environment.js
4. No changes to any component or service are required

---

Backward Compatibility

• Default provider remains leaflet — zero behaviour change for existing deployments
• All existing Leaflet services (leaflet-map-manager, leaflet-routing-control, etc.) are preserved unchanged
• The leaflet-live-map component continues to work exactly as before when Leaflet is the active provider
• The MapManagerService falls back to Leaflet if an unknown provider is configured

---

Testing Checklist

• Leaflet provider: all existing map features work unchanged
• Google Maps provider: markers render and animate correctly
• Google Maps provider: geofence drawing and editing works
• Google Maps provider: service area polygons render correctly
• Google Maps provider: context menus appear on right-click
• Google Maps provider: position playback animates markers
• Settings panel: provider toggle persists across page reloads
• Settings panel: Google Maps API key is stored securely (not in GET response)
• Runtime provider switch triggers map re-render