com.dingi.dingisdk.maps

Class MapView

java.lang.Object

android.view.View

android.view.ViewGroup

android.widget.FrameLayout

com.dingi.dingisdk.maps.MapView

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.view.accessibility.AccessibilityEventSource, android.view.KeyEvent.Callback, android.view.ViewManager, android.view.ViewParent, com.dingi.dingisdk.maps.NativeMapView.ViewCallback

public class MapView
extends android.widget.FrameLayout
implements com.dingi.dingisdk.maps.NativeMapView.ViewCallback

A MapView provides an embeddable map interface. You use this class to display map information and to manipulate the map contents from your application. You can center the map on a given coordinate, specify the size of the area you want to display, and style the features of the map to fit your application's use case.

Use of MapView requires a Dingi API access token.

Warning: Please note that you are responsible for getting permission to use the map data, and for ensuring your use adheres to the relevant terms of use.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MapView.OnCameraDidChangeListener Interface definition for a callback to be invoked when the map region did change.
static interface	MapView.OnCameraIsChangingListener Interface definition for a callback to be invoked when the camera is changing.
static interface	MapView.OnCameraWillChangeListener Interface definition for a callback to be invoked when the camera will change.
static interface	MapView.OnDidFailLoadingMapListener Interface definition for a callback to be invoked when the map is changing.
static interface	MapView.OnDidFinishLoadingMapListener Interface definition for a callback to be invoked when the map finished loading.
static interface	MapView.OnDidFinishLoadingStyleListener Interface definition for a callback to be invoked when the map has loaded the style.
static interface	MapView.OnDidFinishRenderingFrameListener Interface definition for a callback to be invoked when the map finished rendering a frame.
static interface	MapView.OnDidFinishRenderingMapListener Interface definition for a callback to be invoked when the map is changing.
static interface	MapView.OnSourceChangedListener Interface definition for a callback to be invoked when a map source has changed.
static interface	MapView.OnWillStartLoadingMapListener Interface definition for a callback to be invoked when the map will start loading.
static interface	MapView.OnWillStartRenderingFrameListener Interface definition for a callback to be invoked when the map will start rendering a frame.
static interface	MapView.OnWillStartRenderingMapListener Interface definition for a callback to be invoked when the map will start rendering the map.

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 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_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, DRAG_FLAG_GLOBAL, DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION, DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION, DRAG_FLAG_GLOBAL_URI_READ, DRAG_FLAG_GLOBAL_URI_WRITE, DRAG_FLAG_OPAQUE, 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, 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, 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_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 and Description
MapView(android.content.Context context)
MapView(android.content.Context context, android.util.AttributeSet attrs)
MapView(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr)
MapView(android.content.Context context, DingiMapOptions options)

Method Summary

