Начало работы с Google Maps для Android: основы

После того, как вы импортировали свои библиотеки, вы можете закрыть build.gradle и открыть файл AndroidManifest.xml . Над узлом application необходимо объявить, что приложение использует OpenGL ES 2.0, и определить разрешения, необходимые для вашего приложения.

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

В узле application вам нужно добавить две части метаданных. Первый информирует приложение об использовании сервисов Play, а второй связывает ключ API Карт с вашим приложением. В следующем фрагменте кода @string/google_api_key — это строковая ссылка на ключ из консоли разработчика Google.

Как только вы закончите обновление AndroidManifest.xml , закройте файл. Затем вам нужно создать новый класс Java с именем MapFragment , который расширяет SupportMapFragment . SupportMapFragment используется здесь, а не com.google.android.gms.maps.MapFragment , чтобы добавить обратную совместимость перед API 12.

Если ваше приложение не нуждается в поддержке устройств, работающих под управлением более старых версий Android, тогда лучше использовать com.google.android.gms.maps.MapFragment . После создания базового фрагмента вам необходимо реализовать шесть интерфейсов, которые мы будем использовать для этой демонстрации.

• ConnectionCallbacks и OnConnectionFailedListener предназначены для мониторинга состояния GoogleApiClient , который используется в этом приложении для получения текущего местоположения пользователя.
• OnInfoWindowClickListener запускается, когда пользователь нажимает на информационное окно, которое всплывает над маркером на карте.
• OnMapLongClickListener и OnMapClickListener запускаются, когда пользователь либо OnMapClickListener , либо удерживает на части карты.
• OnMarkerClickListener вызывается, когда пользователь нажимает на маркер на карте, которая обычно также отображает информационное окно для этого маркера.

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

После того, как вы создали начальный фрагмент, вы должны сообщить MainActivity , что он должен использовать этот фрагмент. Откройте файл activity_main.xml из папки ресурсов и измените его так, чтобы он включал фрагмент в качестве представления.

После обновления макета активности вы сможете запустить свое приложение и просмотреть карту Земли, которая полностью уменьшена и сфокусирована на широте 0, долготе 0.

3. Инициализация карты

Шаг 1: Объявление типов карт

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

Здесь mGoogleApiClient и mCurrentLocation используются для получения местоположения пользователя для инициализации камеры карты. MAP_TYPES и curMapTypeIndex используются в примере кода для переключения между различными типами отображения карты. Каждый из типов карт служит разным целям, поэтому один или несколько типов могут подойти для ваших собственных приложений.

GoogleMap.MAP_TYPE_SATELLITE отображает спутниковую GoogleMap.MAP_TYPE_SATELLITE области без названий улиц или надписей.

GoogleMap.MAP_TYPE_NORMAL показывает общую карту с названиями улиц и метками.

GoogleMap.MAP_TYPE_HYBRID объединяет спутниковый и обычный режим, отображая спутниковые изображения области со всеми метками.

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

GoogleMap.MAP_TYPE_NONE похож на карту нормалей, но не отображает никаких меток или окраски для типа среды в области. Это позволяет отображать трафик и другие наложения на карте.

Шаг 2. Создание клиента API

Затем вам нужно создать свой GoogleApiClient и GoogleApiClient LocationServices , чтобы узнать текущее местоположение вашего пользователя. Как я упоминал ранее, если у вас есть заданное местоположение, которое вы хотите отобразить, а не фокусироваться на пользователе, вы можете пропустить, используя LocationServices .

Метод initListeners связывает интерфейсы, которые вы объявили в верхней части класса, с объектом GoogleMap связанным с SupportMapFragment . Вот как выглядит реализация:

Возможно, вы заметили, что GoogleApiClient и слушатели созданы и связаны с onViewCreated а не с типичным onCreate . Это связано с тем, что объект GoogleMap не был инициализирован при onCreate , поэтому нам нужно дождаться полного создания представления, прежде чем пытаться вызвать getMap , чтобы избежать исключения NullPointerException .

