Работа с mapview android studio

Работа с mapview android studio

Android MapView Tutorial

November 14, 2017

This tutorial is a continuation of Google maps in android apps tutorial and shows how to use MapView instead of SupportMapFragment to display Google maps in android applications. It also covers Google maps UI controls or settings, gestures, events and lite mode topics which were not covered in the previous tutorial Google maps android tutorial. You can find initial setup required to use Google maps android API in android projects at Google maps android tutorial.

If you want to learn android and its latest features with examples. Please visit android tutorials to learn android concepts, components and libraries with examples.

Defining MapView in Layout

To display maps in your android app, you need to first add MapView to activity layout.

Activity MapView

In the activity, get the MapView object and call getMapAsync on it passing OnMapReadyCallback handler. And also you need to make sure that you call onCreate, onSaveInstanceState, onResume, onStart, onStop, onPause, onDestroy and onLowMemory methods on MapView object in the corresponding activity lifecycle methods.

In the OnMapReadyCallback’s onMapReady method you can get GoogleMap object and apply required settings to customize the map.

Google Maps UI Controls

You can enable UI controls such as compass, zoom controls, indoor level picker, and map tool bar by setting related attributes in xml or programmatically. By default UI controls are not displayed.

Compass will be visible on rotating the map.

Map toolbar will be visible on touching a marker. Map tool bar contains actions which take you to directions screen, google map app etc.

Indoor level picker is applicable for building with floor plans, which allow you to see floor plan of selected level. First you need to enable indoor maps by calling setIndoorEnabled and setting it true on GoogleMap object.

Google Maps Gestures Setting

By default user can tilt, pinch to stretch, zoom, rotate and scroll map. If you don’t want to provide these options to user, you can disable any or all of the gestures. Below example shows how to disable gestures by calling setRotateGesturesEnabled, setScrollGesturesEnabled, setTiltGesturesEnabled and setZoomGesturesEnabled methods on UiSettings object.

Google Maps Camera Position

You can change the camera position programmatically or in xml. Some of the camera position attributes are target position, bearing, tilt and zoom. Bearing is the direction the camera is pointing, which is in degrees clock wise from north. Tilt is camera angle in degrees from the line when it is directly facing the earth.

Classes which are used to configure camera position are CameraPosition.Builder, CameraPosition, CameraUpdate and CameraUpdateFactory. Using CameraPosition.Builder, you can define camera position and then you can apply new camera position to GoogleMap using moveCamera method which takes CameraUpdate as parameter.

To get CameraUpdate object, you need to CameraUpdateFactory and its methods. If you use CameraPosition.Builder and create CameraPosition, you can get CameraUpdate object for that using newCameraPosition method of CameraUpdateFactory.

You can update camera position in response to events. Below example shows how to update camera position.

Camera Position Update in Response to Events

Camera position can be updated in response to events, below example shows zoom change in response to OnMapClick event using OnMapClickListener as shown below.

Google Maps Event Listeners

There are several event handlers which you can implement and add to GoogleMap to provide custom behavior in response to user interaction on Google maps.

OnCameraIdleListener

OnCameraIdleListener’s onCameraIdle method is called after camera moves. You can add the listener to GoogleMap object by calling setOnCameraIdleListener.

OnCameraMoveListener

OnCameraMoveListener’s onCameraMove method is called while camera moves. You can add the listener to GoogleMap object by calling setOnCameraMoveListener.

OnCameraMoveStartedListener

OnCameraMoveStartedListener’s onCameraMoveStarted method is called when camera motion starts. You can add the listener to GoogleMap object by calling setOnCameraMoveStartedListener. Based on the reason for camera motion, you can do something. Possible reasons for camera motion are GoogleMap.OnCameraMoveStartedListener.REASON_API_ANIMATION, GoogleMap.OnCameraMoveStartedListener.REASON_DEVELOPER_ANIMATION and GoogleMap.OnCameraMoveStartedListener.REASON_GESTURE

OnCircleClickListener

OnCircleClickListener’s onCircleClick method is called when a circle on the maps is clicked. You can add the listener to GoogleMap object by calling setOnCircleClickListener. In onCircleClick method, you can use Circle object, which is clicked, to change circle settings or other customizations on map.

OnInfoWindowClickListener