Modifier and Type	Method and Description
void	addOnCameraDidChangeListener(MapView.OnCameraDidChangeListener listener) Set a callback that's invoked when the camera region did change.
void	addOnCameraIsChangingListener(MapView.OnCameraIsChangingListener listener) Set a callback that's invoked when the camera is changing.
void	addOnCameraWillChangeListener(MapView.OnCameraWillChangeListener listener) Set a callback that's invoked when the camera region will change.
void	addOnDidFailLoadingMapListener(MapView.OnDidFailLoadingMapListener listener) Set a callback that's invoked when the map failed to load.
void	addOnDidFinishLoadingMapListener(MapView.OnDidFinishLoadingMapListener listener) Set a callback that's invoked when the map has finished loading.
void	addOnDidFinishLoadingStyleListener(MapView.OnDidFinishLoadingStyleListener listener) Set a callback that's invoked when the style has finished loading.
void	addOnDidFinishRenderingFrameListener(MapView.OnDidFinishRenderingFrameListener listener) Set a callback that's invoked when the map has finished rendering a frame.
void	addOnDidFinishRenderingMapListener(MapView.OnDidFinishRenderingMapListener listener) Set a callback that's invoked when the map has finished rendering.
void	addOnSourceChangedListener(MapView.OnSourceChangedListener listener) Set a callback that's invoked when a map source has changed.
void	addOnWillStartLoadingMapListener(MapView.OnWillStartLoadingMapListener listener) Set a callback that's invoked when the map will start loading.
void	addOnWillStartRenderingFrameListener(MapView.OnWillStartRenderingFrameListener listener) Set a callback that's invoked when the map will start rendering a frame.
void	addOnWillStartRenderingMapListener(MapView.OnWillStartRenderingMapListener listener) Set a callback that's invoked when the map will start rendering.
void	getMapAsync(OnMapReadyCallback callback) Sets a callback object which will be triggered when the DingiMap instance is ready to be used.
android.graphics.Bitmap	getViewContent()
protected void	initialize(android.content.Context context, DingiMapOptions options)
boolean	isDestroyed() Returns if the map has been destroyed.
void	onCreate(android.os.Bundle savedInstanceState) You must call this method from the parent's Activity#onCreate(Bundle)} or Fragment#onViewCreated(View, Bundle).
void	onDestroy() You must call this method from the parent's Activity#onDestroy() or Fragment#onDestroyView().
boolean	onGenericMotionEvent(android.view.MotionEvent event)
boolean	onKeyDown(int keyCode, android.view.KeyEvent event)
boolean	onKeyLongPress(int keyCode, android.view.KeyEvent event)
boolean	onKeyUp(int keyCode, android.view.KeyEvent event)
void	onLowMemory() You must call this method from the parent's Activity#onLowMemory() or Fragment#onLowMemory().
void	onPause() You must call this method from the parent's Activity#onPause() or Fragment#onPause().
void	onResume() You must call this method from the parent's Activity#onResume() or Fragment#onResume().
void	onSaveInstanceState(android.os.Bundle outState) You must call this method from the parent's Activity#onSaveInstanceState(Bundle) or Fragment#onSaveInstanceState(Bundle).
protected void	onSizeChanged(int width, int height, int oldw, int oldh)
void	onStart() You must call this method from the parent's Activity#onStart() or Fragment#onStart()
void	onStop() You must call this method from the parent's Activity#onStop() or Fragment#onStop().
boolean	onTouchEvent(android.view.MotionEvent event)
boolean	onTrackballEvent(android.view.MotionEvent event)
void	removeOnCameraDidChangeListener(MapView.OnCameraDidChangeListener listener) Set a callback that's invoked when the camera region did change.
void	removeOnCameraIsChangingListener(MapView.OnCameraIsChangingListener listener) Remove a callback that's invoked when the camera is changing.
void	removeOnCameraWillChangeListener(MapView.OnCameraWillChangeListener listener) Remove a callback that's invoked when the camera region will change.
void	removeOnDidFailLoadingMapListener(MapView.OnDidFailLoadingMapListener listener) Set a callback that's invoked when the map failed to load.
void	removeOnDidFinishLoadingMapListener(MapView.OnDidFinishLoadingMapListener listener) Set a callback that's invoked when the map has finished loading.
void	removeOnDidFinishLoadingStyleListener(MapView.OnDidFinishLoadingStyleListener listener) Set a callback that's invoked when the style has finished loading.
void	removeOnDidFinishRenderingFrameListener(MapView.OnDidFinishRenderingFrameListener listener) Set a callback that's invoked when the map has finished rendering a frame.
void	removeOnDidFinishRenderingMapListener(MapView.OnDidFinishRenderingMapListener listener) Remove a callback that's invoked when the map has finished rendering.
void	removeOnSourceChangedListener(MapView.OnSourceChangedListener listener) Set a callback that's invoked when a map source has changed.
void	removeOnWillStartLoadingMapListener(MapView.OnWillStartLoadingMapListener listener) Set a callback that's invoked when the map will start loading.
void	removeOnWillStartRenderingFrameListener(MapView.OnWillStartRenderingFrameListener listener) Set a callback that's invoked when the map will start rendering a frame.
void	removeOnWillStartRenderingMapListener(MapView.OnWillStartRenderingMapListener listener) Set a callback that's invoked when the map will start rendering.
static void	setMapStrictModeEnabled(boolean strictModeEnabled) Sets the strict mode that will throw the MapStrictModeException whenever the map would fail silently otherwise.
void	setOfflineRegionDefinition(OfflineRegionDefinition definition) Loads a new style from the specified offline region definition and moves the map camera to that region.
void	setStyleUrl(java.lang.String url) Loads a new map style from the specified URL.

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, 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, dispatchDisplayHint, dispatchDragEvent, dispatchDraw, dispatchDrawableHotspotChanged, dispatchFinishTemporaryDetach, dispatchFreezeSelfOnly, dispatchGenericFocusedEvent, dispatchGenericPointerEvent, dispatchHoverEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchPointerCaptureChanged, dispatchProvideAutofillStructure, dispatchProvideStructure, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchSetActivated, dispatchSetPressed, dispatchSetSelected, dispatchStartTemporaryDetach, dispatchSystemUiVisibilityChanged, dispatchThawSelfOnly, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchVisibilityChanged, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, drawableStateChanged, drawChild, endViewTransition, findFocus, findViewsWithText, focusableViewAvailable, focusSearch, gatherTransparentRegion, getChildAt, getChildCount, 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, isMotionEventSplittingEnabled, isTransitionGroup, jumpDrawablesToCurrentState, layout, measureChild, measureChildren, measureChildWithMargins, notifySubtreeAccessibilityStateChanged, offsetDescendantRectToMyCoords, offsetRectIntoDescendantCoords, onAttachedToWindow, onCreateDrawableState, onDescendantInvalidated, onDetachedFromWindow, onInterceptHoverEvent, onInterceptTouchEvent, onNestedFling, onNestedPreFling, onNestedPrePerformAccessibilityAction, onNestedPreScroll, onNestedScroll, onNestedScrollAccepted, onRequestFocusInDescendants, onRequestSendAccessibilityEvent, onResolvePointerIcon, onStartNestedScroll, onStopNestedScroll, onViewAdded, onViewRemoved, 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, setStaticTransformationsEnabled, setTouchscreenBlocksFocus, setTransitionGroup, showContextMenuForChild, showContextMenuForChild, startActionModeForChild, startActionModeForChild, startLayoutAnimation, startViewTransition, updateViewLayout