Шаг 3: Настройка карты

Поскольку вы настроите камеру на карте после того, как местоположение пользователя будет найдено с помощью Play Services, мы будем использовать жизненный цикл Play Services для инициализации нашей карты. Вы можете подключить GoogleApiClient в onStart . Когда клиент подключился, вы можете получить последнее найденное пользователем местоположение и использовать его для наведения камеры на карту.

В методе initCamera вы инициализируете камеру и некоторые основные свойства карты. Вы начинаете с создания объекта CameraPosition через CameraPosition.Builder , с целью, установленной для широты и долготы вашего пользователя, и с установленным уровнем масштабирования.

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

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

Наконец, вызов setZoomControlsEnabled добавляет кнопки « +» и « -» в нижнем правом углу, позволяя пользователю изменять уровень масштабирования карты без использования жестов. Есть еще несколько интересных вещей, которые вы можете установить с помощью UiSettings , таких как добавление компаса или отключение жестов, которые вы можете найти в справочной документации по Android .

4. Маркировка мест

Одна из наиболее часто используемых функций карты включает в себя указание мест с маркерами. Поскольку для добавления маркера требуются широта и долгота, вам нужно использовать OnMapClickListener чтобы позволить пользователю выбрать точку на карте для размещения объекта Marker .

Этот метод создает общий красный маркер, где пользователь нажал. Дополнительные параметры, такие как установка маркера как перетаскиваемого, могут быть установлены с MarkerOptions объекта MarkerOptions . Вы можете найти дополнительные атрибуты в официальной справочной документации по Android . Если вы хотите изменить цвет маркера, вы можете вызвать BitmapDescriptorFactory.defaultMarker при добавлении значка в MarkerOptions . Метод defaultMarker принимает значение с плавающей точкой, которое определяет оттенок. Оттенок может быть установлен вручную или как предопределенное статическое значение из BitmapDescriptorFactory . Следует отметить, что addMarker возвращает объект Marker , который можно сохранить для ручного удаления определенных маркеров, если это необходимо.

Если вы хотите избежать использования общих цветных штырьков для маркеров местоположения, вы можете установить растровое изображение в качестве значка на объекте MarkerOptions . Чтобы продемонстрировать это, вы переопределяете метод onMapLongClick чтобы он использовал значок приложения из папки ресурсов в качестве Marker когда пользователь долго нажимает на карту.

Вы, наверное, заметили, что метод getAddressFromLatLng используется в обоих методах click. Это вспомогательный метод, который берет LatLng и запускает его через Geocoder для получения адреса улицы. В последних двух примерах мы используем этот метод для отображения адреса улицы при касании маркера.

5. Рисование на карте

У объекта GoogleMap есть набор методов, которые позволяют легко рисовать фигуры и размещать изображения на карте. Чтобы нарисовать простой круг, вам нужно всего лишь создать объект CircleOptions , установить радиус и расположение центра, а также определить цвет и размер обводки / заливки.

Если у вас есть объект CircleOptions , вы можете вызвать addCircle чтобы нарисовать определенный круг поверх карты. Как и при размещении маркеров, объекты, нарисованные на карте, возвращают объект типа нарисованного элемента, поэтому на него можно ссылаться позже, если это необходимо.

Чтобы нарисовать другую замкнутую форму, вы можете взять несколько точек LatLng и создать объект PolygonOptions . Как вы можете видеть ниже, PolygonOptions создаются аналогично CircleOptions . Вместо того, чтобы использовать метод center и radius , вы используете add со списком точек. Затем вы можете вызвать addPolygon чтобы нарисовать форму. Для этого примера вы просто рисуете треугольник на карте.

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

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

Вывод

Из этого руководства вы узнали, как создать ключ API и включить Google Maps для Android. Вы также узнали о классе MapFragment и некоторых основных функциях, которые можно активировать для карты.

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

В следующем уроке из этой серии вы узнаете, как наложить View на MapFragment , как взаимодействовать с картами уровней внутри помещений и как показать вид улиц своим пользователям.