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.libraries.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 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 SDK for Android does not support multiple
SupportStreetViewPanoramaFragment
objects in one activity.
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(StreetViewPanoramaOptions options)
Creates a streetview panorama fragment with the given options.
|
static SupportStreetViewPanoramaFragment |
newInstance()
Creates a streetview panorama fragment, using default options.
|
void |
onActivityCreated(Bundle savedInstanceState)
|
void |
onAttach(Activity activity)
|
void |
onCreate(Bundle savedInstanceState)
|
View |
onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
|
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. |
---|
public static SupportStreetViewPanoramaFragment newInstance (StreetViewPanoramaOptions options)
Creates a streetview panorama fragment with the given options.
Parameters
options |
---|
public static SupportStreetViewPanoramaFragment newInstance ()
Creates a streetview panorama fragment, using default options.
public void onActivityCreated (Bundle savedInstanceState)
Parameters
savedInstanceState |
---|
public void onAttach (Activity activity)
Parameters
activity |
---|
public void onCreate (Bundle savedInstanceState)
Parameters
savedInstanceState |
---|
public View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
Parameters
inflater | |
---|---|
container | |
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.
Parameters
activity | |
---|---|
attrs | |
savedInstanceState |
public void onLowMemory ()
public void onPause ()
public void onResume ()
public void onSaveInstanceState (Bundle outState)
Parameters
outState |
---|
public void onStart ()
public void onStop ()
public void setArguments (Bundle args)
Parameters
args |
---|