Package com.arubanetworks.meridian.maps

Class MapView

java.lang.Object

android.view.View

android.view.ViewGroup

android.widget.FrameLayout

com.arubanetworks.meridian.maps.MapView

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.view.accessibility.AccessibilityEventSource, android.view.KeyEvent.Callback, android.view.ViewManager, android.view.ViewParent, MeridianLocationManager.LocationUpdateListener, Directions.DirectionsRequestListener

public class MapView
extends android.widget.FrameLayout
implements Directions.DirectionsRequestListener, MeridianLocationManager.LocationUpdateListener

Provides an interactive Meridian map surface with map and direction controls.

MapView generally should not be used directly and MapFragment should be used in its stead.

MapView uses OpenGL and is dependent on receiving an Activity's onPause, onResume and onDestroy in order to properly manage its context and state. An Activity that intends to use MapView should create an instance of it in onCreate and call that instances onPause, onResume and onDestroy methods during its own onPause, onResume and onDestroy methods.

For example:

```java public void onCreate(Bundle savedInstanceState) { mapView = new MapView(this) mapView.setAppKey(appKey); mapView.setMapKey(mapKey); setContentView(mapView); }

public void onResume() { super.onResume(); mapView.onResume(); }

public void onPause() { mapView.onPause(); super.onPause(); }

public void onDestroy() { mapView.onDestroy(); super.onDestroy(); }

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	MapView.DirectionsEventListener	A listener for receiving directions events from the MapView
static interface	MapView.MapClickEventListener	A listener for receiving map click events from the MapView
static interface	MapView.MapEventListener	A listener for receiving map events from the MapView
static interface	MapView.MarkerEventListener	A listener for receiving Marker events from the MapView
class	MapView.OpenGLNotSupportedException

Nested classes/interfaces inherited from class android.widget.FrameLayout

android.widget.FrameLayout.LayoutParams

Nested classes/interfaces inherited from class android.view.ViewGroup

android.view.ViewGroup.MarginLayoutParams, android.view.ViewGroup.OnHierarchyChangeListener

Nested classes/interfaces inherited from class android.view.View

android.view.View.AccessibilityDelegate, android.view.View.BaseSavedState, android.view.View.DragShadowBuilder, android.view.View.MeasureSpec, android.view.View.OnApplyWindowInsetsListener, android.view.View.OnAttachStateChangeListener, android.view.View.OnCapturedPointerListener, android.view.View.OnClickListener, android.view.View.OnContextClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnDragListener, android.view.View.OnFocusChangeListener, android.view.View.OnGenericMotionListener, android.view.View.OnHoverListener, android.view.View.OnKeyListener, android.view.View.OnLayoutChangeListener, android.view.View.OnLongClickListener, android.view.View.OnScrollChangeListener, android.view.View.OnSystemUiVisibilityChangeListener, android.view.View.OnTouchListener, android.view.View.OnUnhandledKeyEventListener

Field Summary

Fields

Modifier and Type	Field	Description
static final int	REQUIRED_OPENGL_LEVEL

Fields inherited from class android.view.ViewGroup

CLIP_TO_PADDING_MASK, FOCUS_AFTER_DESCENDANTS, FOCUS_BEFORE_DESCENDANTS, FOCUS_BLOCK_DESCENDANTS, LAYOUT_MODE_CLIP_BOUNDS, LAYOUT_MODE_OPTICAL_BOUNDS, PERSISTENT_ALL_CACHES, PERSISTENT_ANIMATION_CACHE, PERSISTENT_NO_CACHE, PERSISTENT_SCROLLING_CACHE

Fields inherited from class android.view.View

ACCESSIBILITY_DATA_SENSITIVE_AUTO, ACCESSIBILITY_DATA_SENSITIVE_NO, ACCESSIBILITY_DATA_SENSITIVE_YES, ACCESSIBILITY_LIVE_REGION_ASSERTIVE, ACCESSIBILITY_LIVE_REGION_NONE, ACCESSIBILITY_LIVE_REGION_POLITE, ALPHA, AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS, AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE, AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY, AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH, AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR, AUTOFILL_HINT_CREDIT_CARD_NUMBER, AUTOFILL_HINT_CREDIT_CARD_SECURITY_CODE, AUTOFILL_HINT_EMAIL_ADDRESS, AUTOFILL_HINT_NAME, AUTOFILL_HINT_PASSWORD, AUTOFILL_HINT_PHONE, AUTOFILL_HINT_POSTAL_ADDRESS, AUTOFILL_HINT_POSTAL_CODE, AUTOFILL_HINT_USERNAME, AUTOFILL_TYPE_DATE, AUTOFILL_TYPE_LIST, AUTOFILL_TYPE_NONE, AUTOFILL_TYPE_TEXT, AUTOFILL_TYPE_TOGGLE, CONTENT_SENSITIVITY_AUTO, CONTENT_SENSITIVITY_NOT_SENSITIVE, CONTENT_SENSITIVITY_SENSITIVE, DRAG_FLAG_ACCESSIBILITY_ACTION, DRAG_FLAG_GLOBAL, DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION, DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION, DRAG_FLAG_GLOBAL_SAME_APPLICATION, DRAG_FLAG_GLOBAL_URI_READ, DRAG_FLAG_GLOBAL_URI_WRITE, DRAG_FLAG_HIDE_CALLING_TASK_ON_DRAG_START, DRAG_FLAG_OPAQUE, DRAG_FLAG_START_INTENT_SENDER_ON_UNHANDLED_DRAG, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, EMPTY_STATE_SET, ENABLED_FOCUSED_SELECTED_STATE_SET, ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_FOCUSED_STATE_SET, ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, ENABLED_SELECTED_STATE_SET, ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_STATE_SET, ENABLED_WINDOW_FOCUSED_STATE_SET, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLE, FOCUSABLE_AUTO, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, FOCUSED_SELECTED_STATE_SET, FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, FOCUSED_STATE_SET, FOCUSED_WINDOW_FOCUSED_STATE_SET, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS, IMPORTANT_FOR_ACCESSIBILITY_YES, IMPORTANT_FOR_AUTOFILL_AUTO, IMPORTANT_FOR_AUTOFILL_NO, IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS, IMPORTANT_FOR_AUTOFILL_YES, IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS, IMPORTANT_FOR_CONTENT_CAPTURE_AUTO, IMPORTANT_FOR_CONTENT_CAPTURE_NO, IMPORTANT_FOR_CONTENT_CAPTURE_NO_EXCLUDE_DESCENDANTS, IMPORTANT_FOR_CONTENT_CAPTURE_YES, IMPORTANT_FOR_CONTENT_CAPTURE_YES_EXCLUDE_DESCENDANTS, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, LAYOUT_DIRECTION_INHERIT, LAYOUT_DIRECTION_LOCALE, LAYOUT_DIRECTION_LTR, LAYOUT_DIRECTION_RTL, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, NOT_FOCUSABLE, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET, PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_SELECTED_STATE_SET, PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_STATE_SET, PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_SELECTED_STATE_SET, PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_STATE_SET, PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_SELECTED_STATE_SET, PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_STATE_SET, PRESSED_WINDOW_FOCUSED_STATE_SET, REQUESTED_FRAME_RATE_CATEGORY_DEFAULT, REQUESTED_FRAME_RATE_CATEGORY_HIGH, REQUESTED_FRAME_RATE_CATEGORY_LOW, REQUESTED_FRAME_RATE_CATEGORY_NO_PREFERENCE, REQUESTED_FRAME_RATE_CATEGORY_NORMAL, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLL_AXIS_HORIZONTAL, SCROLL_AXIS_NONE, SCROLL_AXIS_VERTICAL, SCROLL_CAPTURE_HINT_AUTO, SCROLL_CAPTURE_HINT_EXCLUDE, SCROLL_CAPTURE_HINT_EXCLUDE_DESCENDANTS, SCROLL_CAPTURE_HINT_INCLUDE, SCROLL_INDICATOR_BOTTOM, SCROLL_INDICATOR_END, SCROLL_INDICATOR_LEFT, SCROLL_INDICATOR_RIGHT, SCROLL_INDICATOR_START, SCROLL_INDICATOR_TOP, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SELECTED_STATE_SET, SELECTED_WINDOW_FOCUSED_STATE_SET, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_IMMERSIVE, SYSTEM_UI_FLAG_IMMERSIVE_STICKY, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR, SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_CENTER, TEXT_ALIGNMENT_GRAVITY, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_TEXT_END, TEXT_ALIGNMENT_TEXT_START, TEXT_ALIGNMENT_VIEW_END, TEXT_ALIGNMENT_VIEW_START, TEXT_DIRECTION_ANY_RTL, TEXT_DIRECTION_FIRST_STRONG, TEXT_DIRECTION_FIRST_STRONG_LTR, TEXT_DIRECTION_FIRST_STRONG_RTL, TEXT_DIRECTION_INHERIT, TEXT_DIRECTION_LOCALE, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, VIEW_LOG_TAG, VISIBLE, WINDOW_FOCUSED_STATE_SET, X, Y, Z

Constructor Summary

Constructors

Constructor	Description
MapView(android.content.Context context)	Construct a MapView with the given Context.
MapView(android.content.Context context, android.util.AttributeSet attrs)	Construct a MapView with the given Context and attributes.
MapView(android.content.Context context, android.util.AttributeSet attrs, int defStyle)	Construct a MapView with the given Context and attributes and style.

Method Summary

Modifier and Type	Method	Description
void	commitTransaction(Transaction transaction)	Commits a Transaction to be applied to the MapView.
void	endDirections()	Ends the current directions route for this MapView.
void	expandPicker()	Expands the map picker, deselecting the currently selected Marker.
List<Marker>	getAllMarkers()	Get a copy of the current list of Markers for this map.
EditorKey	getAppKey()	Get the current app key
Placemark	getAssociatedPlacemark(Marker marker)	Return any associated Placemark for Markers generated through calls to markerForPlacemark.
android.graphics.Matrix	getCurrentScreenToMapTransform()	Gets the current transformation matrix (3x3) between the screen and the map.
DirectionsOptions	getDirectionsOptions()	Gets a copy of the current directions options for this MapView.
LevelPickerControl	getLevelPickerControl()	Returns the level picker control.
LocationMarker	getLocationMarker()	Get the current Location Marker (e.g., blue dot).
MapInfo	getMapInfo()	Get the current loaded map
EditorKey	getMapKey()	Get the current map key
double	getMaxZoomScale()	Get the current maximum zoom scale of the map view.
MapOptions	getOptions()	Gets a copy of the current options for this MapView.
List<Placemark>	getPlacemarks()	Get a copy of the currently-loaded list of Placemarks for this map.
Route	getRoute()	Get the current displayed Route.
int	getRouteStepIndex()	Get the current step index.
MeridianLocation	getUserLocation()	Get the user’s current location.
List<Marker>	getUserMarkers()	Get a copy of the current list of Markers for this map.
void	hideBannerMessage(String accessibilityMessage)	Hides the banner message at the top of the map screen with option to provide an accessible message.
static boolean	isAccessible(android.content.Context c)	Returns if accessible routes are being used.
boolean	isCurrentLocationMarker(Marker marker)	Determines if a specified Marker is the current Location Marker.
void	onAccessibilityButtonClick()	Internal map event handler
void	onCalloutClick()	Internal map event handler that calls MarkerEventListener.onCalloutClick.
void	onCollision(String json)	Internal map event handler for highlighted markers.
void	onCurrentLevelReselected()	Internal map event handler.
void	onDestroy()	Should be called whenever the Activity’s onDestroy that contains this instance is called.
void	onDirectionsButtonClick()	Internal map event handler that calls DirectionsEventListener.onDirectionsClick.
void	onDirectionsRequestCanceled()	Called when the directions request is canceled by the user.
void	onDirectionsRequestComplete(DirectionsResponse response)	Called when the web request for directions is completed successfully.
void	onDirectionsRequestError(Throwable tr)	Called when the request for directions encounters an error.
void	onDirectionsRequestStart()	Called when beginning to request directions.
void	onDoubleTap(float x, float y)	Internal map event handler that zooms to the point.
void	onEnableBluetoothRequest()	Called when Bluetooth is currently disabled and more accurate location information could be derived with Bluetooth enabled.
void	onEnableGPSRequest()	Called when GPS is currently disabled and more accurate location information could be derived with GPS enabled.
void	onEnableWiFiRequest()	Called when WiFi is currently disabled and more accurate location information could be derived with WiFi enabled.
void	onEndButtonClick()	Internal map event handler
boolean	onInterceptTouchEvent(android.view.MotionEvent ev)	Internal handler for View’s onInterceptTouchEvent
void	onLocationButtonClick()
void	onLocationError(Throwable tr)	Called when there was an error updating the users location.
void	onLocationUpdate(MeridianLocation location)	Internal map event handler
void	onMapChange(MapInfo map)	Internal map event handler
void	onMapClick()	Internal map event handler that deselects the current Marker.
void	onMapFinishedLoading()	Internal map event handler that calls MapEventListener.onMapLoadFinish
void	onMapParsingError()	Internal map event handler for loading errors
void	onMarkerClick(Marker marker)	Internal map event handler for when a marker is tapped.
void	onOneFingerLongPress(float x, float y)	Internal map event handler
void	onOverviewMapButtonClick()	Internal map event handler
void	onPause()	Should be called whenever the Activity’s onPause that contains this instance is called.
void	onResume()	Should be called whenever the Activity’s onResume that contains this instance is called.
void	onRouteOverviewButtonClick()	Internal map event handler
void	onRouteResumeButtonClick()	Internal map event handler
void	onRouteStepChange(RouteStep step)	Internal map event handler
void	onSkuChanged(Boolean useMaps, Boolean useBlueDot, Boolean useTags)
void	onThreeFingerLongPress()	Internal map event handler
void	onTransformUpdated(android.graphics.Matrix transform)	Internal handler for map changes
void	onTwoFingerLongPress()	Internal map event handler
void	onTwoFingerTap(float x, float y)	Internal map event handler that zooms out around center of screen.
android.graphics.RectF	rectWithCenter(android.graphics.PointF centerPoint, MapInfo.ZoomLevel zoomLevel)	Returns a rectangle centered on the specified point and sized according to the specified zoom level.
void	restartLocationManager()	Causes the location manager to start.
void	restoreRoute(Route route, int stepIndex)	Restore a directions route and current step index for this MapView.
void	scrollToOverview()	Scroll and zoom map to include the entire loaded map.
void	scrollToRect(android.graphics.RectF target)	Updates the currently visible portion of the map.
void	scrollToRect(android.graphics.RectF target, boolean animated)	Updates the currently visible portion of the map, optionally animating the change.
void	scrollToRect(android.graphics.RectF target, float heading)	Updates the currently visible portion and orientation of the map.
void	scrollToRect(android.graphics.RectF target, float heading, boolean animated)	Updates the currently visible portion and orientation of the map, optionally animating the change.
static void	setAccessibleRoutes(android.content.Context context, boolean useAccessibleRoutes)	Set if accessible routes should be used.
void	setAppKey(EditorKey appKey)	Set the app key for this instance.
void	setBackground(android.graphics.drawable.Drawable background)	Sets the background color for the map.
void	setDirectionPathOptions(int activeStepColor, int inactiveStepColor, float thicknessRatio)	Set the direction’s path colors and thickness.
void	setDirectionsEventListener(MapView.DirectionsEventListener listener)	Set the DirectionsEventListener for this MapView.
void	setDirectionsOptions(DirectionsOptions options)	Set the directions options for this MapView.
void	setLocationMarker(LocationMarker marker)	Sets the Location Marker for this MapView.
void	setMapClickEventListener(MapView.MapClickEventListener listener)	Set the MapClickEventListener for this MapView.
void	setMapEventListener(MapView.MapEventListener listener)	Set the MapEventListener for this MapView.
void	setMapKey(EditorKey mapKey)	Set the map, this will start the process of loading and displaying a map.
void	setMarkerEventListener(MapView.MarkerEventListener listener)	Set the MarkerEventListener for this MapView.
void	setMarkers(Collection<Marker> markers)	Sets the Markers for this MapView.
void	setMaxZoomScale(double scale)	Set the current maximum zoom scale of the map view.
void	setOptions(MapOptions options)	Set the options for this MapView.
void	setOptions(MapOptions options, List<MapInfo> maps)	Set the options and maps for this MapView.
void	setPlacemarkId(String placemarkId)	When a Placemark ID is set, the map will only show that Placemark.
void	setRoute(Route route)	Set a directions route for this MapView.
void	setRoute(Route route, int stepIndex)	Set a directions route and current step index for this MapView.
void	setRouteStepIndex(int index)	Sets the step index for the current route.
void	setShowsPlacemarks(boolean showsPlacemarks)	Set if the MapView should show Placemarks or not.
void	setShowsUserLocation(boolean showUserLocation)	Set if the MapView should show the user’s location or not.
void	showBannerMessage(String message)	Shows a banner message at the top of the map screen.
void	showLoadingCurtain(boolean show)	Show or hide a loading indicator for this view.
boolean	showsPlacemarks()	Returns if the map’s placemarks will be displayed.
boolean	showsUserLocation()	Returns if the user’s current location is shown on the map.
void	updateForLocation(MeridianLocation location)	Moves map focus to specified location

Methods inherited from class android.widget.FrameLayout

checkLayoutParams, generateDefaultLayoutParams, generateLayoutParams, generateLayoutParams, getAccessibilityClassName, getConsiderGoneChildrenWhenMeasuring, getMeasureAllChildren, onLayout, onMeasure, setForegroundGravity, setMeasureAllChildren, shouldDelayChildPressedState

Methods inherited from class android.view.ViewGroup

addChildrenForAccessibility, addExtraDataToAccessibilityNodeInfo, addFocusables, addKeyboardNavigationClusters, addStatesFromChildren, addTouchables, addView, addView, addView, addView, addView, addViewInLayout, addViewInLayout, attachLayoutAnimationParameters, attachViewToParent, bringChildToFront, canAnimate, childDrawableStateChanged, childHasTransientStateChanged, cleanupLayoutState, clearChildFocus, clearDisappearingChildren, clearFocus, debug, detachAllViewsFromParent, detachViewFromParent, detachViewFromParent, detachViewsFromParent, dispatchApplyWindowInsets, dispatchCapturedPointerEvent, dispatchConfigurationChanged, dispatchCreateViewTranslationRequest, dispatchDisplayHint, dispatchDragEvent, dispatchDraw, dispatchDrawableHotspotChanged, dispatchFinishTemporaryDetach, dispatchFreezeSelfOnly, dispatchGenericFocusedEvent, dispatchGenericPointerEvent, dispatchHoverEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchPointerCaptureChanged, dispatchProvideAutofillStructure, dispatchProvideStructure, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchScrollCaptureSearch, dispatchSetActivated, dispatchSetPressed, dispatchSetSelected, dispatchStartTemporaryDetach, dispatchSystemUiVisibilityChanged, dispatchThawSelfOnly, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchVisibilityChanged, dispatchWindowFocusChanged, dispatchWindowInsetsAnimationEnd, dispatchWindowInsetsAnimationPrepare, dispatchWindowInsetsAnimationProgress, dispatchWindowInsetsAnimationStart, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, drawableStateChanged, drawChild, endViewTransition, findFocus, findOnBackInvokedDispatcherForChild, findViewsWithText, focusableViewAvailable, focusSearch, gatherTransparentRegion, getChildAt, getChildCount, getChildDrawingOrder, getChildDrawingOrder, getChildMeasureSpec, getChildStaticTransformation, getChildVisibleRect, getClipChildren, getClipToPadding, getDescendantFocusability, getFocusedChild, getLayoutAnimation, getLayoutAnimationListener, getLayoutMode, getLayoutTransition, getNestedScrollAxes, getOverlay, getPersistentDrawingCache, getTouchscreenBlocksFocus, hasFocus, hasTransientState, indexOfChild, invalidateChild, invalidateChildInParent, isAlwaysDrawnWithCacheEnabled, isAnimationCacheEnabled, isChildrenDrawingOrderEnabled, isChildrenDrawnWithCacheEnabled, isLayoutSuppressed, isMotionEventSplittingEnabled, isTransitionGroup, jumpDrawablesToCurrentState, layout, measureChild, measureChildren, measureChildWithMargins, notifySubtreeAccessibilityStateChanged, offsetDescendantRectToMyCoords, offsetRectIntoDescendantCoords, onAttachedToWindow, onCreateDrawableState, onDescendantInvalidated, onDetachedFromWindow, onInterceptHoverEvent, onNestedFling, onNestedPreFling, onNestedPrePerformAccessibilityAction, onNestedPreScroll, onNestedScroll, onNestedScrollAccepted, onRequestFocusInDescendants, onRequestSendAccessibilityEvent, onResolvePointerIcon, onStartNestedScroll, onStopNestedScroll, onViewAdded, onViewRemoved, propagateRequestedFrameRate, recomputeViewAttributes, removeAllViews, removeAllViewsInLayout, removeDetachedView, removeView, removeViewAt, removeViewInLayout, removeViews, removeViewsInLayout, requestChildFocus, requestChildRectangleOnScreen, requestDisallowInterceptTouchEvent, requestFocus, requestSendAccessibilityEvent, requestTransparentRegion, restoreDefaultFocus, scheduleLayoutAnimation, setAddStatesFromChildren, setAlwaysDrawnWithCacheEnabled, setAnimationCacheEnabled, setChildrenDrawingCacheEnabled, setChildrenDrawingOrderEnabled, setChildrenDrawnWithCacheEnabled, setClipChildren, setClipToPadding, setDescendantFocusability, setLayoutAnimation, setLayoutAnimationListener, setLayoutMode, setLayoutTransition, setMotionEventSplittingEnabled, setOnHierarchyChangeListener, setPersistentDrawingCache, setRequestedFrameRate, setStaticTransformationsEnabled, setTouchscreenBlocksFocus, setTransitionGroup, setWindowInsetsAnimationCallback, showContextMenuForChild, showContextMenuForChild, startActionModeForChild, startActionModeForChild, startLayoutAnimation, startViewTransition, suppressLayout, updateViewLayout

Methods inherited from class android.view.View

addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addOnUnhandledKeyEventListener, animate, announceForAccessibility, autofill, autofill, awakenScrollBars, awakenScrollBars, awakenScrollBars, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelDragAndDrop, cancelLongPress, cancelPendingInputEvents, canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearPendingCredentialRequest, clearViewTranslationCallback, combineMeasuredStates, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeSystemWindowInsets, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchGenericMotionEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, draw, drawableHotspotChanged, findOnBackInvokedDispatcher, findViewById, findViewWithTag, fitSystemWindows, focusSearch, forceHasOverlappingRendering, forceLayout, generateDisplayHash, generateViewId, getAccessibilityDelegate, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityPaneTitle, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAllowedHandwritingDelegatePackageName, getAllowedHandwritingDelegatorPackageName, getAlpha, getAnimation, getAnimationMatrix, getApplicationWindowToken, getAttributeResolutionStack, getAttributeSourceResourceMap, getAutofillHints, getAutofillId, getAutofillType, getAutofillValue, getBackground, getBackgroundTintBlendMode, getBackgroundTintList, getBackgroundTintMode, getBaseline, getBottom, getBottomFadingEdgeStrength, getBottomPaddingOffset, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentCaptureSession, getContentDescription, getContentSensitivity, getContext, getContextMenuInfo, getDefaultFocusHighlightEnabled, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getExplicitStyle, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusable, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintBlendMode, getForegroundTintList, getForegroundTintMode, getFrameContentVelocity, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHandwritingBoundsOffsetBottom, getHandwritingBoundsOffsetLeft, getHandwritingBoundsOffsetRight, getHandwritingBoundsOffsetTop, getHandwritingDelegateFlags, getHandwritingDelegatorCallback, getHasOverlappingRendering, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getHorizontalScrollbarThumbDrawable, getHorizontalScrollbarTrackDrawable, getId, getImportantForAccessibility, getImportantForAutofill, getImportantForContentCapture, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLeftPaddingOffset, getLocalVisibleRect, getLocationInSurface, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextClusterForwardId, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOutlineAmbientShadowColor, getOutlineProvider, getOutlineSpotShadowColor, getOverScrollMode, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getParent, getParentForAccessibility, getPendingCredentialCallback, getPendingCredentialRequest, getPivotX, getPivotY, getPointerIcon, getPreferKeepClearRects, getReceiveContentMimeTypes, getRequestedFrameRate, getResources, getRevealOnFocusHint, getRight, getRightFadingEdgeStrength, getRightPaddingOffset, getRootSurfaceControl, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollCaptureHint, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getSourceLayoutResId, getStateDescription, getStateListAnimator, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getSupplementalDescription, getSystemGestureExclusionRects, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTooltipText, getTop, getTopFadingEdgeStrength, getTopPaddingOffset, getTouchables, getTouchDelegate, getTransitionAlpha, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getUniqueDrawingId, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarThumbDrawable, getVerticalScrollbarTrackDrawable, getVerticalScrollbarWidth, getViewTranslationResponse, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowId, getWindowInsetsController, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasExplicitFocusable, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasOnLongClickListeners, hasOverlappingRendering, hasPointerCapture, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, invalidateOutline, isAccessibilityDataSensitive, isAccessibilityFocused, isAccessibilityHeading, isActivated, isAttachedToWindow, isAutoHandwritingEnabled, isClickable, isContentSensitive, isContextClickable, isCredential, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isFocusedByDefault, isForceDarkAllowed, isHandwritingDelegate, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isImportantForAutofill, isImportantForContentCapture, isInEditMode, isInLayout, isInTouchMode, isKeyboardNavigationCluster, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isOpaque, isPaddingOffsetRequired, isPaddingRelative, isPivotSet, isPreferKeepClear, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScreenReaderFocusable, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShowingLayoutBounds, isShown, isSoundEffectsEnabled, isTemporarilyDetached, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, isVisibleToUserForAutofill, keyboardNavigationClusterSearch, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAnimationEnd, onAnimationStart, onApplyWindowInsets, onCancelPendingInputEvents, onCapturedPointerEvent, onCheckIsTextEditor, onConfigurationChanged, onCreateContextMenu, onCreateInputConnection, onCreateViewTranslationRequest, onCreateVirtualViewTranslationRequests, onDisplayHint, onDragEvent, onDraw, onDrawForeground, onDrawScrollBars, onFilterTouchEventForSecurity, onFinishInflate, onFinishTemporaryDetach, onFocusChanged, onGenericMotionEvent, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onOverScrolled, onPointerCaptureChange, onPopulateAccessibilityEvent, onProvideAutofillStructure, onProvideAutofillVirtualStructure, onProvideContentCaptureStructure, onProvideStructure, onProvideVirtualStructure, onReceiveContent, onRestoreInstanceState, onRtlPropertiesChanged, onSaveInstanceState, onScreenStateChanged, onScrollCaptureSearch, onScrollChanged, onSetAlpha, onSizeChanged, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onViewTranslationResponse, onVirtualViewTranslationResponses, onVisibilityAggregated, onVisibilityChanged, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, onWindowVisibilityChanged, overScrollBy, performAccessibilityAction, performClick, performContextClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, performLongClick, performReceiveContent, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, releasePointerCapture, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, removeOnUnhandledKeyEventListener, reportAppJankStats, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestPointerCapture, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, requestUnbufferedDispatch, requireViewById, resetPivot, resolveSize, resolveSizeAndState, restoreHierarchyState, saveAttributeDataForStyleable, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDataSensitive, setAccessibilityDelegate, setAccessibilityHeading, setAccessibilityLiveRegion, setAccessibilityPaneTitle, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAllowClickWhenDisabled, setAllowedHandwritingDelegatePackage, setAllowedHandwritingDelegatorPackage, setAlpha, setAnimation, setAnimationMatrix, setAutofillHints, setAutofillId, setAutoHandwritingEnabled, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintBlendMode, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentCaptureSession, setContentDescription, setContentSensitivity, setContextClickable, setDefaultFocusHighlightEnabled, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusable, setFocusableInTouchMode, setFocusedByDefault, setForceDarkAllowed, setForeground, setForegroundTintBlendMode, setForegroundTintList, setForegroundTintMode, setFrameContentVelocity, setHandwritingBoundsOffsets, setHandwritingDelegateFlags, setHandwritingDelegatorCallback, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHorizontalScrollbarThumbDrawable, setHorizontalScrollbarTrackDrawable, setHovered, setId, setImportantForAccessibility, setImportantForAutofill, setImportantForContentCapture, setIsCredential, setIsHandwritingDelegate, setKeepScreenOn, setKeyboardNavigationCluster, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLeftTopRightBottom, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextClusterForwardId, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnCapturedPointerListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnReceiveContentListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineAmbientShadowColor, setOutlineProvider, setOutlineSpotShadowColor, setOverScrollMode, setPadding, setPaddingRelative, setPendingCredentialRequest, setPivotX, setPivotY, setPointerIcon, setPreferKeepClear, setPreferKeepClearRects, setPressed, setRenderEffect, setRevealOnFocusHint, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScreenReaderFocusable, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollCaptureCallback, setScrollCaptureHint, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSelected, setSoundEffectsEnabled, setStateDescription, setStateListAnimator, setSupplementalDescription, setSystemGestureExclusionRects, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTooltipText, setTop, setTouchDelegate, setTransitionAlpha, setTransitionName, setTransitionVisibility, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setVerticalScrollbarThumbDrawable, setVerticalScrollbarTrackDrawable, setViewTranslationCallback, setVisibility, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startDragAndDrop, startNestedScroll, stopNestedScroll, toString, transformMatrixToGlobal, transformMatrixToLocal, unscheduleDrawable, unscheduleDrawable, updateDragShadow, verifyDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface android.view.ViewParent

canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, createContextMenu, getLayoutDirection, getParent, getParentForAccessibility, getTextAlignment, getTextDirection, isLayoutDirectionResolved, isLayoutRequested, isTextAlignmentResolved, isTextDirectionResolved, keyboardNavigationClusterSearch, requestFitSystemWindows, requestLayout

Field Details

REQUIRED_OPENGL_LEVEL

public static final int REQUIRED_OPENGL_LEVEL

See Also:

• Constant Field Values

Constructor Details

MapView

public MapView(android.content.Context context)
        throws MapView.OpenGLNotSupportedException

Construct a MapView with the given Context.

Throws:

MapView.OpenGLNotSupportedException

MapView

public MapView(android.content.Context context,
 android.util.AttributeSet attrs)
        throws MapView.OpenGLNotSupportedException

Construct a MapView with the given Context and attributes.

Available attributes include:

```xml = false = false = false = false = false = false = false = false = false = false = false = 12dp = 2 = false ```

Throws:

MapView.OpenGLNotSupportedException

MapView

public MapView(android.content.Context context,
 android.util.AttributeSet attrs,
 int defStyle)
        throws MapView.OpenGLNotSupportedException

Construct a MapView with the given Context and attributes and style.

Available attributes include:

```xml = false = false = false = false = false = false = false = false = false = false = false = 12dp = 2 = false ```

Parameters:

defStyle - From FrameLayout - A resource identifier of a style resource that supplies default values for the TypedArray, used only if defStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults.

Throws:

MapView.OpenGLNotSupportedException

Method Details

onPause

public void onPause()

Should be called whenever the Activity’s onPause that contains this instance is called.

onResume

public void onResume()

Should be called whenever the Activity’s onResume that contains this instance is called.

onDestroy

public void onDestroy()

Should be called whenever the Activity’s onDestroy that contains this instance is called.

setMapEventListener

public void setMapEventListener(MapView.MapEventListener listener)

Set the MapEventListener for this MapView.

Parameters:

listener - The MapView.MapEventListener for this MapView.

setMapClickEventListener

public void setMapClickEventListener(MapView.MapClickEventListener listener)

Set the MapClickEventListener for this MapView.

Parameters:

listener - The MapView.MapClickEventListener for this MapView.

setDirectionsEventListener

public void setDirectionsEventListener(MapView.DirectionsEventListener listener)

Set the DirectionsEventListener for this MapView.

Parameters:

listener - The MapView.DirectionsEventListener for this MapView.

setMarkerEventListener

public void setMarkerEventListener(MapView.MarkerEventListener listener)

Set the MarkerEventListener for this MapView.

Parameters:

listener - The MapView.MarkerEventListener for this MapView.

getAppKey

public EditorKey getAppKey()

Get the current app key

setAppKey

public void setAppKey(EditorKey appKey)

Set the app key for this instance.

This can only be set once. If changing the app key is necessary, the MapView must be recreated.

Parameters:

appKey - The Editor key for the location.

Throws:

IllegalArgumentException - If the AppKey has already been set.

getMapKey

public EditorKey getMapKey()

Get the current map key

getMapInfo

public MapInfo getMapInfo()

Get the current loaded map

Returns:

The current MapInfo, may be null if no map has been loaded.

setMapKey

public void setMapKey(EditorKey mapKey)

Set the map, this will start the process of loading and displaying a map.

Parameters:

mapKey - The editor key for the map

Throws:

IllegalArgumentException - if no AppKey has been set or the MapKey passed is not a child of the set AppKey

setPlacemarkId

public void setPlacemarkId(String placemarkId)

When a Placemark ID is set, the map will only show that Placemark.

Parameters:

placemarkId - Placemark ID to show on the map

setMaxZoomScale

public void setMaxZoomScale(double scale)

Set the current maximum zoom scale of the map view.

Setting this to zero will force the default max zoom level to be used.

Parameters:

scale - The zoom scale to use.

getMaxZoomScale

public double getMaxZoomScale()

Get the current maximum zoom scale of the map view.

getPlacemarks

public List<Placemark> getPlacemarks()

Get a copy of the currently-loaded list of Placemarks for this map.

This list may be empty until the onMapLoadFinish() listener method is called.

Returns:

List of Placemarks on the map.

getAllMarkers

public List<Marker> getAllMarkers()

Get a copy of the current list of Markers for this map.

This list does include markers generated by the MapView from Placemarks and user created markers.

Returns:

List of all Markers on the map.

getUserMarkers

public List<Marker> getUserMarkers()

Get a copy of the current list of Markers for this map.

This list does not include markers generated by the MapView from Placemarks.

Returns:

List of user created markers.

getAssociatedPlacemark

@Nullable
public Placemark getAssociatedPlacemark(@NonNull
 Marker marker)

Return any associated Placemark for Markers generated through calls to markerForPlacemark.

Returns:

A Placemark used to generate this Marker.

isCurrentLocationMarker

public boolean isCurrentLocationMarker(@NonNull
 Marker marker)

Determines if a specified Marker is the current Location Marker.

Returns:

True if the Marker parameter is the current Location Marker.

getLocationMarker

public LocationMarker getLocationMarker()

Get the current Location Marker (e.g., blue dot).

Returns:

Returns the LocationMarker for this MapView.

setLocationMarker

public void setLocationMarker(@NonNull
 LocationMarker marker)

Sets the Location Marker for this MapView.

This can be used to customize the blue dot.

Parameters:

marker - The new LocationMarker for this MapView.

setMarkers

public void setMarkers(Collection<Marker> markers)

Sets the Markers for this MapView.

This will replace any previously added Markers and should be called sparingly.

Parameters:

markers - A collection of Markers to add to the MapView.

commitTransaction

public void commitTransaction(@NonNull
 Transaction transaction)

Commits a Transaction to be applied to the MapView.

This is used to change Markers on the map.

Parameters:

transaction - The transaction to commit, must not be null.

getRoute

public Route getRoute()

Get the current displayed Route.

Returns:

displayed directions route

getRouteStepIndex

public int getRouteStepIndex()

Get the current step index.

Returns:

the current step in the directions route

setDirectionPathOptions

public void setDirectionPathOptions(int activeStepColor,
 int inactiveStepColor,
 float thicknessRatio)

Set the direction’s path colors and thickness.

Parameters:

activeStepColor - The color for the currently active path step (see: getRouteStepIndex())

inactiveStepColor - The color for the inactive path steps

thicknessRatio - A multiplier applied to increase or decrease path thickness (limited to 0.10 < x < 10.00)

showsPlacemarks

public boolean showsPlacemarks()

Returns if the map’s placemarks will be displayed.

Returns:

True if the MapView is set to show placemarks.

setShowsPlacemarks

public void setShowsPlacemarks(boolean showsPlacemarks)

Set if the MapView should show Placemarks or not.

This must be called before the map is loaded.

Parameters:

showsPlacemarks - If true (the default), the map’s placemarks will be displayed.

showsUserLocation

public boolean showsUserLocation()

Returns if the user’s current location is shown on the map.

Returns:

True if the MapView is set to show the user’s location.

setShowsUserLocation

public void setShowsUserLocation(boolean showUserLocation)

Set if the MapView should show the user’s location or not.

Parameters:

showUserLocation - If true, the map will show the user’s current location when available.

getUserLocation

public MeridianLocation getUserLocation()

Get the user’s current location.

Returns:

The user’s current location MeridianLocation

getOptions

public MapOptions getOptions()

Gets a copy of the current options for this MapView.

Changing the properties of the returned MapOptions will have no effect. To change the MapOptions for this MapView, call setOptions.

Returns:

The current map options

setOptions

public void setOptions(MapOptions options)

Set the options for this MapView.

The properties of the options parameter are copied into the Map options of this MapView.

Parameters:

options - map options to apply

setOptions

public void setOptions(MapOptions options,
 List<MapInfo> maps)

Set the options and maps for this MapView.

The properties of the options parameter are copied into the Map options of this MapView. Only use this method if your application is using LevelPickerControl.PickerStyle.PICKER_SEARCH and has already retrieved the maps from the server (e.g., Aruba Meridian).

Parameters:

options - map options to apply

maps - all of the maps for the map picker

getDirectionsOptions

public DirectionsOptions getDirectionsOptions()

Gets a copy of the current directions options for this MapView.

Changing the properties of the returned DirectionsOptions will have no effect. To change the DirectionsOptions for this MapView, call setDirectionsOptions.

Returns:

The current map directions options

setDirectionsOptions

public void setDirectionsOptions(DirectionsOptions options)

Set the directions options for this MapView.

The properties of the options parameter are copied into the Directions options of this MapView.

Parameters:

options - directions options to apply

showLoadingCurtain

public void showLoadingCurtain(boolean show)

Show or hide a loading indicator for this view.

Parameters:

show - true to show the indicator false to hide it

getLevelPickerControl

public LevelPickerControl getLevelPickerControl()

Returns the level picker control.

This could be used to set the selected level.

Returns:

The LevelPickerControl for the map

onTransformUpdated

public void onTransformUpdated(android.graphics.Matrix transform)

Internal handler for map changes

onMapChange

public void onMapChange(MapInfo map)

Internal map event handler

onCurrentLevelReselected

public void onCurrentLevelReselected()

Internal map event handler.

When selecting the current map in the map picker, the map picker is dismissed and onMapClick is fired.

onRouteStepChange

public void onRouteStepChange(RouteStep step)

Internal map event handler

onInterceptTouchEvent

public boolean onInterceptTouchEvent(android.view.MotionEvent ev)

Internal handler for View’s onInterceptTouchEvent

Overrides:

onInterceptTouchEvent in class android.view.ViewGroup

onOverviewMapButtonClick

public void onOverviewMapButtonClick()

Internal map event handler

onRouteOverviewButtonClick

public void onRouteOverviewButtonClick()

Internal map event handler

onRouteResumeButtonClick

public void onRouteResumeButtonClick()

Internal map event handler

onLocationButtonClick

public void onLocationButtonClick()

updateForLocation

public void updateForLocation(@NonNull
 MeridianLocation location)

Moves map focus to specified location

Parameters:

location - map location to focus on

isAccessible

public static boolean isAccessible(android.content.Context c)

Returns if accessible routes are being used.

Returns:

True if MapView is in use accessible routes mode.

setAccessibleRoutes

public static void setAccessibleRoutes(android.content.Context context,
 boolean useAccessibleRoutes)

Set if accessible routes should be used.

Parameters:

context - The application context.

useAccessibleRoutes -

• if accessible routes should be used.

onAccessibilityButtonClick

public void onAccessibilityButtonClick()

Internal map event handler

onEndButtonClick

public void onEndButtonClick()

Internal map event handler

onLocationUpdate

public void onLocationUpdate(MeridianLocation location)

Internal map event handler

Specified by:

onLocationUpdate in interface MeridianLocationManager.LocationUpdateListener

onLocationError

public void onLocationError(Throwable tr)

Called when there was an error updating the users location.

Specified by:

onLocationError in interface MeridianLocationManager.LocationUpdateListener

onEnableBluetoothRequest

public void onEnableBluetoothRequest()

Called when Bluetooth is currently disabled and more accurate location information could be derived with Bluetooth enabled.

It would be appropriate to prompt the user to turn on their Bluetooth and provide and button that will launch an intent to display the Bluetooth settings if this added functionality is desired.

Specified by:

onEnableBluetoothRequest in interface MeridianLocationManager.LocationUpdateListener

onEnableWiFiRequest

public void onEnableWiFiRequest()

Called when WiFi is currently disabled and more accurate location information could be derived with WiFi enabled.

It would be appropriate to prompt the user to turn on their WiFi and provide and button that will launch an intent to display the WiFi settings if this added functionality is desired.

Specified by:

onEnableWiFiRequest in interface MeridianLocationManager.LocationUpdateListener

onEnableGPSRequest

public void onEnableGPSRequest()

Called when GPS is currently disabled and more accurate location information could be derived with GPS enabled.

It would be appropriate to prompt the user to turn on their GPS and provide and button that will launch an intent to display the GPS settings if this added functionality is desired.

Specified by:

onEnableGPSRequest in interface MeridianLocationManager.LocationUpdateListener

onMapParsingError

public void onMapParsingError()

Internal map event handler for loading errors

onMarkerClick

public void onMarkerClick(Marker marker)

Internal map event handler for when a marker is tapped.

onCollision

public void onCollision(String json)

Internal map event handler for highlighted markers.

onDirectionsButtonClick

public void onDirectionsButtonClick()

Internal map event handler that calls DirectionsEventListener.onDirectionsClick.

onCalloutClick

public void onCalloutClick()

Internal map event handler that calls MarkerEventListener.onCalloutClick.

onMapClick

public void onMapClick()

Internal map event handler that deselects the current Marker.

onDoubleTap

public void onDoubleTap(float x,
 float y)

Internal map event handler that zooms to the point.

onTwoFingerTap

public void onTwoFingerTap(float x,
 float y)

Internal map event handler that zooms out around center of screen.

onMapFinishedLoading

public void onMapFinishedLoading()

Internal map event handler that calls MapEventListener.onMapLoadFinish

onSkuChanged

public void onSkuChanged(Boolean useMaps,
 Boolean useBlueDot,
 Boolean useTags)

getCurrentScreenToMapTransform

public android.graphics.Matrix getCurrentScreenToMapTransform()

Gets the current transformation matrix (3x3) between the screen and the map.

Returns:

The transformation matrix

onDirectionsRequestStart

public void onDirectionsRequestStart()

Called when beginning to request directions.

Specified by:

onDirectionsRequestStart in interface Directions.DirectionsRequestListener

onDirectionsRequestComplete

public void onDirectionsRequestComplete(DirectionsResponse response)

Called when the web request for directions is completed successfully.

Specified by:

onDirectionsRequestComplete in interface Directions.DirectionsRequestListener

onDirectionsRequestError

public void onDirectionsRequestError(Throwable tr)

Called when the request for directions encounters an error.

Specified by:

onDirectionsRequestError in interface Directions.DirectionsRequestListener

onDirectionsRequestCanceled

public void onDirectionsRequestCanceled()

Called when the directions request is canceled by the user.

Specified by:

onDirectionsRequestCanceled in interface Directions.DirectionsRequestListener

endDirections

public void endDirections()

Ends the current directions route for this MapView.

This is the same as pressing the end directions button

setRoute

public void setRoute(Route route)

Set a directions route for this MapView.

Do NOT use this with mapFragment. Use mapFragment’s startDirections instead.

Parameters:

route - The route to display.

setRoute

public void setRoute(Route route,
 int stepIndex)

Set a directions route and current step index for this MapView.

Do NOT use this with mapFragment. Use mapFragment’s startDirections instead.

Parameters:

route - The route to display.

stepIndex - The index of the desired step.

restoreRoute

public void restoreRoute(Route route,
 int stepIndex)

Restore a directions route and current step index for this MapView.

Parameters:

route - Route to restore.

stepIndex - The index of the desired step.

setRouteStepIndex

public void setRouteStepIndex(int index)

Sets the step index for the current route.

Parameters:

index - The index of the desired step.

scrollToOverview

public void scrollToOverview()

Scroll and zoom map to include the entire loaded map.

scrollToRect

public void scrollToRect(android.graphics.RectF target)

Updates the currently visible portion of the map.

Parameters:

target - The rectangle describing the part of the map that should be visible.

scrollToRect

public void scrollToRect(android.graphics.RectF target,
 boolean animated)

Updates the currently visible portion of the map, optionally animating the change.

Parameters:

target - The rectangle describing the part of the map that should be visible.

animated - If true, the change will be animated. Otherwise, the change will be instant.

scrollToRect

public void scrollToRect(android.graphics.RectF target,
 float heading)

Updates the currently visible portion and orientation of the map.

Parameters:

target - The rectangle describing the part of the map that should be visible.

heading - The angle, in radians, the map’s angle will become.

scrollToRect

public void scrollToRect(android.graphics.RectF target,
 float heading,
 boolean animated)

Updates the currently visible portion and orientation of the map, optionally animating the change.

Parameters:

target - The rectangle describing the part of the map that should be visible.

heading - The angle, in radians, the map’s angle will become.

animated - If true, the change will be animated. Otherwise, the change will be instant.

rectWithCenter

public android.graphics.RectF rectWithCenter(android.graphics.PointF centerPoint,
 MapInfo.ZoomLevel zoomLevel)

Returns a rectangle centered on the specified point and sized according to the specified zoom level.

Parameters:

centerPoint - The point at which to place the rectangle’s center.

zoomLevel - The zoom level to use when determining the rectangle’s size.

onThreeFingerLongPress

public void onThreeFingerLongPress()

Internal map event handler

onTwoFingerLongPress

public void onTwoFingerLongPress()

Internal map event handler

onOneFingerLongPress

public void onOneFingerLongPress(float x,
 float y)

Internal map event handler

expandPicker

public void expandPicker()

Expands the map picker, deselecting the currently selected Marker.

setBackground

public void setBackground(android.graphics.drawable.Drawable background)

Sets the background color for the map.

Overrides:

setBackground in class android.view.View

Parameters:

background - A ColorDrawable to set the background to.

showBannerMessage

public void showBannerMessage(String message)

Shows a banner message at the top of the map screen.

The banner message is used to display relevant information in a banner (e.g., “Reorient yourself to the directions line”)

Parameters:

message - Message to be shown in the banner.

hideBannerMessage

public void hideBannerMessage(String accessibilityMessage)

Hides the banner message at the top of the map screen with option to provide an accessible message.

Parameters:

accessibilityMessage - TalkBack message to be announced. Null if no message is desired.

restartLocationManager

public void restartLocationManager()

Causes the location manager to start.

In general this should not be called unless something changed since opening the mapview. One example would be if the user accepted additional permissions (e.g. location) while the map was open.