OnInfoWindowClickListener’s onInfoWindowClick method is called when marker’s info window is clicked. You can add the listener to GoogleMap object by calling setOnInfoWindowClickListener. Method onInfoWindowClick is passed the Marker object to which info window anchored. Using the Marker object, you can customize marker or info window in the handler method.

OnInfoWindowCloseListener

OnInfoWindowCloseListener’s onInfoWindowClose method is called when info window is closed. You can add the listener to GoogleMap object by calling setOnInfoWindowCloseListener.

OnMarkerClickListener

OnMarkerClickListener’s onMarkerClick method is called when a marker is clicked. You can add the listener to GoogleMap object by calling setOnMarkerClickListener. Return true to override the default behavior.

OnPoiClickListener

OnPoiClickListener’s onPoiClick method is called when any point of interest on the map is clicked. You can add the listener to GoogleMap object by calling setOnPoiClickListener method. PointOfInterest object which is passed to onPoiClick method can be used to get information about point of interest and do something like adding marker to POI and moving camera to POI as shown in the below example.

OnPolygonClickListener

OnPolygonClickListener’s onPolygonClick method is called when a polygon is clicked. You can add the listener to GoogleMap object by calling setOnPolygonClickListener, using polygon object passed to the handler method, you can customize the map.

Google Map Lite

You can display Google map in lite mode in android apps by setting lite mode attribute to true in xml or programmatically. You can set zoom, add marker, info window and shapes and select one of the supported map types to map, but lite mode doesn’t support camera tilt and bearing. User viewing the lite map can’t zoom or pan.

Lite mode xml attribute

To enable lite mode in xml layout, you need to set liteMode attribute to true.

Enabling lite mode programmatically

To enable lite mode in code, you need to instantiate MapView passing GoogleMapOptions object to constructor and then add the MapView object to layout. GoogleMapOptions contains lite mode attribute which you need to set to true.

About

Android app development tutorials and web app development tutorials with programming examples and code samples.

Источник

Полный список

— создаем приложение с картой
— настраиваем карту и обрабатываем ее события
— программно меняем положение камеры

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

Но перед тем, как начать творить и созидать, нам надо будет сделать две вещи.

1) В гугл-консоли включить службу карт и получить API-ключ для работы

2) Обеспечить доступ проекта к Google Play services

API ключ

Начнем с первого пункта. Для этого нам надо зайти в Google APIs Console.

Если у вас нет проекта, гугл предложит его создать.

Жмем Create project…

Проект создан. Слева выбираем Services и открывается список служб.

В этом списке ищем Google Maps Android API v2

Жмем на тумблер включения (OFF), принимаем соглашение и снова попадаем в список служб.

Но теперь служба должна быть включена

Все ок. Теперь идем за ключом.

Для этого слева сверху выбираем API Access и открывается такой экран.

На нем жмем кнопку Create new Android key и от нас требуют ввести SHA1-значение ключа, которым будет подписано приложение.

И даже дают инструкции, как это сделать с помощью утилиты keytool

Если вообще непонятно о чем речь, рекомендую прочесть Урок 123. Там я все подробно описал.

Но последние версии Eclipse позволяют получить SHA1 без всяких команд, достаточно зайти в настройки и там есть вся инфа

Берем содержимое поля SHA1 fingerprint

К нему через точку с запятой дописываем пакет приложения (в этом уроке это будет ru.startandroid.develop.p1391googlemaps), вставляем в поле и жмем Create.

Появился нужный нам ключ — строка API key.

Не закрывайте пока эту страницу, скоро этот созданный ключ нам понадобится при создании приложения.

Не забывайте проделать эти же манипуляции, когда будете подписывать приложение для публикации на маркете другим ключом.

Google Play services

Теперь второй пункт. Для работы с картой нам понадобится Google Play services.

Открываем SDK Manager и ищем там Extras > Google Play services (если планируете поддержку Android 2.2, то Google Play services for Froyo). Если еще не установлено, то устанавливайте.

Исходники из папки google-play-services_lib надо будет импортнуть в Workspace. Для этого в меню Eclipse жмем File > Import, выбираем Android > Existing Android Code into Workspace, находим google-play-services_lib папку, ставим галку, чтобы импорт был выполнен путем копирования (Copy projects into workspace) и жмем Finish.

Проект google-play-services_lib должен появиться в вашем Workspace

Предварительная подготовка завершена, можем создавать проект.

Project name: P1391_GoogleMaps
Build Target: Android 2.3.3
Application name: GoogleMaps
Package name: ru.startandroid.develop.p1391googlemaps
Create Activity: MainActivity

