Упрощенный режим

Maps SDK для Android может отправлять битовое изображение карты. В этом случае пользователям доступны не все интерактивные функции. Такой режим называется упрощенным.

Примеры кода

Репозиторий ApiDemos в GitHub содержит примеры, демонстрирующие упрощенный режим.

• LiteDemoActivity (Java): основы работы с картой в упрощенном режиме с помощью Java.
• LiteDemoActivity (Kotlin): основы работы с картой в упрощенном режиме с помощью Kotlin.
• LiteListDemoActivity (Java): эффективное отображение карт в ListView в упрощенном режиме с помощью Java.
• LiteListDemoActivity (Kotlin): эффективное отображение карт в ListView в упрощенном режиме с помощью Kotlin.

Обзор упрощенного режима

В упрощенном режиме карта представляет собой битовое изображение определенного местоположения с указанным масштабом. Упрощенный режим поддерживает все типы карт (стандартные, гибридные, спутниковые, карты рельефа) и частичный набор функций, предоставляемых полным API. Этот режим применяется для предоставления нескольких карт в потоке или карты, которая слишком мала для реального взаимодействия.

При просмотре карты в упрощенном режиме пользователи не могут панорамировать ее и изменять ее масштаб. На карте есть значки, с помощью которых можно просматривать ее в мобильном приложении, а также прокладывать маршруты.

Добавление карты в упрощенном режиме

В упрощенном режиме используются те же классы и интерфейсы, что и в полнофункциональном интерфейсе Google Maps Android API. Упрощенный режим в GoogleMap можно установить одним из двух способов:

• Добавить атрибут XML в MapView или MapFragment.
• Добавить атрибут в объект GoogleMapOptions.

Пример с атрибутом XML в MapView или 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"/>

Пример с использованием объекта GoogleMapOptions

val options = GoogleMapOptions()
    .liteMode(true)

      

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

Подробную информацию о том, как задать начальное состояние карты, вы найдете в руководстве по объектам.

Объекты Intent для запуска представления карты или запроса маршрутов

По умолчанию на панели инструментов в правом нижнем углу карты расположены значки для доступа к представлению карты или запросу маршрута в мобильном приложении "Google Карты". Вы можете отключить панель инструментов, вызвав UiSettings.setMapToolbarEnabled(false). Подробную информацию вы найдете в документации.

Кроме того, когда пользователь касается карты, по умолчанию API запускает мобильное приложение "Google Карты". Вы можете изменить это поведение, используя метод GoogleMap.setOnMapClickListener() для установки собственного прослушивателя. Также вы можете отключить события кликов на карте, вызвав метод setClickable() в представлении, которое содержит MapView или MapFragment. Дополнительные сведения об этих двух методах приведены в документации о событиях.

События в рамках жизненного цикла

При использовании API в полностью интерактивном режиме пользователи класса MapView должны передавать все методы жизненного цикла операций соответствующим методам в классе MapView. Примеры методов жизненного цикла: onCreate(), onDestroy(), onResume() и onPause().

При использовании класса MapView в упрощенном режиме передача событий жизненного цикла не обязательна, за исключением следующих ситуаций:

• Вызов метода onCreate() обязателен, иначе карта не отобразится.
• Если вы хотите отобразить точку "Мое местоположение" на карте в упрощенном режиме и использовать источник местоположения по умолчанию, то вам необходимо вызвать методы onResume() и onPause(), поскольку источник местоположения обновляется только между этими вызовами. Если вы используете собственный источник местоположения, эти два метода можно не вызывать.

Поддерживаемые функции API

В таблице ниже приводится описание поведения карты в упрощенном режиме для каждой области функциональных возможностей API. Если приложение вызовет метод, который не поддерживается в упрощенном режиме, API запишет сообщение с предупреждением.