com.dingi.dingisdk.location

Class LocationComponentOptions

java.lang.Object

com.dingi.dingisdk.location.LocationComponentOptions

All Implemented Interfaces:

android.os.Parcelable

public class LocationComponentOptions
extends java.lang.Object
implements android.os.Parcelable

This class exposes options for the Location Component. The options can be set by defining a style in your apps style.xml file and passing in directly into the LocationComponent class. Alternatively, if properties need to be changed at runtime depending on a specific state, you can build an instance of this class, setting the values you desire, and then passing it into either the LocationComponent activation method (if it isn't initialized yet) or LocationComponent.applyStyle(LocationComponentOptions).

When the createFromAttributes(Context, int) methods called, any attributes not found inside the style will revert back to using their default set values. Likewise, when building a new LocationComponentOptions class using the builder, any options neglecting to be set will reset to their default values.

If you would like to keep your custom style changes while modifying a single attribute, you can get the currently used options object using LocationComponent.getLocationComponentOptions() and it's toBuilder method to modify a single entry while also maintaining the other settings. Once your modifications have been made, you'll need to pass it back into the location component using LocationComponent.applyStyle(LocationComponentOptions).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocationComponentOptions.Builder Builder class for constructing a new instance of LocationComponentOptions.

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Field Summary

Fields

Modifier and Type	Field and Description
static android.os.Parcelable.Creator<LocationComponentOptions>	CREATOR

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Constructor and Description

LocationComponentOptions(float accuracyAlpha, int accuracyColor, int backgroundDrawableStale, java.lang.String backgroundStaleName, int foregroundDrawableStale, java.lang.String foregroundStaleName, int gpsDrawable, java.lang.String gpsName, int foregroundDrawable, java.lang.String foregroundName, int backgroundDrawable, java.lang.String backgroundName, int bearingDrawable, java.lang.String bearingName, java.lang.Integer bearingTintColor, java.lang.Integer foregroundTintColor, java.lang.Integer backgroundTintColor, java.lang.Integer foregroundStaleTintColor, java.lang.Integer backgroundStaleTintColor, float elevation, boolean enableStaleState, long staleStateTimeout, int[] padding, double maxZoom, double minZoom, float maxZoomIconScale, float minZoomIconScale, boolean trackingGesturesManagement, float trackingInitialMoveThreshold, float trackingMultiFingerMoveThreshold, java.lang.String layerBelow, float trackingAnimationDurationMultiplier)

Method Summary

Modifier and Type	Method and Description
float	accuracyAlpha() Set the opacity of the accuracy view to a value from 0 to 1, where 0 means the accuracy view is completely transparent and 1 means the view is completely opaque.
int	accuracyColor() Solid color to use as the accuracy view color property.
int	backgroundDrawable() Defines the drawable used for the background state icon.
int	backgroundDrawableStale() Defines the drawable used for the stale background icon.
java.lang.String	backgroundName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_backgroundDrawable.
java.lang.String	backgroundStaleName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will use this image in place of the provided or default dingi_foregroundDrawableStale.
java.lang.Integer	backgroundStaleTintColor() Defines the background stale color as an integer.
java.lang.Integer	backgroundTintColor() Defines the background color as an integer.
int	bearingDrawable() Defines the drawable used for the bearing icon.
java.lang.String	bearingName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_bearingDrawable.
java.lang.Integer	bearingTintColor() Defines the bearing icon color as an integer.
static LocationComponentOptions.Builder	builder(android.content.Context context) Build a new instance of the LocationComponentOptions class with all the attributes set automatically to their defined defaults in this library.
static LocationComponentOptions	createFromAttributes(android.content.Context context, int styleRes) Construct a new Location Component Options class using the attributes found within a style resource.
int	describeContents()
float	elevation() Sets the base elevation of this view, in pixels.
boolean	enableStaleState() Enable or disable to stale state mode.
boolean	equals(java.lang.Object o)
int	foregroundDrawable() Supply a Drawable that is to be rendered on top of all of the content in the Location LayerComponent layer stack.
int	foregroundDrawableStale() Defines the drawable used for the stale foreground icon.
java.lang.String	foregroundName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_foregroundDrawable.
java.lang.String	foregroundStaleName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_foregroundDrawableStale.
java.lang.Integer	foregroundStaleTintColor() Defines the foreground stale color as an integer.
java.lang.Integer	foregroundTintColor() Defines the foreground color as an integer.
int	gpsDrawable() Defines the drawable used for the navigation state icon.
java.lang.String	gpsName() String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_gpsDrawable.
int	hashCode()
java.lang.String	layerBelow() Gets the id of the layer to add the location component above to.
double	maxZoom() The maximum zoom level the map can be displayed at.
float	maxZoomIconScale() The scale factor of the location icon when the map is zoomed in.
double	minZoom() The minimum zoom level the map can be displayed at.
float	minZoomIconScale() The scale factor of the location icon when the map is zoomed out.
int[]	padding() Sets the distance from the edges of the map view’s frame to the edges of the map view’s logical viewport.
long	staleStateTimeout() Set the delay before the location icon becomes stale.
LocationComponentOptions.Builder	toBuilder() Takes the currently constructed LocationComponentOptions object and provides it's builder with all the values set matching the values in this instance.
java.lang.String	toString()
float	trackingAnimationDurationMultiplier() Get the tracking animation duration multiplier.
boolean	trackingGesturesManagement() Returns whether gesture threshold should be adjusted when camera is in one of the tracking modes.
float	trackingInitialMoveThreshold() Minimum single pointer movement in pixels required to break camera tracking.
float	trackingMultiFingerMoveThreshold() Minimum multi pointer movement in pixels required to break camera tracking (for example during scale gesture).
void	writeToParcel(android.os.Parcel dest, int flags)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

CREATOR

public static final android.os.Parcelable.Creator<LocationComponentOptions> CREATOR

Constructor Detail

LocationComponentOptions

public LocationComponentOptions(float accuracyAlpha,
                                int accuracyColor,
                                int backgroundDrawableStale,
                                @Nullable
                                java.lang.String backgroundStaleName,
                                int foregroundDrawableStale,
                                @Nullable
                                java.lang.String foregroundStaleName,
                                int gpsDrawable,
                                @Nullable
                                java.lang.String gpsName,
                                int foregroundDrawable,
                                @Nullable
                                java.lang.String foregroundName,
                                int backgroundDrawable,
                                @Nullable
                                java.lang.String backgroundName,
                                int bearingDrawable,
                                @Nullable
                                java.lang.String bearingName,
                                @Nullable
                                java.lang.Integer bearingTintColor,
                                @Nullable
                                java.lang.Integer foregroundTintColor,
                                @Nullable
                                java.lang.Integer backgroundTintColor,
                                @Nullable
                                java.lang.Integer foregroundStaleTintColor,
                                @Nullable
                                java.lang.Integer backgroundStaleTintColor,
                                float elevation,
                                boolean enableStaleState,
                                long staleStateTimeout,
                                @Nullable
                                int[] padding,
                                double maxZoom,
                                double minZoom,
                                float maxZoomIconScale,
                                float minZoomIconScale,
                                boolean trackingGesturesManagement,
                                float trackingInitialMoveThreshold,
                                float trackingMultiFingerMoveThreshold,
                                java.lang.String layerBelow,
                                float trackingAnimationDurationMultiplier)

Method Detail

createFromAttributes

@Nullable
public static LocationComponentOptions createFromAttributes(@NonNull
                                                                      android.content.Context context,
                                                                      @StyleRes
                                                                      int styleRes)

Construct a new Location Component Options class using the attributes found within a style resource. It's important to note that you only need to define the attributes you plan to change and can safely ignore the other attributes which will be set to their default value.

Parameters:

context - your activity's context used for acquiring resources

styleRes - the style id where your custom attributes are defined

Returns:

a new LocationComponentOptions object with the settings you defined in your style resource

toBuilder

@NonNull
public LocationComponentOptions.Builder toBuilder()

Takes the currently constructed LocationComponentOptions object and provides it's builder with all the values set matching the values in this instance. This allows you to modify a single attribute and then rebuild the object.

Returns:

the builder which contains the values defined in this current instance as defaults.

builder

@NonNull
public static LocationComponentOptions.Builder builder(@NonNull
                                                                android.content.Context context)

Build a new instance of the LocationComponentOptions class with all the attributes set automatically to their defined defaults in this library. This allows you to adjust a few attributes while leaving the rest alone and maintaining their default behavior.

Parameters:

context - your activities context used to acquire the style resource

Returns:

the builder which contains the default values defined by the style resource

accuracyAlpha

public float accuracyAlpha()

Set the opacity of the accuracy view to a value from 0 to 1, where 0 means the accuracy view is completely transparent and 1 means the view is completely opaque.

Returns:

the opacity of the accuracy view

accuracyColor

public int accuracyColor()

Solid color to use as the accuracy view color property.

Returns:

the color of the accuracy view

backgroundDrawableStale

@DrawableRes
public int backgroundDrawableStale()

Defines the drawable used for the stale background icon.

Returns:

the drawable resource ID

backgroundStaleName

@Nullable
public java.lang.String backgroundStaleName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will use this image in place of the provided or default dingi_foregroundDrawableStale.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

foregroundDrawableStale

@DrawableRes
public int foregroundDrawableStale()

Defines the drawable used for the stale foreground icon.

Returns:

the drawable resource ID

foregroundStaleName

@Nullable
public java.lang.String foregroundStaleName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_foregroundDrawableStale.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

gpsDrawable

@DrawableRes
public int gpsDrawable()

Defines the drawable used for the navigation state icon.

Returns:

the drawable resource ID

gpsName

@Nullable
public java.lang.String gpsName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_gpsDrawable.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

foregroundDrawable

@DrawableRes
public int foregroundDrawable()

Supply a Drawable that is to be rendered on top of all of the content in the Location LayerComponent layer stack.

Returns:

the drawable resource used for the foreground layer

foregroundName

@Nullable
public java.lang.String foregroundName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_foregroundDrawable.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

backgroundDrawable

@DrawableRes
public int backgroundDrawable()

Defines the drawable used for the background state icon.

Returns:

the drawable resource ID

backgroundName

@Nullable
public java.lang.String backgroundName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_backgroundDrawable.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

bearingDrawable

@DrawableRes
public int bearingDrawable()

Defines the drawable used for the bearing icon.

Returns:

the drawable resource ID

bearingName

@Nullable
public java.lang.String bearingName()

String image name, identical to one used in the first parameter of DingiMap.addImage(String, Bitmap), the component, will used this image in place of the provided or default dingi_bearingDrawable.

A maki-icon name (example: "circle-15") may also be provided. These are images that can be loaded with certain styles. Note, this will fail if the provided icon name is not provided by the loaded map style.

Returns:

String icon or maki-icon name

bearingTintColor

@Nullable
public java.lang.Integer bearingTintColor()

Defines the bearing icon color as an integer.

Returns:

the color integer resource

foregroundTintColor

@Nullable
public java.lang.Integer foregroundTintColor()

Defines the foreground color as an integer.

Returns:

the color integer resource

backgroundTintColor

@Nullable
public java.lang.Integer backgroundTintColor()

Defines the background color as an integer.

Returns:

the color integer resource

foregroundStaleTintColor

@Nullable
public java.lang.Integer foregroundStaleTintColor()

Defines the foreground stale color as an integer.

Returns:

the color integer resource

backgroundStaleTintColor

@Nullable
public java.lang.Integer backgroundStaleTintColor()

Defines the background stale color as an integer.

Returns:

the color integer resource

elevation

@Dimension
public float elevation()

Sets the base elevation of this view, in pixels.

Returns:

the elevation currently set for the location component icon

enableStaleState

public boolean enableStaleState()

Enable or disable to stale state mode. This mode indicates to the user that the location being displayed on the map hasn't been updated in a specific amount of time.

Returns:

whether the stale state mode is enabled or not

staleStateTimeout

public long staleStateTimeout()

Set the delay before the location icon becomes stale. The timer begins approximately when a new location update comes in and using this defined time, if an update hasn't occured by the end, the location is considered stale.

Returns:

the duration in milliseconds which it should take before the location is considered stale

padding

@Nullable
public int[] padding()

Sets the distance from the edges of the map view’s frame to the edges of the map view’s logical viewport.

When the value of this property is equal to {0,0,0,0}, viewport properties such as `centerCoordinate` assume a viewport that matches the map view’s frame. Otherwise, those properties are inset, excluding part of the frame from the viewport. For instance, if the only the top edge is inset, the map center is effectively shifted downward.

Returns:

integer array of padding values

maxZoom

public double maxZoom()

The maximum zoom level the map can be displayed at.

Returns:

the maximum zoom level

minZoom

public double minZoom()

The minimum zoom level the map can be displayed at.

Returns:

the minimum zoom level

maxZoomIconScale

public float maxZoomIconScale()

The scale factor of the location icon when the map is zoomed in. Based on maxZoom(). Scaling is linear.

Returns:

icon scale factor

minZoomIconScale

public float minZoomIconScale()

The scale factor of the location icon when the map is zoomed out. Based on minZoom(). Scaling is linear.

Returns:

icon scale factor

trackingGesturesManagement

public boolean trackingGesturesManagement()

Returns whether gesture threshold should be adjusted when camera is in one of the tracking modes. This will adjust the focal point and increase thresholds to enable camera manipulation, like zooming in and out, without breaking tracking.

Note: If set to true, this can overwrite some of the gesture thresholds and the custom AndroidGesturesManager that was set with DingiMap.setGesturesManager(AndroidGesturesManager, boolean, boolean).

Returns:

true if gestures are adjusted when in one of the camera tracking modes, false otherwise

See Also:

LocationComponentOptions.Builder.trackingInitialMoveThreshold(float), LocationComponentOptions.Builder.trackingMultiFingerMoveThreshold(float)

trackingInitialMoveThreshold

public float trackingInitialMoveThreshold()

Minimum single pointer movement in pixels required to break camera tracking.

Returns:

the minimum movement

trackingMultiFingerMoveThreshold

public float trackingMultiFingerMoveThreshold()

Minimum multi pointer movement in pixels required to break camera tracking (for example during scale gesture).

Returns:

the minimum movement

layerBelow

public java.lang.String layerBelow()

Gets the id of the layer to add the location component above to.

Returns:

layerBelow the id of the layer to add the location component above to

trackingAnimationDurationMultiplier

public float trackingAnimationDurationMultiplier()

Get the tracking animation duration multiplier.

Returns:

tracking animation duration multiplier

toString

@NonNull
public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

writeToParcel

public void writeToParcel(@NonNull
                          android.os.Parcel dest,
                          int flags)

Specified by:

writeToParcel in interface android.os.Parcelable

describeContents

public int describeContents()

Specified by:

describeContents in interface android.os.Parcelable