Настройка проекта

Теперь еще немного возни с проектом.

Заходим в свойства проекта и добавляем (кнопкой Add) ссылку на ранее импортированный google-play-services_lib проект.

В манифесте необходимо добавить следующее в тег application:

Первые данные, это наш ключ из гугл-консоли. Здесь вам надо в android:value поставить ваше значение API key, которое вы чуть ранее получили и оставили открытым в браузере. Этот ключ нужен, чтобы карта работала.

Вторые данные – это версия Google Play services. Думаю, что эта инфа о версии нужна, чтобы карта четко понимала, как и что ей доступно из этих сервисов.

Также, в манифесте в тег manifest нам надо добавить следующие разрешения:

Это доступ в инет, проверка доступности инета, сохранение кэша карт и доступ к гугл-веб-сервисам.

Если думаете работать с определением местоположения, то не забывайте про:

И туда же, в тег manifest такое требование:

Гугл-карты используют OpenGL ES версии 2. На девайсах, которые это не поддерживают, карта просто не отобразится. Поэтому ставим ограничение.

Теперь все. Далее продолжаем работу, как с обычным проектом.

В strings.xml добавим строки:

Кнопка и фрагмент-карта

В onCreate мы находим наш фрагмент с картой и получаем от него объект GoogleMap методом getMap. Учитывайте, что этот метод может вернуть null.

Кстати, в onCreate можно также повесить проверку, что на устройстве доступно Google Play services. Для этого надо вызвать метод isGooglePlayServicesAvailable() и он должен вернуть SUCCESS. Подробности в хелпе.

Метод init пока пустой.

В onClickTest мы устанавливаем тип карты методом setMapType

Всего существует 5 типов:

MAP_TYPE_NONE – карта не будет отображаться

MAP_TYPE_NORMAL – обычный режим, в нем карта стартует по умолчанию.

MAP_TYPE_TERRAIN – карта рельефа местности

MAP_TYPE_HYBRID – снимки со спутника + инфа о улицах и транспорте

Получить текущий тип можно методом getMapType.

Я буду проводить все тесты на реальном устройстве, т.к. эмуляторы по умолчанию не поддерживают Google Play services. Но если очень надо, то можно и на эмуляторе запустить после некоторых манипуляций. Об этом написано, например, здесь. Надо скачать два APK-файла и установить их на эмулятор.

Карта

Все сохраняем, запускаем приложение и видим карту в обычном режиме.

У меня при первом запуске карта была не видна, но были видны кнопки управления масштабом. В логах был такой текст: Failed to load map. Error contacting Google servers. This is probably an authentication issue (but could be due to network errors). В этом случае убедитесь, что все верно сделано с получением ключа. Если проблема остается, то удалите приложение с устройства, сделайте в Eclipse очистку проекта (меню Project > Clean) и снова установите приложение — мне помогло.

Теперь карта отображает снимки со спутника

Посмотрим, что еще можно сделать с картой.

В обычном режиме карта умеет показывать даже схему этажей здания, если очень приблизиться зумом к этому зданию.

Вот, например схема 0-го этажа аэропорта Барселоны. Справа видно переключатель этажей.

Мы можем отключить программно эту возможность методом setIndoorEnabled.

Метод setBuildingsEnabled управляет отображением 3D зданий.

Управление

Управление картой жестами и кнопками также поддается настройке. Для этого необходимо вызвать метод getUiSettings и мы получим объект настроек интерфейса UiSettings.

У него куча методов, которые что-либо включают/выключают:

setMyLocationButtonEnabled – кнопка текущего местоположения (необходимо включить определение, метод setMyLocationEnabled(true))

У этих методов есть аналоги, которые начинаются с is вместо set и позволяют получить текущие значения.

На карту можно вешать слушателей. Перепишем метод init:

setOnMapClickListener вешает слушателя OnMapClickListener. Его метод onMapClick сработает при клике на карту и вернет объект LatLng с координатами (latitude, longitude), где было нажатие.

setOnMapLongClickListener вешает слушателя OnMapLongClickListener. Его метод onMapLongClick сработает при длительном нажатии на карту и вернет объект LatLng с координатами (latitude, longitude), где было нажатие.

setOnCameraChangeListener вешает слушателя OnCameraChangeListener. Его метод onCameraChange сработает при смене позиции камеры, т.е. при пролистывании карты, и вернет объект CameraPosition, который содержит информацию о текущем положении камеры.