Methods inherited from class android.view.View

addExtraDataToAccessibilityNodeInfo, 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, combineMeasuredStates, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeSystemWindowInsets, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchGenericMotionEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, draw, drawableHotspotChanged, findViewById, findViewWithTag, fitSystemWindows, focusSearch, forceHasOverlappingRendering, forceLayout, generateViewId, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityPaneTitle, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAlpha, getAnimation, getApplicationWindowToken, getAutofillHints, getAutofillId, getAutofillType, getAutofillValue, getBackground, getBackgroundTintList, getBackgroundTintMode, getBaseline, getBottom, getBottomFadingEdgeStrength, getBottomPaddingOffset, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentDescription, getContext, getContextMenuInfo, getDefaultFocusHighlightEnabled, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusable, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintList, getForegroundTintMode, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHasOverlappingRendering, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getImportantForAccessibility, getImportantForAutofill, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLeftPaddingOffset, getLocalVisibleRect, 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, getPivotX, getPivotY, getPointerIcon, getResources, getRevealOnFocusHint, getRight, getRightFadingEdgeStrength, getRightPaddingOffset, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getStateListAnimator, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTooltipText, getTop, getTopFadingEdgeStrength, getTopPaddingOffset, getTouchables, getTouchDelegate, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowId, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasExplicitFocusable, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasOverlappingRendering, hasPointerCapture, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, invalidateOutline, isAccessibilityFocused, isAccessibilityHeading, isActivated, isAttachedToWindow, isClickable, isContextClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isFocusedByDefault, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isImportantForAutofill, isInEditMode, isInLayout, isInTouchMode, isKeyboardNavigationCluster, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isOpaque, isPaddingOffsetRequired, isPaddingRelative, isPivotSet, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScreenReaderFocusable, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isTemporarilyDetached, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, isVisibleToUserForAutofill, keyboardNavigationClusterSearch, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAnimationEnd, onAnimationStart, onApplyWindowInsets, onCancelPendingInputEvents, onCapturedPointerEvent, onCheckIsTextEditor, onConfigurationChanged, onCreateContextMenu, onCreateInputConnection, onDisplayHint, onDragEvent, onDraw, onDrawForeground, onDrawScrollBars, onFilterTouchEventForSecurity, onFinishInflate, onFinishTemporaryDetach, onFocusChanged, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyMultiple, onKeyPreIme, onKeyShortcut, onOverScrolled, onPointerCaptureChange, onPopulateAccessibilityEvent, onProvideAutofillStructure, onProvideAutofillVirtualStructure, onProvideStructure, onProvideVirtualStructure, onRestoreInstanceState, onRtlPropertiesChanged, onSaveInstanceState, onScreenStateChanged, onScrollChanged, onSetAlpha, onStartTemporaryDetach, onVisibilityAggregated, onVisibilityChanged, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, onWindowVisibilityChanged, overScrollBy, performAccessibilityAction, performClick, performContextClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, releasePointerCapture, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, removeOnUnhandledKeyEventListener, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestPointerCapture, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, requireViewById, resetPivot, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setAccessibilityHeading, setAccessibilityLiveRegion, setAccessibilityPaneTitle, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAlpha, setAnimation, setAutofillHints, setAutofillId, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentDescription, setContextClickable, setDefaultFocusHighlightEnabled, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusable, setFocusableInTouchMode, setFocusedByDefault, setForeground, setForegroundTintList, setForegroundTintMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setImportantForAutofill, setKeepScreenOn, setKeyboardNavigationCluster, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextClusterForwardId, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnCapturedPointerListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineAmbientShadowColor, setOutlineProvider, setOutlineSpotShadowColor, setOverScrollMode, setPadding, setPaddingRelative, setPivotX, setPivotY, setPointerIcon, setPressed, setRevealOnFocusHint, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScreenReaderFocusable, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSelected, setSoundEffectsEnabled, setStateListAnimator, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTooltipText, setTop, setTouchDelegate, setTransitionName, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setVisibility, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startDragAndDrop, startNestedScroll, stopNestedScroll, toString, 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 com.dingi.dingisdk.maps.NativeMapView.ViewCallback

