Stay organized with collections Save and categorize content based on your preferences.
The Maps SDK for Android can serve a bitmap image of a map, offering limited interactivity to the user. This is called a lite mode map.
Code samplesThe ApiDemos repository on GitHub includes samples that demonstrate the use of lite mode:
A lite mode map is a bitmap image of a map at a specified location and zoom level. Lite mode supports all of the map types (normal, hybrid, satellite, terrain) and a subset of the functionality supplied by the full API. Lite mode is useful when you want to provide a number of maps in a stream, or a map that is too small to support meaningful interaction.
Users viewing the map cannot zoom or pan the map. Icons on the map give users access to viewing the map in the Google Maps mobile app and requesting directions.
Adding a lite mode mapLite mode uses the same classes and interfaces as the full Google Maps Android API. You can set a GoogleMap
to lite mode in the following ways:
MapView
or MapFragment
GoogleMapOptions
objectMapView
or MapFragment
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.gms.maps.MapFragment"
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:cameraZoom="13"
map:mapType="normal"
map:liteMode="true"/>
In the GoogleMapOptions
object Kotlin
val options = GoogleMapOptions() .liteMode(true)Java
GoogleMapOptions options = new GoogleMapOptions() .liteMode(true);
For details on setting the initial state of the map, see the guide to the map object.
Intents to launch a map view or directions requestBy default, a toolbar at the bottom right of the map contains icons that provide access to a map view or directions request in the Google Maps mobile app. You can disable the toolbar by calling UiSettings.setMapToolbarEnabled(false)
. For more details, see the toolbar documentation.
Also by default when a user taps the map, the API starts the Google Maps mobile app. You can override this by using GoogleMap.setOnMapClickListener()
to set your own listener. You can also disable click events on the map, by calling setClickable()
on the view that contains the MapView
or MapFragment
. For details of these two techniques, see the events documentation.
When using the API in fully interactive mode, users of the MapView
class must forward all the activity life cycle methods to the corresponding methods in the MapView
class. Examples of the life cycle methods include onCreate()
, onDestroy()
, onResume()
, and onPause()
.
When using the MapView
class in lite mode, forwarding lifecycle events is optional, except for the following situations:
onCreate()
, otherwise no map will appear.onResume()
and onPause()
, because the location source will only update between these calls. If you use your own location source, it's not necessary to call these two methods.The following table describes the behavior of a lite mode map for each area of API functionality. If an app calls a method that's not supported in lite mode, the API will log a warning message.
Functionality Map typesSupported? Yes
The following
map typesare available via
GoogleMapOptions.mapType()
and
GoogleMap.setMapType()
:
MAP_TYPE_NORMAL
,
MAP_TYPE_SATELLITE
,
MAP_TYPE_TERRAIN
,
MAP_TYPE_HYBRID
,
MAP_TYPE_NONE
Polylines, polygons, circles
Supported? Yes
The lite mode functionality for
shapesmatches the full API.
ProjectionSupported? Yes
The lite mode functionality for
Projectionmatches the full API.
My LocationSupported? Yes
The lite mode functionality for the
My Location layermatches the full API.
Map paddingSupported? Yes
The lite mode support for
map paddingmatches the full API.
Info windowsSupported? Yes
If you set the
title()
of a marker, the default
info windowwill appear when the user taps the marker. You can show the info window programmatically by calling
showInfoWindow()
on the marker. You can also create custom info windows via the
InfoWindowAdapter
interface.
Custom base map stylesSupported? Partly
The Maps SDK for Android supports
custom stylingof the base map. Lite Mode only supports JSON-based custom styling, not cloud-based styling which requires a map ID to render a styled map. Lite mode also does not support setting the
map color schemeto use dark mode.
MarkersSupported? Partly
You can add a
markerand respond to a click event. You can also add custom marker icons. It's not possible to make a marker draggable. Markers on a lite mode map are flat, and they cannot be rotated.
Camera position, zoom, and animationSupported? Partly
You can set the camera target and zoom, but not the tilt or bearing. Zoom level is rounded to the nearest integer in lite mode. Calling GoogleMap.moveCamera()
will give you another lite mode map image. For more information on setting and manipulating the camera, see Changing the View.
Calling GoogleMap.animateCamera()
will not result in animation of the camera movement. The camera view will move instantly to the new position.
Supported? Partly
Lite mode supports GoogleMap.setOnMapClickListener()
and GoogleMap.setOnMapLongClickListener()
.
To disable click events on a map in lite mode, you can call setClickable()
on the view that contains the MapView
or MapFragment
. This is useful, for example, when displaying a map or maps in a list view, where you want the click event to invoke an action unrelated to the map.
For details, see the events documentation.
Indoor maps and buildingsSupported? No
Lite mode will show the same tiles as the
Maps Static API. This means that if the indoor floor plan is baked into the default tile, it will appear. Otherwise, it won't. Further, you cannot change the level shown or manipulate a level picker.
Traffic layerSupported? No
GoogleMap.setTrafficEnabled()
is not supported in lite mode.
Supported? No
GoogleMap.addGroundOverlay()
is not supported in lite mode.
Supported? No
GoogleMap.addTileOverlay()
is not supported in lite mode.
Supported? No
Lite mode does not support gestures. Enabling and disabling gestures will have no effect.
Street ViewSupported? No
Street Viewis not supported in lite mode.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["The Maps SDK for Android offers a lite mode that serves a bitmap image of a map with limited interactivity."],["Lite mode maps support all map types and basic functionalities like markers, shapes, and info windows, but with limitations on camera movement and user interaction."],["While most API features are supported in lite mode, some features, like traffic layers, Street View, and advanced gestures, are not available."],["Lite mode is ideal for displaying static maps, maps within lists or streams, and maps in situations where full interactivity is not crucial."],["Developers can customize lite mode maps with markers, shapes, and custom styling, and handle click events for basic user interactions."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4