generic_map

Shared map models and behavior with a Google Maps renderer for Flutter. Supports Android, iOS and web. Native desktop rendering is not supported.

The abstraction provides camera movement and bounds fitting, Flutter widget markers rendered as cached bitmaps, polylines, circles, heatmaps, editable polygons, place picking, and debounced reverse geocoding. It uses the gm_google_maps_flutter fork for editable shapes.

Install

dependencies:
  generic_map: ^0.17.0
  latlong2: ^0.9.1

Configure your Google Maps API keys in the Android/iOS runner and load the Google Maps JavaScript API on web, as described in the Google Maps setup guide.

import 'package:generic_map/generic_map.dart';
import 'package:latlong2/latlong.dart';

GenericMap(
  interactive: true,
  initialLocation: const Place(
    LatLng(37.7858, -122.4064), 'San Francisco, CA', 'San Francisco',
  ),
  googleMapOptions: const GoogleMapsOptions(
    preset: GoogleMapStylePreset.dark,
  ),
  onControllerReady: (controller) {
    controller.fitBounds(points);
  },
)

Shared API

MapViewController: fitBounds, moveCamera, setCamera, getCenter, getViewportBounds, and dispose.
MapViewCamera: center, zoom, bearing and tilt; setCamera optionally takes an animation duration.
MapMovedEvent: position, bounds, zoom, bearing, movement stage and movement source. Use isUserGesture to distinguish dragging from programmatic moves.
CustomMarker: widget, position, alignment, rotation, flat/upright orientation, and tap callback. Supply a stable cacheKey to reuse unchanged bitmaps.
PolyLineLayer, CircleMarker, HeatmapConfig, Place, AddressResolver.
LatLngBounds: owned by generic_map rather than a rendering dependency. Use fromSouthWestNorthEast when reading a viewport crossing the antimeridian.

A place picker uses MapViewMode.picker, interactive: true, a centerMarkerBuilder and an addressResolver. Enable enableAddressResolve to receive resolved addresses. Camera idle and address callbacks are debounced; new movement cancels pending work.

For editable polygons, set isPolylineDrawEnabled: true, pass initialDrawingPoints, and handle onPolylineDrawn. Updating the points also updates the polygon, so a host can implement undo/redo. Existing editable polylines use onPolylineEdited.

Google styles include standard, silver, retro, dark, night and aubergine. A customStyleJson overrides the preset. GoogleMapsOptions.buildingsEnabled controls 3D buildings; dark presets disable them by default.

Migrating from 0.16

Version 0.17 removes the Mapbox, flutter_map and disabled MapLibre renderers. Their SDKs, tile caching and editor packages are no longer dependencies.

Remove mapboxOptions, mapboxSdkOptions, mapLibreOptions, openStreetMapOptions and useCachedTiles arguments.
Replace polyEditor: PolyEditor(points: points, ...) with initialDrawingPoints: points and use the drawing/edit callbacks.
LatLngBounds now comes from generic_map. Code using its constructors, corners, cardinal edges, center and contains keeps the same spelling. Other flutter_map-specific APIs must be migrated explicitly.
Remove direct flutter_map/tile-cache dependencies and cache initialization from your application too, otherwise they remain installed.
Use MapProviderEnum.supportedValues in provider pickers. Legacy enum identifiers and PlatformMapProviderSettings remain readable for stored settings, but all selections resolve to Google Maps. Applications should normalize persisted selections to googleMaps when restoring settings.
Native desktop no longer has a fallback renderer. GenericMap renders an empty widget there and does not call onControllerReady; hide map-dependent controls on those platforms or use the web app.

A future provider should ship as a separately installed adapter so applications only include the SDKs they use.

Development

flutter pub get
flutter analyze lib test example/lib
flutter test

The small example in example/lib/main.dart uses Google Maps. Configure its platform keys before running it. Native map behavior must also be checked on a simulator/device or browser; unit tests cover shared camera, bounds, marker caching, padding and movement-source behavior.

generic_map

Install

Shared API

Migrating from 0.16

Development

Libraries

generic_map package