Yandex maps api android studio

Мой (нано)опыт с Yandex.Maps API или зачем нужна инструкция

Introduction

Я андроид разработчик и.

Мне довелось допиливать небольшой проект(

500h), в котором на старте было принято решение использовать Yandex.Maps API, потому что зачем для Москвы использовать гугл карты, если есть наши. Сейчас расскажу, как все прошло.

Я не проводил глубоких подкапотных исследований и никаких секретов не открою. Но, если вам, как и мне, надо очень быстро (вчера) начать использовать в вашем проекте карты, надеюсь, помогу сэкономить немного времени.

Если лень читать или сразу нужен вывод, отправляю в последнее “Действие 4: Это конец / TL;DR”

Действие 0: Определения

Начнем с определений: что, зачем, почему.

Задача: отобразить карту Москвы, пинами указать конкретные места, уметь построить маршрут от текущего положения до конкретной точки (или до нескольких).
Технология: Yandex.Maps API. Ссылки на документацию[1] ниже.
Итого: прочитайте документацию, реализуйте фичи.

Все выглядит просто, что может пойти не так.

Действие 1: Поиск

Прежде чем изучить документацию, её надо найти. Искать яндекс, конечно же, будем в гугле — найдем [2] или [2].ru [3]. Мы — девелоперы, видим кнопку “для девелоперов” — жмем. Огромная иконка “Maps API” выглядит как то, что нам нужно! (It’s a trap!)

В “. /maps” [4] нас ждут только бесконечный поиск, разочарование и страдания. Которые к нужной документации меня так и не привели.

Возвращаемся на шаг назад, листаем вниз и находим MapKit [5] — нам сюда. Навигация тут довольно грустная, поэтому вот важные ссылки — android samples [6] и Documentation [7] (возможно, иногда получится найти тут что-то полезное).

Действие 2: Поехали

Находим Getting started и приступаем. В начале все просто.

На “Step 3. Set up the library” возникают вопросы. Вью и фабрику нужно обязательно стартовать и останавливать отдельно, иначе, как нам сообщают, ничего не будет работать. Почему? А что будет, если что-то стартану, а что-то нет, или стартану что-то позже? А если несколько вьюх, то для каждого надо фабрику, или это синглтон?

Возможно, это всего лишь QuickStart и дальше мы найдем подробное описание! (нет)

Давайте смотреть, что есть по документации. А все, ничего больше нет. Есть только сгенерированная документация с комментариями типа:

Ладно, на гитхабе есть еще проект с примерами использования [8]. Внутри каждого класса активити есть комментарии о том, что он делает и зачем нужен (после документации это просто подарок судьбы). Есть несколько сценариев: создание кастомного слоя карты, построение маршрута для автомобиля, работа с объектами на карте и некоторые другие.

