HERE Android SDK Developer's Guide

DownViewParams

The class DownViewParams is a member of com.here.android.mpa.ar.ARController.

Class Summary

public final class ARController.DownViewParams

extends java.lang.Object

Encapsulates parameters which affect the Down view.

[For complete information, see the section Class Details]

Method Summary

Table 1. Methods in DownViewParams
Methods

public AnimationInterpolator getCenterInterpolator ()

Get auto TFC interpolation algorithm.

public long getFadeInAnimationDelay ()

Get delay of Down view fade-in animation.

public long getFadeInAnimationTime ()

Get duration of Down view fade-in animation.

public AnimationInterpolator getFadeInInterpolator ()

Get the interpolator for Down view fade-in animation.

public long getFadeOutAnimationDelay ()

Get delay of Down view fade-out animation.

public long getFadeOutAnimationTime ()

Get duration of Down view fade-out animation.

public AnimationInterpolator getFadeOutInterpolator ()

Get the interpolator for Down view fade-out animation.

public AnimationInterpolator getGeoCenterInterpolator ()

Get auto GPS interpolation algorithm.

public AnimationInterpolator getHeadingInterpolator ()

Get auto heading interpolation algorithm.

public float getMaxAlpha ()

Get maximum alpha value for DOWN view.

public float getMaxZoomOutScale ()

Get max zoom out level for Down view.

public float getMinAlpha ()

Get minimum alpha value for DOWN view.

public float getMinPitch ()

Get minimum Down view pitch.

public AnimationInterpolator getPitchInterpolator ()

Get auto pitch interpolation algorithm.

public float getPitchThreshold ()

Get pitch threshold when Up view transitions to Down view

public AnimationInterpolator getZoomInterpolator ()

Get auto zoom interpolation algorithm.

public boolean isAutoGeoCenterEnabled ()

Get Down view auto geo center setting.

public boolean isAutoHeadingEnabled ()

Get Down view auto heading setting.

public boolean isAutoPitchEnabled ()

Get Down view auto pitch setting.

public boolean isAutoTFCEnabled ()

Get Down view auto tfc setting.

public boolean isAutoZoomEnabled ()

Get Down view auto zoom setting.

public DownViewParams setAutoControlOnEntryExit (boolean enabled)

Enable/disable map auto control during Entry and Exit animations.

public DownViewParams setAutoGeoCenterEnabled (boolean enabled, boolean animate)

Enable/disable auto geo center control.

public DownViewParams setAutoHeadingEnabled (boolean enabled, boolean animate)

Enable/disable auto heading control.

public DownViewParams setAutoPitchEnabled (boolean enabled, boolean animate)

Enable/disable auto pitch control.

public DownViewParams setAutoTFCEnabled (boolean enabled, boolean animate)

Enable/disable auto transform center control.

public DownViewParams setAutoZoomEnabled (boolean enabled, boolean animate)

Enable/disable auto zoom control.

public DownViewParams setCenterInterpolator (AnimationInterpolator value)

Set auto TFC interpolation algorithm.

public DownViewParams setFadeInAnimationDelay (long value)

Set Down view fade-in animation delay.

public DownViewParams setFadeInAnimationTime (long value)

Set Down view fade-in animation duration.

public DownViewParams setFadeInInterpolator (AnimationInterpolator value)

Set the interpolator for Down view fade-in animation.

public DownViewParams setFadeOutAnimationDelay (long value)

Set Down view fade-out animation delay.

public DownViewParams setFadeOutAnimationTime (long value)

Set Down view fade-out animation duration.

public DownViewParams setFadeOutInterpolator (AnimationInterpolator value)

Set the interpolator for Down view fade-out animation.

public DownViewParams setGeoCenterInterpolator (AnimationInterpolator value)

Set auto GPS interpolation algorithm.

public DownViewParams setHeadingInterpolator (AnimationInterpolator value)

Set auto heading interpolation algorithm

public DownViewParams setMaxAlpha (float value)

Set maximum alpha value for DOWN view.

public DownViewParams setMaxZoomOutScale (float value, boolean animate, boolean pitchCorrection)

Set max zoom out level for Down view.

public DownViewParams setMinAlpha (float value)

Set minimum alpha value for DOWN view.

public DownViewParams setMinPitch (float value)

Sets minimum Down view pitch.

public DownViewParams setPitchInterpolator (AnimationInterpolator value)

Set auto pitch interpolation algorithm

public DownViewParams setPitchThreshold (float value)

Set Pitch threshold when Up view transitions to Down view

public DownViewParams setTransformCenter (PointF center, boolean animate)

Set down view transform center in the livesight.

public DownViewParams setZoomInterpolator (AnimationInterpolator value)

Set auto zoom interpolation algorithm.

