StreetViewPanoramaOptions

public final class StreetViewPanoramaOptions extends Object
implements Parcelable

Defines configuration PanoramaOptions for a StreetViewPanorama. These options can be used when adding a panorama to your application programmatically. If you are using a StreetViewPanoramaFragment, you can pass these options in using the static factory method newInstance(StreetViewPanoramaOptions). If you are using a StreetViewPanoramaView, you can pass these options in using the constructor StreetViewPanoramaView(Context, StreetViewPanoramaOptions).

Inherited Constant Summary

Public Constructor Summary

StreetViewPanoramaOptions()
Creates a new StreetViewPanoramaOptions object.

Public Method Summary

Boolean
String
LatLng
Integer
StreetViewSource
Boolean
StreetViewPanoramaCamera
Boolean
Boolean
Boolean
StreetViewPanoramaOptions
panningGesturesEnabled(boolean enabled)
Toggles the ability for users to use pan around on panoramas using gestures.
StreetViewPanoramaOptions
panoramaCamera(StreetViewPanoramaCamera camera)
Specifies the initial camera for the Street View panorama.
StreetViewPanoramaOptions
panoramaId(String panoId)
Specifies the initial position for the Street View panorama based on a panorama id.
StreetViewPanoramaOptions
position(LatLng position, Integer radius, StreetViewSource source)
Specifies the initial position for the Street View panorama based upon location, radius and source.
StreetViewPanoramaOptions
position(LatLng position, Integer radius)
Specifies the initial position for the Street View panorama based upon location and radius.
StreetViewPanoramaOptions
position(LatLng position)
Specifies the initial position for the Street View panorama based upon location.
StreetViewPanoramaOptions
position(LatLng position, StreetViewSource source)
Specifies the initial position for the Street View panorama based upon location and source.
StreetViewPanoramaOptions
streetNamesEnabled(boolean enabled)
Toggles the ability for users to see street names on panoramas.
String
StreetViewPanoramaOptions
useViewLifecycleInFragment(boolean useViewLifecycleInFragment)
When using a StreetViewPanoramaFragment, this flag specifies whether the lifecycle of the Street View panorama should be tied to the fragment's view or the fragment itself.
StreetViewPanoramaOptions
userNavigationEnabled(boolean enabled)
Toggles the ability for users to move between panoramas.
StreetViewPanoramaOptions
zoomGesturesEnabled(boolean enabled)
Toggles the ability for users to zoom on panoramas using gestures.

Inherited Method Summary

Public Constructors

public StreetViewPanoramaOptions ()

Creates a new StreetViewPanoramaOptions object.

Public Methods

public Boolean getPanningGesturesEnabled ()

Returns
  • true if users are initially able to pan via gestures on Street View panoramas

public String getPanoramaId ()

Returns
  • The initial panorama ID for the Street View panorama, or null if unspecified.

public LatLng getPosition ()

Returns
  • The initial position for the Street View panorama, or null if unspecified.

public Integer getRadius ()

Returns
  • The initial radius used to search for a Street View panorama, or null if unspecified.

public StreetViewSource getSource ()

Returns
  • The source filter used to search for a Street View panorama, or DEFAULT if unspecified.

public Boolean getStreetNamesEnabled ()

Returns
  • true if users are initially able to see street names on Street View panoramas

public StreetViewPanoramaCamera getStreetViewPanoramaCamera ()

Returns
  • The initial camera for the Street View panorama, or null if unspecified.

public Boolean getUseViewLifecycleInFragment ()

Returns
  • the useViewLifecycleInFragment option, or null if unspecified.

public Boolean getUserNavigationEnabled ()

Returns
  • true if users are initially able to move to different Street View panoramas

public Boolean getZoomGesturesEnabled ()

Returns
  • true if users are initially able to zoom via gestures on Street View panoramas

public StreetViewPanoramaOptions panningGesturesEnabled (boolean enabled)

Toggles the ability for users to use pan around on panoramas using gestures. See setPanningGesturesEnabled(boolean) for more details. The default is true

Parameters
enabled

public StreetViewPanoramaOptions panoramaCamera (StreetViewPanoramaCamera camera)

Specifies the initial camera for the Street View panorama.

Parameters
camera

public StreetViewPanoramaOptions panoramaId (String panoId)

Specifies the initial position for the Street View panorama based on a panorama id. The position set by the panoramaID takes precedence over a position set by a LatLng

Parameters
panoId

public StreetViewPanoramaOptions position (LatLng position, Integer radius, StreetViewSource source)

Specifies the initial position for the Street View panorama based upon location, radius and source. The position set by the panoramaID, if set, takes precedence over a position set by a LatLng

Parameters
position
radius
source

public StreetViewPanoramaOptions position (LatLng position, Integer radius)

Specifies the initial position for the Street View panorama based upon location and radius. The position set by the panoramaID, if set, takes precedence over a position set by a LatLng

Parameters
position
radius

public StreetViewPanoramaOptions position (LatLng position)

Specifies the initial position for the Street View panorama based upon location. The position set by the panoramaID, if set, takes precedence over a position set by a LatLng

Parameters
position

public StreetViewPanoramaOptions position (LatLng position, StreetViewSource source)

Specifies the initial position for the Street View panorama based upon location and source. The position set by the panoramaID, if set, takes precedence over a position set by a LatLng

Parameters
position
source

public StreetViewPanoramaOptions streetNamesEnabled (boolean enabled)

Toggles the ability for users to see street names on panoramas. See setStreetNamesEnabled(boolean) for more details. The default is true

Parameters
enabled

public String toString ()

public StreetViewPanoramaOptions useViewLifecycleInFragment (boolean useViewLifecycleInFragment)

When using a StreetViewPanoramaFragment, this flag specifies whether the lifecycle of the Street View panorama should be tied to the fragment's view or the fragment itself. The default value is false, tying the lifecycle of the Street View panorama to the fragment.

Using the lifecycle of the fragment allows faster rendering of the Street View panorama when the fragment is detached and reattached, because the underlying GL context is preserved. This has the cost that detaching the fragment, but not destroying it, will not release memory used by the panorama.

Using the lifecycle of a fragment's view means that a Street View panorama is not reused when the fragment is detached and reattached. This will cause the map to re-render from scratch, which can take a few seconds. It also means that while a fragment is detached, and therefore has no view, all StreetViewPanorama methods will throw NullPointerException.

Parameters
useViewLifecycleInFragment

public StreetViewPanoramaOptions userNavigationEnabled (boolean enabled)

Toggles the ability for users to move between panoramas. See setUserNavigationEnabled(boolean) for more details. The default is true

Parameters
enabled

public StreetViewPanoramaOptions zoomGesturesEnabled (boolean enabled)

Toggles the ability for users to zoom on panoramas using gestures. See setZoomGesturesEnabled(boolean) for more details. The default is true

Parameters
enabled