Выглядит ли апи мощным? Да.
Понятно ли как им пользоваться в случаях, чуть более сложных, чем примеры? Нет.(
Как это понять? ¯_(ツ)_/¯ Нырять с головой в код, по итогу исследований продавать книжку о том, что нашел.

Действие 3: Разрабатываем

Задача 1: отобразить карту
Сложностей не встретил, все есть в гайде.

Задача 2: отобразить пины
Нам нужен “MapObjectsActivity.java», то, что мы ищем, называется Placemarks. Смотрим в код, чтобы понять, что с ними делать.

Задача 3: построить маршрут
Наш друг тут — “MasstransitRoutingActivity.java”. Маршрут можно попросить разный: только на машине, только пешком, и так и сяк; наверняка можно еще учесть метро и другие разные штуки, но я недонырнул.

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

Для решения этой задачи придется вернуться в поиск — и найти документацию для js [9]. Она кажется гораздо более подробной и объемной (я завидую). Нам необходим “HTTP geocoding request” [10] — тут довольно понятно написано, что это и как его использовать. Дело за реализацией http запросов-ответов на мобилках.

Действие 4: Это конец / TL;DR

Общие итоги:
Яндекс карты классные. Как ими пользоваться — непонятно.

Хорошая документация, чтобы “потрогать” сервис. Ужасная документация, чтобы что-то с ним сделать. Структура ссылок — “Хрен найдешь”, качество находки — “Вот колесо, оно катится. А далее вы сами легко сможете изобрести машину, ракету, подводную лодку”.

Основные моменты:
Как отобразить карту в проекте? Ссылка [7], тут всё просто.
Как добавить пин на карту? Ключевые слова Placemark, MapObjects. Искать в samples.
Как построить маршрут? Ключевое слово MasstransitRouting. Искать в samples.
Как сделать что-то еще? Искать в samples. Если там нет, то у вас проблемы.

Источник

Интеграция карт в ваше Android-приложение

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

В данном статье я расскажу как интегрировать возможность просмотра карт для мобильных устройств на основе Android, на примере Yandex Карт и Google Maps.
Функционал библиотек этих компаний позволяет:

• Перемещать карту
• Изменять масштаб
• Изменять виды карт
• Получать события от карты

Начнём с отечественного производителя.

Yandex

Библиотеку Yandex MapKit можно скачать с GitHub’а, там же есть версия и для iOS.
Но прежде чем начать использовать, нам надо получить API-key, для этого идём на почту и пишем письмо в support@mobmaps.yandex.ru, указав в заголовке «Map Kit запрос API-ключа». В ответ вам пришлют письмо с указанием дополнительных ссылок на документацию, на правила использования и собственно с самим ключом в теле письма (а могут и не прислать, кстати).

Пока ждём письмо, берём библиотеку и прикрепляем её к проекту.

После долгого ожидания с кружкой кофе, знакомимся с содержимым письма и информации по ссылкам, берём ключик и пишем в вашем layout’е приложения следующий код:

где заместо «you are key» вставляем полученный ключ. Всё, карта есть.

Далее код показывает, как перемещать карту на заданную координату и использовать зум:

Google

Для использования Google Maps надо совершить куда более изощрённые действия. Я расскажу, как получить debug-key для использования карт, но процесс получения release версии похоже несколько замороченней, но я release ещё не получал.

Для получения debug-key, надо найти ваше хранилище ключей, для отладки.
По-умолчанию, путь будет выглядеть примерно так:

Затем открываем командную строку, переходим в каталог, куда установлена Java:

где путь_до_хранилища_ключей — свой путь до debug.keystore (осторожно, возможны проблемы с пробелами в пути).

После чего в том же окне будет выведен md5-ключ после «Certificate fingerprint (MD5)».
Идём по ссылке и регистрируем код.
После чего Google сгенерирует с нужным кодом для layout и встроенным кодом, берём его и вставляем к себе в layout.
Далее нам, надо наш Activity представить в примерно следующем виде:

Замечу, что Activity наследован должен быть от MapActivity хранящийся в com.google.android.maps.MapActivity.
А в манифесте прописать между тегами вставить:

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

В остальном функционал GoogleMaps и YandexMapKit весьма схож:

Как можно видеть, процесс интеграции карт в приложения довольно простой, а спектр использования довольно широк.
Более подробно можно ознакомиться ниже.

Определение собственной позиции

Чтобы немного расширить пример, приложу кусок кода:

Но для использования этого кода, в манифесте следует указать следующее разрешение:

Источник

Yandex maps api android studio

Yandex Map Kit for Android

Latest commit

Git stats

Files

Failed to load latest commit information.

README.md

Эта версия больше не поддерживается, актуальную инфрмацию о новых версиях MapKit можно найти по ссылкам:

В этом репозитории находится тестовое приложение, демонстрирующее возможности Yandex Map Kit.

1. Добавлено новое API уOverlayItem setOverlayItemListener #256
2. Исправлена ошибка #253
3. Исправлена ошибка #249
4. Исправлена ошибка #240
5. Исправлена ошибка #234

1. Исправлена ошибка утечки #243
2. Исправлена ошибка #240
3. Добавили свойство в MapEvent isGesture() #237

1. Исправлены ошибки при отображении карты
2. Добавлен arm64-v8a и x86_64 архитектуры

1. Исправлены ошибки отображения кнопок на карте
2. Добавлен пример работы с запросом разрешений на получения геопозиции

1. Исправлены ошибки, приводившие к падениям
2. Удалены все запросы разрешений, кроме получения геопозиции

1. Клонируйте репозиторий примера git clone https://github.com/yandexmobile/yandexmapkit-android.git
2. В папке yandexmapkit-sample находится пример приложения который через gradle зависимость подключает мапкит
3. Данные проекты уже настроены для работы в среде Eclipse
4. Импортируйте данные проекты в среду Eclipse или Android Studio
5. Выполняете Gradle Sync для проекта.
6. Подставьте свой API ключ во все layout где используется объект MapView
7. Всё готово к запуску тестового проекта

Запуск из командной строки.

Миграция с первой версии

1. При создании OverlayItem необходимо в конструкторе вместо объекта Bitmap передавать Drawable, можно воспользоваться new BitmapDrawable(you_bitmap)
2. При создании объекта BalloonItem необходимо в конструкторе передавать Context (необходимый для загрузки ресурсов)
3. Исправить использования интерфейса с OnBallonListener на OnBalloonListener и добавить новые методы из данного интерфейса
4. Исправить имя метода у BalloonItem с setOnBallonListener на setOnBalloonViewClickListener
5. Необходимо изменить логику работы интерфейса OnBalloonListener метода onBallonClick на onBalloonViewClick

Интеграция с Яндекс.Картами

Документация по интеграции с мобильными Яндекс.Картами выложена на tech.yandex.ru

Также у этого проекта есть:

• Wiki, в которой содержится полезная информация о Yandex Map Kit.
• JavaDoc, который находится в yandexmapkit-library/doc. В нем содержится описание классов и методов Yandex Map Kit.

Если вы хотите сообщить об ошибке или предложить идею в развитии, то напишите об этом, пожалуйста, в Issues.

Источник

max-im’sblog

четверг, 15 ноября 2012 г.

Пример использования яндекс карты SDK для ос Андроид.

Задача: написать активити, в котором можно будет перемещая метку на карте, менять координаты и наоборот, меняя координаты в ручную, перемещать метку по карте.

Подготовительный этап состоит из трех пунктов.

1. Для работы с yandex maps SDK необходимо в файле манифеста приложения прописать разрешения на интернет, приблизительную геолокацию и чтение состояния телефона:

2. В папку проекта libs помещаем две папки из SDK яндекса:
и файл библиотеки:

Кроме этого, необходимо: создать папку xml в проекте и туда поместить map_layers.xml в папку layout поместить screen_buttons_layout.xml в папку drawable файлы zoom_minus_drawable.xml, zoom_plus_drawable.xml, find_me_drawable.xml а в drawable-hdpi файлы из этого списка

3. Для работы с апи яндекса необходимо получить ключ.

Все, теперь можно использовать яндекс-карты для решения нашей задачи

Использование яндекс-карт в своем приложении.

Главное тут это указать свой ключ в аттрибуте android:apiKey. Поля для ввода имеют следующие идентификаторы: editX и editY. С разметкой все. Для работы с координатами удобно написать вспомогательный класс Coordinate: класс реализует интерфейс Parcelable, позволяет получать координату в виде строки или в виде числа с плавающей точкой.
Вторым вспомогательным классом будет customOverlay расширяющий класс из SDK DragAndDropOverlay у него будет конструктор:
И один перезагруженный метод
Два пояснения, первое — при тапе по карте, карта сдвигается так, чтобы метка(тайл) переместился на место тапа, второй момент, это блокирование слушателя изменения текста на полях(флаг mFlgBlockedTextChange, его добавим позже), куда пишутся координаты, чтобы не было рекурсивного зацикливания: вы меняете положение тайла, тем самым вызываете изменение текста, а это изменение текста вызывает перемещение тайла. Ещё один вспомогательный класс CoordsInputFilter, необходим, чтобы вводимые в текстовые поля данные были координатами, записанными в современном варианте:
Класс использует регулярное выражения для контроля вводимых данных. Его можно самостоятельно оптимизировать
Перейдем к написанию класса главной активити. Объявим необходимые приватные поля. Два поля для ввода координат (EditText) и сама карта:
Метка(тайл) на карте, который можно будет таскать пальцем по карте, тем самым изменять координаты:
Слой на карте, его опишем чуть позже
Два вспомогательных инструмента, первый – для изменения самой карты, второй — для изменения слоей на карте:
Сами координаты:
Битмап метки(тайла), который ставиться на карту:
Разделитель дробной и целой части.

Вообще этот путь неправильный, но.. Тут две заминки, первая – на некоторых моделях самсунга на цифровой клавиатуре нельзя поставить запятую на русской локали, только точку и вторая – координаты представляются в градусах в виде десятичной дроби, с разделителем в виде точки, это написано в вики. Ещё необходим флаг, для блокировки слушателя изменения текста:
Теперь опишем самого слушателя, для координаты икс:
Для координаты игрек аналогичный слушатель, в принципе можно создать свой класс, расширяющий TextWatcher и использовать один его экземпляр для обоих координат. С полями все. Теперь напишем перезагрузку методов, участвующих в жизненном цикле активити, главный метод, когда создается активити:
Тут фишка, когда состояние несохранено, загружаются координаты из файла настроек, причем, если его нет, устанавливаются координаты пригорода города Парижа. Однако, если активити восстанавливается после уничтожения(изменение конфигурации, например, ориентации экрана), то координаты так же восстановятся, а не будут загружены из файла снова. В принципе, в этом примере это действие ускорит старт активити на ничтожную величину. При уничтожении активити, мы будем сохранять текущие координаты в файл настройки:

Единственное, что осталось сделать это добавить меню с ссылкой на лиц. соглашения яндекс.Карт. Для этого в проекте создадим директорию menu с файлом, описывающим наше меню:
Чтобы меню работало, в активити перезагрузим два метода. Один для создания самого меню:
А другой для отслеживания нажатия пункта меню:
Всё. После выгрузки проекта на устройство или эмулятор картинка будет похожей

На всякий случай, строка ресурса с идентификатором R.string.ya выглядит так: «Приложение использует Яндекс-карты, условия использования сервиса Яндекс.Карты: http://legal.yandex.ru/maps_termsofuse» ссылка должна быть обязательной! Если что-то не получилось, можно добыть исходники на github

Источник