Class Details

Encapsulates parameters which affect the Down view.

Method Details

public AnimationInterpolator getCenterInterpolator ()

Get auto TFC interpolation algorithm.

Returns:

auto TFC interpolation algorithm enumerator.

public long getFadeInAnimationDelay ()

Get delay of Down view fade-in animation.

Returns:

delay of Down view fade-in animation in ms.

public long getFadeInAnimationTime ()

Get duration of Down view fade-in animation.

Returns:

duration of Down view fade-in animation in ms.

public AnimationInterpolator getFadeInInterpolator ()

Get the interpolator for Down view fade-in animation.

Returns:

The AnimationInterpolator for Down view fade-in animation

public long getFadeOutAnimationDelay ()

Get delay of Down view fade-out animation.

Returns:

delay of Down view fade-out animation in ms.

public long getFadeOutAnimationTime ()

Get duration of Down view fade-out animation.

Returns:

duration of Down view fade-out animation in ms.

public AnimationInterpolator getFadeOutInterpolator ()

Get the interpolator for Down view fade-out animation.

Returns:

The AnimationInterpolator for Down view fade-out animation

public AnimationInterpolator getGeoCenterInterpolator ()

Get auto GPS interpolation algorithm.

Returns:

auto GPS interpolation algorithm enumerator.

public AnimationInterpolator getHeadingInterpolator ()

Get auto heading interpolation algorithm.

Returns:

auto heading interpolation algorithm enumerator.

public float getMaxAlpha ()

Get maximum alpha value for DOWN view. Range 0..1f.

Returns:

max alpha channel value of DOWN view.

public float getMaxZoomOutScale ()

Get max zoom out level for Down view. Zoom value in down view changes dynamically as a function of pitch. Full zoom range is from 0(most farthest) to 1.0(most closest).

Returns:

max zoom out level

public float getMinAlpha ()

Get minimum alpha value for DOWN view. Range 0..1f.

Returns:

min alpha channel value of DOWN view

public float getMinPitch ()

Get minimum Down view pitch. Default value is com.here.android.mpa.mapping.Map Map's min pitch.

Returns:

minimum map pitch.

See also:

setTilt(float, Animation)

getMinTilt()

getMaxTilt()

public AnimationInterpolator getPitchInterpolator ()

Get auto pitch interpolation algorithm.

Returns:

auto pitch interpolation algorithm enumerator.

public float getPitchThreshold ()

Get pitch threshold when Up view transitions to Down view

Returns:

pitch value which triggers transition from Up view to Down view

public AnimationInterpolator getZoomInterpolator ()

Get auto zoom interpolation algorithm.

Returns:

auto zoom interpolation algorithm enumerator.

public boolean isAutoGeoCenterEnabled ()

Get Down view auto geo center setting.

Returns:

Auto geo center setting

public boolean isAutoHeadingEnabled ()

Get Down view auto heading setting.

Returns:

Auto heading setting

public boolean isAutoPitchEnabled ()

Get Down view auto pitch setting.

Returns:

Auto pitch setting

public boolean isAutoTFCEnabled ()

Get Down view auto tfc setting.

Returns:

Auto tfc setting

public boolean isAutoZoomEnabled ()

Get Down view auto zoom setting.

Returns:

Auto zoom setting

public DownViewParams setAutoControlOnEntryExit (boolean enabled)

Enable/disable map auto control during Entry and Exit animations. If certain map parameters such as auto pitch, auto heading are disabled, they are treated enabled during Entry and Exit animations only.

Parameters:

  • enabled

    If true, map auto control is enabled during Entry and Exit animations.

Returns:

The updated DownViewParams object itself

public DownViewParams setAutoGeoCenterEnabled (boolean enabled, boolean animate)

Enable/disable auto geo center control. When enabled, ARController sets geo center automatically

Parameters:

  • enabled

    If true, geo center is set automatically

  • animate

    If true, start animation from current value to the calculated by liveisght

Returns:

The updated DownViewParams object itself

public DownViewParams setAutoHeadingEnabled (boolean enabled, boolean animate)

Enable/disable auto heading control. When enabled, ARController adjusts the heading automatically

Parameters:

  • enabled

    If true, heading is adjusted automatically

  • animate

    If true, start animation from current value to the calculated by liveisght

Returns:

The updated DownViewParams object itself

public DownViewParams setAutoPitchEnabled (boolean enabled, boolean animate)

Enable/disable auto pitch control. When enabled, ARController adjusts the pitch automatically

Parameters:

  • enabled

    If true, pitch is adjusted automatically

  • animate

    If true, start animation from current value to the calculated by liveisght

Returns:

The updated DownViewParams object itself

public DownViewParams setAutoTFCEnabled (boolean enabled, boolean animate)

