A StreetViewPanorama component in an app. This fragment is the simplest way to place a Street View panorama in an application. It's a wrapper around a view of a panorama to automatically handle the necessary life cycle needs. Being a fragment, this component can be added to an activity's layout file simply with the XML below.
<fragment class="com.google.android.gms.maps.SupportStreetViewPanoramaFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
StreetViewPanorama
must be acquired using
getStreetViewPanoramaAsync(OnStreetViewPanoramaReadyCallback)
. The SupportStreetViewPanoramaFragment
automatically initializes the Street View system and the view.
A view can be removed when the SupportStreetViewPanoramaFragment's
onDestroyView()
method is called and the
StreetViewPanoramaOptions.useViewLifecycleInFragment(boolean)
option is set. When
this happens the SupportStreetViewPanoramaFragment is no longer valid until the view is
recreated again later when MapFragment's
onCreateView(LayoutInflater, ViewGroup, Bundle)
method is called.
Any object obtained from the StreetViewPanorama
is associated with the view. It's important to not hold on to objects beyond the view's life.
Otherwise it will cause a memory leak as the view cannot be released.
Use this class only if you are targeting API 12 and above. Otherwise, use SupportStreetViewPanoramaFragment.
Note: The Google Maps Android SDK does not support multiple
SupportStreetViewPanoramaFragment
objects in one activity.
Inherited Field Summary
Public Constructor Summary
SupportStreetViewPanoramaFragment()
Creates a streetview panorama fragment.
|
Public Method Summary
void |
getStreetViewPanoramaAsync(OnStreetViewPanoramaReadyCallback
callback)
Sets a callback object which will be triggered when the
StreetViewPanorama
instance is ready to be used.
|
static SupportStreetViewPanoramaFragment |
newInstance()
Creates a streetview panorama fragment, using default options.
|
static SupportStreetViewPanoramaFragment |
newInstance(StreetViewPanoramaOptions
options)
Creates a streetview panorama fragment with the given options.
|
void |
onActivityCreated(Bundle
savedInstanceState)
|
void | |
void | |
View | |
void | |
void | |
void |
onInflate(Activity
activity, AttributeSet
attrs, Bundle
savedInstanceState)
Parse attributes during inflation from a view hierarchy into the arguments we
handle.
|
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
void |
onStop()
|
void |
setArguments(Bundle args)
|
Inherited Method Summary
Public Constructors
public SupportStreetViewPanoramaFragment ()
Creates a streetview panorama fragment. This constructor is public only for use by
an inflater. Use
newInstance()
to create a SupportStreetViewPanoramaFragment
programmatically.
Public Methods
public void getStreetViewPanoramaAsync (OnStreetViewPanoramaReadyCallback callback)
Sets a callback object which will be triggered when the StreetViewPanorama
instance is ready to be used.
Note that:
- In the case where Google Play services is not installed on the user's device, the callback will not be triggered until the user installs it.
- The callback will be executed in the main thread.
- The
StreetViewPanorama
object provided by the callback is non-null.
Parameters
callback | The callback object that will be triggered when the panorama is ready to be
used. Must not be null . |
---|
public static SupportStreetViewPanoramaFragment newInstance ()
Creates a streetview panorama fragment, using default options.
public static SupportStreetViewPanoramaFragment newInstance (StreetViewPanoramaOptions options)
Creates a streetview panorama fragment with the given options.
Parameters
options | Configuration options for street view, or null to use the default
options. |
---|
public void onActivityCreated (Bundle savedInstanceState)
public void onAttach (Activity activity)
public void onCreate (Bundle savedInstanceState)
public View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
public void onDestroy ()
public void onDestroyView ()
public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)
Parse attributes during inflation from a view hierarchy into the arguments we handle.