CameraPosition имеет атрибуты:

— target, тип LatLng с полями-координатами: latitude, longitude. Это точка, на которую смотрит камера.

— bearing, угол поворота камеры от севера по часовой

— tilt, угол наклона камеры

— zoom, текущий уровень зума

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

Камера

Теперь рассмотрим возможности программного изменения положения камеры.

Для этого нам необходимо будет создавать объект CameraUpdate и передавать его в один из методов:

animateCamera(CameraUpdate update, GoogleMap.CancelableCallback callback) – плавное перемещение и возможность указать слушателя CancelableCallback, который оповестит, что перемещение завершено (метод onFinish), либо прервано (метод onCancel).

animateCamera(CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback) – плавное перемещение, слушатель CancelableCallback и возможность указать время длительности перемещения в миллисекундах

Остается узнать, как получить объект CameraUpdate, который будет содержать информацию о перемещении камеры. Для этого используется CameraUpdateFactory.

Пойдем по порядку методов в хелпе.

newCameraPosition (CameraPosition cameraPosition) – созданный объект CameraUpdate будет содержать данные по перемещению камеры в указанную позицию с указанными настройками.

Тут снова появляется объект CameraPosition, все параметры которого мы уже чуть ранее рассмотрели при разговоре о событии смены камеры и который содержит всю инфу о положении камеры

Чтобы создать CameraPosition, используем CameraPosition.Builder. Перепишем метод onClickTest:

Создаем CameraPosition, указываем координаты (-27,133), зум (5 уровень), поворот карты (45 градусов), угол наклона (20 градусов). И передаем полученный объект в метод newCameraPosition, получая CameraUpdate, который в свою очередь передаем в метод animateCamera.

Все сохраним, запустим, жмем Test и наблюдаем плавное перемещение к Австралии. В процессе перемещения меняется уровень зума, угол наклона и поворот камеры.

newLatLng (LatLng latLng) — перемещение камеры к указанной точке.

Тут все просто. Перепишем метод onClickTest:

По нажатию на Test камера переместится в указанную точку.

newLatLngBounds (LatLngBounds bounds, int padding) – камера покажет указанную область с учетом отступа

Перепишем метод onClickTest:

Для указания области используется объект LatLngBounds, который создается из двух точек LatLng. Эти две точки будут являться левой нижней (югозападной) и верхней правой (северовосточной) точками созданной области.

Параметр padding это отступ (в пикселах) от краев экрана. Т.е., если указать ненулевой padding, то камера покажет указанную область карты не в весь экран, а с учетом этого отступа.

По нажатию на Test камера покажет Австралию с отступом в 100 пикселов от краев экрана.

newLatLngBounds (LatLngBounds bounds, int width, int height, int padding) – аналогичен предыдущему, но можно указать размеры прямоугольника на экране, в который будет помещена показанная область и отступ будет действовать внутри этой области.

newLatLngZoom (LatLng latLng, float zoom) – переместит камеру в указанную точку с указанным уровнем зума

scrollBy (float xPixel, float yPixel) – перемещение камеры на указанное кол-во пикселов

zoomBy (float amount) – изменение текущего уровня зума на указанное кол-во (если положительное — то приближение, если отрицательное — удаление).

zoomBy (float amount, Point focus) – смена текущего зума на указанное кол-во уровней, и применение итогового уровня к указанной точке на экране

zoomIn/zoomOut – увеличение/уменьшение уровня зума на единицу

zoomTo (float zoom) – установка указанного уровня зума

Объект GoogleMap имеет метод setPadding. Он устанавливает отступы от краев экрана. Это влияет на положение стандартных элементов управления карты, а также камера теперь будет считать центром карты эту новую ограниченную область и позиционироваться там.

На следующем уроке:

— размещаем на карте свои объекты

Присоединяйтесь к нам в Telegram:

— в канале StartAndroid публикуются ссылки на новые статьи с сайта startandroid.ru и интересные материалы с хабра, medium.com и т.п.

— в чатах решаем возникающие вопросы и проблемы по различным темам: Android, Kotlin, RxJava, Dagger, Тестирование

— ну и если просто хочется поговорить с коллегами по разработке, то есть чат Флудильня

— новый чат Performance для обсуждения проблем производительности и для ваших пожеланий по содержанию курса по этой теме

Источник