Use this class to initialize the Google Maps SDK for Android if features need to be used before obtaining a map. It must be called because some classes such as BitmapDescriptorFactory and CameraUpdateFactory need to be initialized.
Do not use this class if you obtain a valid GoogleMap
reference using the onMapReady(GoogleMap map)
callback. Instead provide the callback to either MapFragment#getMapAsync()
or MapView#getMapAsync()
. For examples, see the sample application.
Nested Class Summary
MapsInitializer.Renderer
you prefer to use for your application LATEST
or LEGACY
. Public Method Summary
| synchronized static int | initialize
( Context
context, MapsInitializer.Renderer
preferredRenderer, OnMapsSdkInitializedCallback
callback)
Specifies which
MapsInitializer.Renderer
type you prefer to use to initialize the Google Maps SDK for Android, and
provides a callback to receive the actual MapsInitializer.Renderer
type. |
| synchronized static int | initialize
( Context
context)
Initializes the Google Maps SDK for Android so that its classes are ready for
use.
|
Inherited Method Summary
Public Methods
public static synchronized int initialize ( Context context, MapsInitializer.Renderer preferredRenderer, OnMapsSdkInitializedCallback callback)
Specifies which MapsInitializer.Renderer
type you prefer to use to initialize the Google Maps SDK for Android, and provides a
callback to receive the actual MapsInitializer.Renderer
type. This call will initialize the Google Maps SDK for Android, so that its classes
are ready for use. The callback will be triggered when the Maps SDK is initialized.
The Maps SDK only initializes once per Application lifecycle. Only the first call of
this method or initialize(Context)
takes effect. To make renderer preference meaningful,
you must call this method before initialize(Context)
, and before MapFragment.onCreate(Bundle)
and MapView.onCreate(Bundle)
. It's recommended to do this in Application.onCreate()
.
Do not use this method if you obtain a valid GoogleMap
reference using the onMapReady(GoogleMap map)
callback. Instead provide the callback to either MapFragment#getMapAsync()
or MapView#getMapAsync()
. This call will then have no effect other than
triggering the callback for the initialized MapsInitializer.Renderer
.
Note the following:
- Use
LEGACYto request the legacy renderer. No action is necessary if you prefer to use the latest renderer, as the latest render is the default. - The latest renderer may not always be returned due to various reasons, including not enough memory, unsupported Android version, or routine downtime.
Parameters
| context | Required to fetch the necessary SDK resources and code. Must not be null
. |
|---|---|
| preferredRenderer | Which MapsInitializer.Renderer
type you prefer to use for your application. If null
is provided, the default
preference is taken. |
| callback | The callback that the Maps SDK triggers when it informs you about which renderer type was actually loaded. You can define what you want to do differently according to the maps renderer that is loaded. |
Returns
- A ConnectionResult error code.
public static synchronized int initialize ( Context context)
Initializes the Google Maps SDK for Android so that its classes are ready for use.
Do not use this method if you obtain a valid GoogleMap
reference using the onMapReady(GoogleMap map)
callback. Instead provide the callback to either MapFragment#getMapAsync()
or MapView#getMapAsync()
. For examples, see the sample application.
Parameters
null
.Returns
- A ConnectionResult error code.
