com.mapbox.mapboxsdk.annotations

Class MarkerViewManager

java.lang.Object

com.mapbox.mapboxsdk.annotations.MarkerViewManager

public class MarkerViewManager
extends java.lang.Object

Interface for interacting with ViewMarkers objects inside of a MapView.

This class is responsible for managing a MarkerView item.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MarkerViewManager.ImageMarkerViewAdapter Default MarkerViewAdapter used for base class of MarkerView to adapt a MarkerView to an ImageView

Constructor Summary

Constructors

Constructor and Description
MarkerViewManager(MapboxMap mapboxMap, MapView mapView) Creates an instance of MarkerViewManager.

Method Summary

Modifier and Type	Method and Description
void	addMarkerViewAdapter(MapboxMap.MarkerViewAdapter markerViewAdapter) Add a MarkerViewAdapter to the MarkerViewManager.
void	animateAlpha(MarkerView marker, float alpha) Animate a MarkerView to a given alpha value.
void	animateRotation(MarkerView marker, float rotation) Animate a MarkerView to a given rotation.
void	animateVisible(MarkerView marker, boolean visible) Animate a MarkerVIew to be visible or invisible
void	deselect(MarkerView marker) Animate a MarkerView to a deselected state.
void	ensureInfoWindowOffset(MarkerView marker)
java.util.List<MapboxMap.MarkerViewAdapter>	getMarkerViewAdapters() Get all MarkerViewAdapters associated with this MarkerViewManager.
android.view.View	getView(MarkerView marker) Get view representation from a MarkerView.
void	invalidateViewMarkersInBounds() Invalidate the ViewMarkers found in the viewport.
void	removeMarkerView(MarkerView marker) Remove a MarkerView from a map.
void	scheduleViewMarkerInvalidation() Schedule that ViewMarkers found in the viewport are invalidated.
void	select(MarkerView marker) Animate a MarkerView to a selected state.
void	select(MarkerView marker, android.view.View convertView, MapboxMap.MarkerViewAdapter adapter) Animate a MarkerView to a selected state.
void	setOnMarkerViewClickListener(MapboxMap.OnMarkerViewClickListener listener) Register a callback to be invoked when this view is clicked.
void	setTilt(float tilt) Set tilt on every non flat MarkerView currently shown in the Viewport.
void	update() Updates the position of MarkerViews currently found in the viewport.
void	updateIcon(MarkerView markerView)

Methods inherited from class java.lang.Object

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

Constructor Detail

MarkerViewManager

public MarkerViewManager(MapboxMap mapboxMap,
                         MapView mapView)

Creates an instance of MarkerViewManager.

Parameters:

mapboxMap - the MapboxMap associated with the MarkerViewManager

mapView - the MapView associated with the MarkerViewManager

Method Detail

animateRotation

public void animateRotation(MarkerView marker,
                            float rotation)

Animate a MarkerView to a given rotation.

The MarkerView will be rotated from its current rotation to the given rotation.

Parameters:

marker - the MarkerView to rotate

rotation - the rotation value

animateAlpha

public void animateAlpha(MarkerView marker,
                         float alpha)

Animate a MarkerView to a given alpha value.

The MarkerView will be transformed from its current alpha value to the given value.

Parameters:

marker - the MarkerView to change its alpha value

alpha - the alpha value

animateVisible

public void animateVisible(MarkerView marker,
                           boolean visible)

Animate a MarkerVIew to be visible or invisible

The MarkerView will be made View.VISIBLE or View.GONE.

Parameters:

marker - the MarkerView to change its visibility

visible - the flag indicating if MarkerView is visible

update

public void update()

Updates the position of MarkerViews currently found in the viewport.

The collection of MarkerView will be iterated and each item position will be updated. If an item is View state is not visible and its related flag is set to visible, The MarkerView will be animated to visible using alpha animation.

setTilt

public void setTilt(float tilt)

Set tilt on every non flat MarkerView currently shown in the Viewport.

Parameters:

tilt - the tilt value

updateIcon

public void updateIcon(MarkerView markerView)

deselect

public void deselect(MarkerView marker)

Animate a MarkerView to a deselected state.

The MapboxMap.MarkerViewAdapter.onDeselect(MarkerView, View) will be called to execute an animation.

Parameters:

marker - the MarkerView to deselect

select

public void select(MarkerView marker)

Animate a MarkerView to a selected state.

Parameters:

marker - the MarkerView object to select

select

public void select(MarkerView marker,
                   android.view.View convertView,
                   MapboxMap.MarkerViewAdapter adapter)

Animate a MarkerView to a selected state.

The MapboxMap.MarkerViewAdapter.onSelect(MarkerView, View, boolean) will be called to execute an animation.

Parameters:

marker - the MarkerView object to select

convertView - the View presentation of the MarkerView

adapter - the adapter used to adapt the marker to the convertView

getView

public android.view.View getView(MarkerView marker)

Get view representation from a MarkerView.

If marker is not found in current viewport, null is returned.

Parameters:

marker - the marker to get the view for

Returns:

the android SDK View object

removeMarkerView

public void removeMarkerView(MarkerView marker)

Remove a MarkerView from a map.

The MarkerView will be removed using an alpha animation and related View will be released to the android.support.v4.util.Pools.SimplePool from the related MapboxMap.MarkerViewAdapter. It's possible to remove the MarkerView from the underlying collection if needed.

Parameters:

marker - the MarkerView to remove

addMarkerViewAdapter

public void addMarkerViewAdapter(MapboxMap.MarkerViewAdapter markerViewAdapter)

Add a MarkerViewAdapter to the MarkerViewManager.

The provided MarkerViewAdapter must use supply a generic subclass of MarkerView.

Parameters:

markerViewAdapter - the MarkerViewAdapter to add

getMarkerViewAdapters

public java.util.List<MapboxMap.MarkerViewAdapter> getMarkerViewAdapters()

Get all MarkerViewAdapters associated with this MarkerViewManager.

Returns:

a List of MarkerViewAdapters

setOnMarkerViewClickListener

public void setOnMarkerViewClickListener(MapboxMap.OnMarkerViewClickListener listener)

Register a callback to be invoked when this view is clicked.

Parameters:

listener - the callback to be invoked

scheduleViewMarkerInvalidation

public void scheduleViewMarkerInvalidation()

Schedule that ViewMarkers found in the viewport are invalidated.

This method is rate limited, and invalidateViewMarkersInBounds() will only be called once each 250 ms.

invalidateViewMarkersInBounds

public void invalidateViewMarkersInBounds()

Invalidate the ViewMarkers found in the viewport.

This method will remove any markers that aren't in the viewport any more and will add new ones for each found Marker in the changed viewport.

ensureInfoWindowOffset

public void ensureInfoWindowOffset(MarkerView marker)