getHeight, getWidth

Methods inherited from interface android.view.ViewParent

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

Constructor Detail

MapView

@UiThread
public MapView(@NonNull
                         android.content.Context context)

MapView

@UiThread
public MapView(@NonNull
                         android.content.Context context,
                         @Nullable
                         android.util.AttributeSet attrs)

MapView

@UiThread
public MapView(@NonNull
                         android.content.Context context,
                         @Nullable
                         android.util.AttributeSet attrs,
                         int defStyleAttr)

MapView

@UiThread
public MapView(@NonNull
                         android.content.Context context,
                         @Nullable
                         DingiMapOptions options)

Method Detail

initialize

@CallSuper
 @UiThread
protected void initialize(@NonNull
                                                android.content.Context context,
                                                @NonNull
                                                DingiMapOptions options)

onCreate

@UiThread
public void onCreate(@Nullable
                               android.os.Bundle savedInstanceState)

You must call this method from the parent's Activity#onCreate(Bundle)} or Fragment#onViewCreated(View, Bundle).

You must set a valid access token with Dingi.getInstance(Context, String) before you call this method or an exception will be thrown.

Parameters:

savedInstanceState - Pass in the parent's savedInstanceState.

See Also:

Dingi.getInstance(Context, String)

onSaveInstanceState

@UiThread
public void onSaveInstanceState(@NonNull
                                          android.os.Bundle outState)

You must call this method from the parent's Activity#onSaveInstanceState(Bundle) or Fragment#onSaveInstanceState(Bundle).

Parameters:

outState - Pass in the parent's outState.

onStart

@UiThread
public void onStart()

You must call this method from the parent's Activity#onStart() or Fragment#onStart()

onResume

@UiThread
public void onResume()

You must call this method from the parent's Activity#onResume() or Fragment#onResume().

onPause

@UiThread
public void onPause()

You must call this method from the parent's Activity#onPause() or Fragment#onPause().

onStop

@UiThread
public void onStop()

You must call this method from the parent's Activity#onStop() or Fragment#onStop().

onDestroy

@UiThread
public void onDestroy()

You must call this method from the parent's Activity#onDestroy() or Fragment#onDestroyView().

isDestroyed

@UiThread
public boolean isDestroyed()

Returns if the map has been destroyed.

This method can be used to determine if the result of an asynchronous operation should be set.

Returns:

true, if the map has been destroyed

onTouchEvent

public boolean onTouchEvent(android.view.MotionEvent event)

Overrides:

onTouchEvent in class android.view.View

onKeyDown

public boolean onKeyDown(int keyCode,
                         @NonNull
                         android.view.KeyEvent event)

Specified by:

onKeyDown in interface android.view.KeyEvent.Callback

Overrides:

onKeyDown in class android.view.View

onKeyLongPress

public boolean onKeyLongPress(int keyCode,
                              android.view.KeyEvent event)

Specified by:

onKeyLongPress in interface android.view.KeyEvent.Callback

Overrides:

onKeyLongPress in class android.view.View

onKeyUp

public boolean onKeyUp(int keyCode,
                       @NonNull
                       android.view.KeyEvent event)