Enable/disable auto transform center control. When enabled, ARController adjusts the transform center automatically

Parameters:

  • enabled

    If true, transform center is adjusted automatically

  • animate

    If true, start animation from current value to the calculated by liveisght

Returns:

The updated DownViewParams object itself

public DownViewParams setAutoZoomEnabled (boolean enabled, boolean animate)

Enable/disable auto zoom control. When enabled, ARController adjusts the zoom level automatically

Parameters:

  • enabled

    If true, zoom is adjusted automatically

  • animate

    If true, start animation from current value to the calculated by liveisght

Returns:

The updated DownViewParams object itself

public DownViewParams setCenterInterpolator (AnimationInterpolator value)

Set auto TFC interpolation algorithm.

Parameters:

  • value

    auto TFC interpolation algorithm.

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeInAnimationDelay (long value)

Set Down view fade-in animation delay.

Parameters:

  • value

    Down view fade-in animation delay in ms

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeInAnimationTime (long value)

Set Down view fade-in animation duration.

Parameters:

  • value

    Down view fade-in animation duration in ms

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeInInterpolator (AnimationInterpolator value)

Set the interpolator for Down view fade-in animation.

Parameters:

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeOutAnimationDelay (long value)

Set Down view fade-out animation delay.

Parameters:

  • value

    Down view fade-out animation delay in ms

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeOutAnimationTime (long value)

Set Down view fade-out animation duration.

Parameters:

  • value

    Down view fade-out animation duration in ms

Returns:

The updated DownViewParams object itself

public DownViewParams setFadeOutInterpolator (AnimationInterpolator value)

Set the interpolator for Down view fade-out animation.

Parameters:

Returns:

The updated DownViewParams object itself

public DownViewParams setGeoCenterInterpolator (AnimationInterpolator value)

Set auto GPS interpolation algorithm.

Parameters:

  • value

    auto GPS interpolation algorithm.

Returns:

The updated DownViewParams object itself

public DownViewParams setHeadingInterpolator (AnimationInterpolator value)

Set auto heading interpolation algorithm

Parameters:

  • value

    auto heading interpolation algorithm.

Returns:

The updated DownViewParams object itself

public DownViewParams setMaxAlpha (float value)

Set maximum alpha value for DOWN view. Range 0..1f.

Parameters:

  • value

    The DOWN view alpha channel.

Returns:

The updated DownViewParams object itself

public DownViewParams setMaxZoomOutScale (float value, boolean animate, boolean pitchCorrection)

Set max zoom out level for Down view. Zoom value in down view changes dynamically as a function of pitch. Full map's zoom scale range is from 0(most zoomed out) to 1.0(most zoomed in). Example: Setting value of 0.8 would limit livesight zoom to 0.8(most zoomed out) to 1.0(most zoomed in).

Parameters:

  • value

    max zoom out level.

  • animate

    true to animate change from previous value to new one.

  • pitchCorrection

    true to consider current pitch when zoom scale was applied. The final max zoom out value will be equal or greater then specified.

Returns:

The updated DownViewParams object itself

public DownViewParams setMinAlpha (float value)

Set minimum alpha value for DOWN view. Range 0..1f.

Parameters:

  • value

    The DOWN view alpha channel

Returns:

The updated DownViewParams object itself

public DownViewParams setMinPitch (float value)

Sets minimum Down view pitch. Value's range should be [min map tilt, max map tilt]. com.here.android.mpa.mapping.Map Map.

Parameters:

  • value

    minimum map pitch.

Returns:

The updated DownViewParams object itself

See also:

setTilt(float, Animation)

getMinTilt()

getMaxTilt()

public DownViewParams setPitchInterpolator (AnimationInterpolator value)

Set auto pitch interpolation algorithm

Parameters:

  • value

    auto pitch interpolation algorithm.

Returns:

The updated DownViewParams object itself

public DownViewParams setPitchThreshold (float value)

Set Pitch threshold when Up view transitions to Down view

Parameters:

  • value

    Pitch value ranges from 0...180

Returns:

The updated DownViewParams object itself

public DownViewParams setTransformCenter (PointF center, boolean animate)

Set down view transform center in the livesight. By default map transform center and first person view are coincide. The API enables separation of these points and creating "fly around" effect, where viewer is "flying around" specified map transform center.

Parameters:

  • center

    Normalized screen coordinates. Example {0.5, 1} corresponds to {width/2, height}

  • animate

    A flag to enable/disable animation from current view point to new one.

Returns:

The updated DownViewParams object itself

public DownViewParams setZoomInterpolator (AnimationInterpolator value)

Set auto zoom interpolation algorithm.

Parameters:

  • value

    auto zoom interpolation algorithm.

Returns:

The updated DownViewParams object itself

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.