Благодаря интеграции Navigation SDK для Android ваше приложение может выйти за рамки простого подключения к внешнему представлению карты. Благодаря навигации Google Maps ваше приложение может предлагать динамический поиск и единый отчет о данных о поездке водителя.
В этом руководстве представлен проект Android Studio, показано, как интегрировать навигационный SDK, а затем показано, как запускать демонстрационные приложения.
Navigation SDK — это статическая библиотека, которая позволяет вам контролировать внешний вид и звук навигации в вашем приложении. Для получения подробной информации о библиотеке откройте справочник Navigation SDK (Javadoc) в отдельном окне.
Приготовься
Чтобы начать работу с Navigation SDK, убедитесь, что у вас есть следующие элементы.
Представитель платформы Google Maps для доступа к следующему:
- Ключ API, предоставленный для использования с навигационным SDK. Вам необходимо указать свой идентификатор проекта, который вы можете найти на главной панели управления Google Cloud Console под названием проекта.
- Артефакт SDK. Убедитесь, что ваш проект настроен на использование Maven для навигационного SDK.
- Для проектов, использующих v4.99.0 и более ранние версии . Если вы не можете использовать Maven, вы можете загрузить заархивированный артефакт с общего Google Диска . Файл статической библиотеки — это файл .aar в каталоге
libs/, содержащий навигационный SDK в виде пакета AAR . - Одно или несколько демонстрационных приложений .
Android Studio — рекомендуемая среда разработки для создания приложений с помощью Navigation SDK.
Эта документация предназначена для людей, знакомых с разработкой Android и концепциями объектно-ориентированного программирования. Вы также должны быть знакомы с Картами Google с точки зрения пользователя.
Получите демо-приложения
Google предоставляет два приложения, которые помогут вам понять, что предлагает Navigation SDK помимо API Google Maps, в зависимости от вашего уровня опыта. Разработчики, знакомые с API Карт Google, могут сосредоточить свое внимание на демо-версии GoogleNavigation. Разработчики, плохо знакомые с обоими проектами, найдут оба приложения полезными.
Начиная с Navigation SDK для Android версии 4.1, следующие демонстрационные приложения доступны для скачивания на общем Google Диске .
Демонстрация GoogleNavigation : демонстрирует интеграцию поведения и представлений API, связанных с взаимодействием пользователя во время сеанса управляемой навигации .
Демонстрация GoogleMap : демонстрирует индивидуальное поведение интерфейса
GoogleMapдля настройки внешнего вида и представления карт.
Примечание по использованию Maven
Демонстрационные приложения настроены на загрузку артефакта SDK из удаленного репозитория Maven с помощью плагина реестра артефактов в Gradle. Обязательно следуйте инструкциям по настройке проекта , чтобы получить доступ к SDK.
Демонстрация GoogleNavigation
Последняя демоверсия GoogleNavigation доступна в корне общего Google Диска . Предыдущие версии приложения существуют в «Архиве». Для версий до 4.1 приложение поставляется вместе с AAR в одном ZIP-файле.
Здание
В Android Studio импортируйте демонстрационное приложение и разрешите запуск Gradle.
Откройте
local.defaults.propertiesи обновите значение свойстваMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYНажмите « Создать» и изучите детали реализации SDK.
Обратите внимание на код реализации в классе Java.
В XML-файле макета обратите внимание на дизайн и текст макета.
В файле
build.gradleобратите внимание на SDK в зависимостях.
Дополнительную информацию о том, как ключ API добавляется в манифест, см. в документации плагина Secrets Gradle .
Бег
Подключите Android-устройство к компьютеру или воспользуйтесь эмулятором.
- Устройство Android — обратитесь к инструкциям , чтобы включить параметры разработчика на вашем устройстве Android и настроить систему для обнаружения устройства.
- Эмулятор mdash;Используйте диспетчер виртуальных устройств Android (AVD) для настройки виртуального устройства. Выбирая эмулятор, убедитесь, что вы выбрали образ, включающий API Google.
В Android Studio щелкните пункт меню «Выполнить» (или значок кнопки воспроизведения); а затем выберите цель развертывания.
После сборки и запуска приложение представляет пользователю целевую страницу со списком опций.
Параметры NavViewActivity и NavFragmentActivity.
Новые пользователи NavSDK, скорее всего, найдут эти два варианта наиболее полезными.
Вариант 1 : NavViewActivity демонстрирует поведение, используя NavigationView в сочетании с Navigator .
Вариант 2. Второй вариант под названием NavFragmentActivity демонстрирует поведение с использованием SupportNavigationFragment вместе с Navigator .
Когда вы нажмете одну из этих опций, вам будет представлено следующее:
- интерфейс навигации
- кнопка «Установить пункт назначения» в меню приложения.
- наложение, с которым вы можете взаимодействовать для динамического вызова методов API.
- дополнительное меню с дополнительными опциями
Чтобы начать, нажмите «Установить пункт назначения» и выберите адрес. Затем приложение имитирует поездку от вашего текущего местоположения до этого адреса. Используйте наложение панелей управления, чтобы увидеть, что происходит при вызове API. Например, вы можете нажать «Просмотреть методы» , чтобы попробовать перевести SDK в ночной режим и посмотреть, как он выглядит.
Параметр SwappingMapAndNavActivity
SwappingMapAndNavActivity демонстрирует следующие распространенные шаблоны:
- отображение
MapView - переключение на
NavigationView, когда начинается навигация - возврат к
MapViewпосле завершения навигации
Демонстрация GoogleMap
Последняя демоверсия GoogleNavigation доступна в корне общего Google Диска . Предыдущие версии приложения существуют в «Архиве».
Здание
В Android Studio импортируйте демонстрационное приложение и разрешите запуск Gradle.
Откройте
local.defaults.propertiesи обновите значение свойстваMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYНажмите « Создать» и изучите детали реализации SDK.
Обратите внимание на код реализации в классе Java.
В XML-файле макета обратите внимание на дизайн и текст макета.
В файле
build.gradleобратите внимание на SDK в зависимостях.
См. плагин secrets gradle для получения дополнительной информации о том, как ключ API добавляется в манифест.
Бег
Подключите Android-устройство к компьютеру или воспользуйтесь эмулятором.
- Устройство Android См. инструкции , чтобы включить параметры разработчика на вашем устройстве Android и настроить систему на обнаружение устройства.
- Эмулятор Используйте диспетчер виртуальных устройств Android (AVD) для настройки виртуального устройства. Выбирая эмулятор, убедитесь, что вы выбрали образ, включающий API Google.
В Android Studio щелкните пункт меню «Выполнить» (или значок кнопки воспроизведения); а затем выберите цель развертывания.
После сборки и запуска приложение представляет пользователю целевую страницу со списком демонстраций.
Этот шаблон представления и соответствующая структура исходного кода должны быть знакомы пользователям демонстрационных версий Google Maps SDK. Это связано с тем, что демо-версия GoogleMap аналогична демонстрационному приложению Maps API . Основное отличие состоит в том, что демо-версия Navigation SDK позволяет пользователю выбрать, на каком классе представления он хотел бы протестировать демонстрационную версию: NavigationView или MapView , где это применимо.
Google обычно рекомендует пользователям использовать NavigationView . Эта демонстрация дает возможность опробовать эти варианты поведения в обеих версиях нашего демонстрационного приложения и выбрать ту, которая подходит именно вам. Например, по-прежнему может потребоваться использование MapView в ситуациях, когда вы используете стороннюю библиотеку, которая ожидает взаимодействия с этим классом.