MapplsMap class

Shows a MapLibre map. Also refer to the documentation of mappls_gl and MapplsMapController.

Inheritance

Constructors

MapplsMap({Key? key, required CameraPosition initialCameraPosition, MapCreatedCallback? onMapCreated, OnMapErrorCallback? onMapError, OnStyleLoadedCallback? onStyleLoadedCallback, String? mapplsStyle, Set<Factory<OneSequenceGestureRecognizer>>? gestureRecognizers, bool compassEnabled = true, CameraTargetBounds cameraTargetBounds = CameraTargetBounds.unbounded, MinMaxZoomPreference minMaxZoomPreference = MinMaxZoomPreference.unbounded, bool rotateGesturesEnabled = true, bool scrollGesturesEnabled = true, bool zoomGesturesEnabled = true, bool tiltGesturesEnabled = true, bool? doubleClickZoomEnabled, bool dragEnabled = true, bool trackCameraPosition = false, bool myLocationEnabled = false, MyLocationTrackingMode myLocationTrackingMode = MyLocationTrackingMode.none, MyLocationRenderMode myLocationRenderMode = MyLocationRenderMode.normal, Point<num>? logoViewMargins, CompassViewPosition? compassViewPosition, Point<num>? compassViewMargins, AttributionButtonPosition? attributionButtonPosition, Point<num>? attributionButtonMargins, Duration? iosLongClickDuration, OnMapClickCallback? onMapClick, OnUserLocationUpdated? onUserLocationUpdated, OnMapClickCallback? onMapLongClick, OnAttributionClickCallback? onAttributionClick, OnCameraTrackingDismissedCallback? onCameraTrackingDismissed, OnCameraTrackingChangedCallback? onCameraTrackingChanged, OnCameraIdleCallback? onCameraIdle, OnMapIdleCallback? onMapIdle, List<AnnotationType> annotationOrder = const [AnnotationType.line, AnnotationType.symbol, AnnotationType.circle, AnnotationType.fill], List<AnnotationType> annotationConsumeTapEvents = const [AnnotationType.symbol, AnnotationType.fill, AnnotationType.line, AnnotationType.circle], OnGeoAnalyticsSelected? onGeoAnalyticsSelected, bool? enableLogoClick, MinMaxPitchPreference minMaxPitchPreference = MinMaxPitchPreference.unbounded, LogoViewPosition? logoViewPosition, bool? layerControlEnabled, bool? showGeoAnalyticsInfoWindow})
const

Properties

annotationConsumeTapEvents List<AnnotationType>
Defines the layer order of click annotations
final
annotationOrder List<AnnotationType>
Defines the layer order of annotations displayed on map
final
attributionButtonMargins Point<num>?
Set the layout margins for the MapLibre Attribution Buttons. If you set this value, you may also want to set attributionButtonPosition to harmonize the layout between iOS and Android, since the underlying frameworks have different defaults.
final
attributionButtonPosition AttributionButtonPosition?
Set the position for the MapLibre Attribution Button When set to null, the default value of the underlying MapLibre libraries is used, which differs depending on the operating system the app is being run on.
final
cameraTargetBounds CameraTargetBounds
Geographical bounding box for the camera target.
final
compassEnabled bool
True if the map should show a compass when rotated.
final
compassViewMargins Point<num>?
Set the layout margins for the Compass
final
compassViewPosition CompassViewPosition?
Set the position for the Compass
final
doubleClickZoomEnabled bool?
Set to true to forcefully disable/enable if map should respond to double click to zoom.
final
dragEnabled bool
True if drag functionality should be enabled.
final
enableLogoClick bool?
final
gestureRecognizers Set<Factory<OneSequenceGestureRecognizer>>?
Which gestures should be consumed by the map.
final
hashCode int
The hash code for this object.
no setterinherited
initialCameraPosition CameraPosition
The initial position of the map's camera.
final
iosLongClickDuration Duration?
How long a user has to click the map on iOS until a long click is registered. Has no effect on web or Android. Can not be changed at runtime, only the initial value is used. If null, the default value of the native MapLibre library / of the OS is used.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
layerControlEnabled bool?
final
logoViewMargins Point<num>?
Set the layout margins for the Logo
final
logoViewPosition LogoViewPosition?
final
mapplsStyle String?
A MapLibre GL style document defining the map's appearance. The style document specification is at https://maplibre.org/maplibre-style-spec. A short introduction can be found in the documentation of the maplibre_gl library. The following formats are supported:
final
minMaxPitchPreference MinMaxPitchPreference
final
minMaxZoomPreference MinMaxZoomPreference
Preferred bounds for the camera zoom level.
final
myLocationEnabled bool
True if a "My Location" layer should be shown on the map.
final
myLocationRenderMode MyLocationRenderMode
Specifies if and how the user's heading/bearing is rendered in the user location indicator. See the documentation of MyLocationRenderMode for details. If this is set to a value other than MyLocationRenderMode.normal, myLocationEnabled needs to be true.
final
myLocationTrackingMode MyLocationTrackingMode
The mode used to let the map's camera follow the device's physical location. myLocationEnabled needs to be true for values other than MyLocationTrackingMode.None to work.
final
onAttributionClick OnAttributionClickCallback?
final
onCameraIdle OnCameraIdleCallback?
final
onCameraTrackingChanged OnCameraTrackingChangedCallback?
Called when the location tracking mode changes
final
onCameraTrackingDismissed OnCameraTrackingDismissedCallback?
Called when the map's camera no longer follows the physical device location, e.g. because the user moved the map
final
onGeoAnalyticsSelected OnGeoAnalyticsSelected?
final
onMapClick OnMapClickCallback?
final
onMapCreated MapCreatedCallback?
Please note: you should only add annotations (e.g. symbols or circles) after onStyleLoadedCallback has been called.
final
onMapError OnMapErrorCallback?
final
onMapIdle OnMapIdleCallback?
Called when map view is entering an idle state, and no more drawing will be necessary until new data is loaded or there is some interaction with the map.
final
onMapLongClick OnMapClickCallback?
final
onStyleLoadedCallback OnStyleLoadedCallback?
Called when the map style has been successfully loaded and the annotation managers have been enabled. Please note: you should only add annotations (e.g. symbols or circles) after this callback has been called.
final
onUserLocationUpdated OnUserLocationUpdated?
While the myLocationEnabled property is set to true, this method is called whenever a new location update is received by the map view.
final
rotateGesturesEnabled bool
True if the map view should respond to rotate gestures.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
scrollGesturesEnabled bool
True if the map view should respond to scroll gestures.
final
showGeoAnalyticsInfoWindow bool?
final
tiltGesturesEnabled bool
True if the map view should respond to tilt gestures.
final
trackCameraPosition bool
True if you want to be notified of map camera movements by the MapplsMapController. Default is false.
final
zoomGesturesEnabled bool
True if the map view should respond to zoom gestures.
final

Methods

createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() State<StatefulWidget>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
inherited
toStringShort() String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Properties

useHybridComposition bool
Set MapLibreMap.useHybridComposition to false in order use Virtual-Display (better for Android 9 and below but may result in errors on Android 12) or leave it true (default) to use Hybrid composition (Slower on Android 9 and below).
getter/setter pair