Specified by:

onKeyUp in interface android.view.KeyEvent.Callback

Overrides:

onKeyUp in class android.view.View

onTrackballEvent

public boolean onTrackballEvent(@NonNull
                                android.view.MotionEvent event)

Overrides:

onTrackballEvent in class android.view.View

onGenericMotionEvent

public boolean onGenericMotionEvent(@NonNull
                                    android.view.MotionEvent event)

Overrides:

onGenericMotionEvent in class android.view.View

onLowMemory

@UiThread
public void onLowMemory()

You must call this method from the parent's Activity#onLowMemory() or Fragment#onLowMemory().

setStyleUrl

public void setStyleUrl(@NonNull
                        java.lang.String url)

Loads a new map style from the specified URL.

url can take the following forms:

• Style.*: load one of the bundled styles
• http://... or https://...: retrieves the style over the Internet from any web server.
• asset://...: reads the style from the APK assets/ directory. This is used to load a style bundled with your app.
• null: loads the default Style.DINGI_ENGLISH style.

This method is asynchronous and will return immediately before the style finishes loading. If you wish to wait for the map to finish loading listen to MapView.OnDidFinishLoadingStyleListener callback.

If the style fails to load or an invalid style URL is set, the map view will become blank. An error message will be logged in the Android logcat and provided to the MapView.OnDidFailLoadingMapListener callback.

Parameters:

url - The URL of the map style

See Also:

Style

setOfflineRegionDefinition

public void setOfflineRegionDefinition(@NonNull
                                       OfflineRegionDefinition definition)

Loads a new style from the specified offline region definition and moves the map camera to that region.

Parameters:

definition - the offline region definition

See Also:

OfflineRegionDefinition

onSizeChanged

protected void onSizeChanged(int width,
                             int height,
                             int oldw,
                             int oldh)

Overrides:

onSizeChanged in class android.view.View

getViewContent

@Nullable
public android.graphics.Bitmap getViewContent()

Specified by:

getViewContent in interface com.dingi.dingisdk.maps.NativeMapView.ViewCallback

addOnCameraWillChangeListener

public void addOnCameraWillChangeListener(MapView.OnCameraWillChangeListener listener)

Set a callback that's invoked when the camera region will change.

Parameters:

listener - The callback that's invoked when the camera region will change

removeOnCameraWillChangeListener

public void removeOnCameraWillChangeListener(MapView.OnCameraWillChangeListener listener)

Remove a callback that's invoked when the camera region will change.

Parameters:

listener - The callback that's invoked when the camera region will change

addOnCameraIsChangingListener

public void addOnCameraIsChangingListener(MapView.OnCameraIsChangingListener listener)

Set a callback that's invoked when the camera is changing.

Parameters:

listener - The callback that's invoked when the camera is changing

removeOnCameraIsChangingListener

public void removeOnCameraIsChangingListener(MapView.OnCameraIsChangingListener listener)

Remove a callback that's invoked when the camera is changing.

Parameters:

listener - The callback that's invoked when the camera is changing

addOnCameraDidChangeListener

public void addOnCameraDidChangeListener(MapView.OnCameraDidChangeListener listener)

Set a callback that's invoked when the camera region did change.

Parameters:

listener - The callback that's invoked when the camera region did change

removeOnCameraDidChangeListener

public void removeOnCameraDidChangeListener(MapView.OnCameraDidChangeListener listener)

Set a callback that's invoked when the camera region did change.

Parameters:

listener - The callback that's invoked when the camera region did change

addOnWillStartLoadingMapListener

public void addOnWillStartLoadingMapListener(MapView.OnWillStartLoadingMapListener listener)

Set a callback that's invoked when the map will start loading.

Parameters:

listener - The callback that's invoked when the map will start loading

removeOnWillStartLoadingMapListener

public void removeOnWillStartLoadingMapListener(MapView.OnWillStartLoadingMapListener listener)

Set a callback that's invoked when the map will start loading.

Parameters:

listener - The callback that's invoked when the map will start loading

addOnDidFinishLoadingMapListener

public void addOnDidFinishLoadingMapListener(MapView.OnDidFinishLoadingMapListener listener)

Set a callback that's invoked when the map has finished loading.

Parameters:

listener - The callback that's invoked when the map has finished loading

removeOnDidFinishLoadingMapListener

public void removeOnDidFinishLoadingMapListener(MapView.OnDidFinishLoadingMapListener listener)

