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.StreetViewPanoramaFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
StreetViewPanorama
must be acquired using
getStreetViewPanoramaAsync(OnStreetViewPanoramaReadyCallback)
. The StreetViewPanoramaFragment
automatically initializes the Street View system and the view.
A view can be removed when the StreetViewPanoramaFragment's
onDestroyView()
method is called and the
StreetViewPanoramaOptions.useViewLifecycleInFragment(boolean)
option is set. When
this happens the StreetViewPanoramaFragment 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 SDK for Android does not support multiple
StreetViewPanoramaFragment
objects in one activity.
Inherited Constant Summary
Public Constructor Summary
StreetViewPanoramaFragment()
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 StreetViewPanoramaFragment |
newInstance()
Creates a streetview panorama fragment, using default options.
|
static StreetViewPanoramaFragment |
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 StreetViewPanoramaFragment ()
Creates a streetview panorama fragment. This constructor is public only for use by
an inflater. Use
newInstance()
to create a StreetViewPanoramaFragment 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 StreetViewPanoramaFragment newInstance ()
Creates a streetview panorama fragment, using default options.
public static StreetViewPanoramaFragment 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.