Set a callback that's invoked when the map has finished loading.

Parameters:

listener - The callback that's invoked when the map has finished loading

addOnDidFailLoadingMapListener

public void addOnDidFailLoadingMapListener(MapView.OnDidFailLoadingMapListener listener)

Set a callback that's invoked when the map failed to load.

Parameters:

listener - The callback that's invoked when the map failed to load

removeOnDidFailLoadingMapListener

public void removeOnDidFailLoadingMapListener(MapView.OnDidFailLoadingMapListener listener)

Set a callback that's invoked when the map failed to load.

Parameters:

listener - The callback that's invoked when the map failed to load

addOnWillStartRenderingFrameListener

public void addOnWillStartRenderingFrameListener(MapView.OnWillStartRenderingFrameListener listener)

Set a callback that's invoked when the map will start rendering a frame.

Parameters:

listener - The callback that's invoked when the camera will start rendering a frame

removeOnWillStartRenderingFrameListener

public void removeOnWillStartRenderingFrameListener(MapView.OnWillStartRenderingFrameListener listener)

Set a callback that's invoked when the map will start rendering a frame.

Parameters:

listener - The callback that's invoked when the camera will start rendering a frame

addOnDidFinishRenderingFrameListener

public void addOnDidFinishRenderingFrameListener(MapView.OnDidFinishRenderingFrameListener listener)

Set a callback that's invoked when the map has finished rendering a frame.

Parameters:

listener - The callback that's invoked when the map has finished rendering a frame

removeOnDidFinishRenderingFrameListener

public void removeOnDidFinishRenderingFrameListener(MapView.OnDidFinishRenderingFrameListener listener)

Set a callback that's invoked when the map has finished rendering a frame.

Parameters:

listener - The callback that's invoked when the map has finished rendering a frame

addOnWillStartRenderingMapListener

public void addOnWillStartRenderingMapListener(MapView.OnWillStartRenderingMapListener listener)

Set a callback that's invoked when the map will start rendering.

Parameters:

listener - The callback that's invoked when the map will start rendering

removeOnWillStartRenderingMapListener

public void removeOnWillStartRenderingMapListener(MapView.OnWillStartRenderingMapListener listener)

Set a callback that's invoked when the map will start rendering.

Parameters:

listener - The callback that's invoked when the map will start rendering

addOnDidFinishRenderingMapListener

public void addOnDidFinishRenderingMapListener(MapView.OnDidFinishRenderingMapListener listener)

Set a callback that's invoked when the map has finished rendering.

Parameters:

listener - The callback that's invoked when the map has finished rendering

removeOnDidFinishRenderingMapListener

public void removeOnDidFinishRenderingMapListener(MapView.OnDidFinishRenderingMapListener listener)

Remove a callback that's invoked when the map has finished rendering.

Parameters:

listener - The callback that's invoked when the map has finished rendering

addOnDidFinishLoadingStyleListener

public void addOnDidFinishLoadingStyleListener(MapView.OnDidFinishLoadingStyleListener listener)

Set a callback that's invoked when the style has finished loading.

Parameters:

listener - The callback that's invoked when the style has finished loading

removeOnDidFinishLoadingStyleListener

public void removeOnDidFinishLoadingStyleListener(MapView.OnDidFinishLoadingStyleListener listener)

Set a callback that's invoked when the style has finished loading.

Parameters:

listener - The callback that's invoked when the style has finished loading

addOnSourceChangedListener

public void addOnSourceChangedListener(MapView.OnSourceChangedListener listener)

Set a callback that's invoked when a map source has changed.

Parameters:

listener - The callback that's invoked when the source has changed

removeOnSourceChangedListener

public void removeOnSourceChangedListener(MapView.OnSourceChangedListener listener)

Set a callback that's invoked when a map source has changed.

Parameters:

listener - The callback that's invoked when the source has changed

getMapAsync

@UiThread
public void getMapAsync(@NonNull
                                  OnMapReadyCallback callback)

Sets a callback object which will be triggered when the DingiMap instance is ready to be used.

Parameters:

callback - The callback object that will be triggered when the map is ready to be used.

setMapStrictModeEnabled

public static void setMapStrictModeEnabled(boolean strictModeEnabled)

Sets the strict mode that will throw the MapStrictModeException whenever the map would fail silently otherwise.

Parameters:

strictModeEnabled - true to enable the strict mode, false otherwise