Демоверсия

Интеграция Navigation SDK для Android позволит вашему приложению выйти за рамки ссылки на внешний вид карты. С навигацией Google Maps ваше приложение может предложить динамическое извлечение и единый отчет о данных о пути пользователя. В этом руководстве объясняется, как запустить демонстрационные приложения Navigation SDK, которые доступны на GitHub.

Приготовьтесь

Чтобы начать работу с Navigation SDK, убедитесь, что у вас есть следующие элементы.

• Ключ API, предоставленный для использования с Navigation SDK. См. Использование ключей API для получения дополнительной информации о создании и ограничении ключей.
• Артефакт SDK. Убедитесь, что ваш проект настроен на использование Maven для Navigation SDK.
• Одно или несколько демонстрационных приложений .
• Android Studio — рекомендуемая среда разработки для создания приложений с помощью Navigation SDK.

Эта документация предназначена для людей, знакомых с разработкой Android и концепциями объектно-ориентированного программирования. Вы также должны быть знакомы с Google Maps с точки зрения пользователя.

Примечание: Если ваше приложение уже использует Maps SDK , Navigation SDK заменяет Maps SDK как для слоя карты, так и для функций навигации. Вы не можете использовать Navigation SDK и Maps SDK в одном приложении.

Получить демо-приложения

Google предоставляет два приложения, которые помогут вам понять, что Navigation SDK предлагает поверх API Google Maps, в зависимости от вашего уровня опыта. Разработчики, знакомые с API Google Maps, могут сосредоточиться на демоверсии GoogleNavigation. Разработчики, впервые работающие с обоими проектами, найдут оба приложения полезными.

Начиная с версии Navigation SDK для Android v4.1, на GitHub доступны для загрузки следующие демонстрационные приложения.

• Демонстрация GoogleNavigation : демонстрирует интеграцию поведений и представлений API, связанных с взаимодействием пользователя с сеансом управляемой навигации .

• Демонстрация GoogleMap : демонстрирует отдельные варианты поведения интерфейса GoogleMap для настройки внешнего вида и представления карт.

Демонстрация GoogleNavigation

Последняя демоверсия GoogleNavigation доступна на GitHub .

Строить

1. В Android Studio импортируйте демонстрационное приложение и разрешите запуск Gradle.

   Примечание: приложение не сможет загрузить карту, пока вы не обновите local.defaults.properties с помощью предоставленного ключа API.

2. Откройте local.defaults.properties и обновите значение свойства MAPS_API_KEY :

     MAPS_API_KEY=YOUR_API_KEY
   

3. Нажмите «Сборка» и изучите детали реализации SDK.

   • В классе Java обратите внимание на код реализации.

   • В XML-макете обратите внимание на дизайн макета и текст.

   • В файле build.gradle обратите внимание на SDK в зависимостях.

Дополнительную информацию о том, как ключ API добавляется в манифест, см. в документации плагина Secrets Gradle.

Бегать

1. Подключите Android-устройство к компьютеру или используйте эмулятор.

   • Устройство Android — ознакомьтесь с инструкциями по включению параметров разработчика на вашем устройстве Android и настройке системы для обнаружения устройства.
   • Эмулятор — используйте Android Virtual Device (AVD) Manager для настройки виртуального устройства. При выборе эмулятора убедитесь, что вы выбрали образ, включающий API Google.

2. В Android Studio щелкните пункт меню «Выполнить» (или значок кнопки воспроизведения), а затем выберите цель развертывания.

После создания и запуска приложение предоставляет пользователю целевую страницу со списком опций.

Параметры NavViewActivity и NavFragmentActivity

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

Вариант 1 : NavViewActivity демонстрирует поведение с использованием NavigationView в сочетании с Navigator .

Вариант 2 : Второй вариант, названный NavFragmentActivity , демонстрирует поведение с использованием SupportNavigationFragment вместе с Navigator .

Примечание: В большинстве случаев мы рекомендуем использовать SupportNavigationFragment , который является оболочкой для NavigationView , вместо прямого взаимодействия с NavigationView . Для получения дополнительной информации см. раздел Navigation map interaction best practices .

При выборе одного из этих вариантов вам будет представлено следующее:

• навигационный интерфейс
• кнопка «Установить пункт назначения» в меню приложения
• наложение, с которым можно взаимодействовать для динамического вызова методов API
• дополнительное меню с дополнительными опциями

Чтобы начать, нажмите «Установить пункт назначения» и выберите адрес. Затем приложение имитирует поездку из вашего текущего местоположения по этому адресу. Используйте наложение панелей управления, чтобы увидеть, что происходит при вызове API. Например, нажмите «Просмотреть методы» , чтобы попытаться принудительно перевести SDK в ночной режим и посмотреть, как это выглядит.

Параметр SwappingMapAndNavActivity

Примечание: эта опция поможет вам в переходе с v1 на v4. Мы рекомендуем использовать NavigationView исключительно там, где это возможно, но приводим это в качестве примера того, как использовать оба варианта одновременно.

SwappingMapAndNavActivity демонстрирует следующие общие шаблоны:

• отображение MapView
• переключение на NavigationView при начале навигации
• возврат к MapView после завершения навигации

Демонстрация GoogleMap

Последняя демоверсия GoogleNavigation доступна на GitHub .

Примечание: Для получения дополнительной информации о взаимодействии с объектом GoogleMap в вашем приложении см. Рекомендации по взаимодействию GoogleMap .

Строить

1. В Android Studio импортируйте демонстрационное приложение и разрешите запуск Gradle.

   Примечание: приложение не сможет загрузить карту, пока вы не обновите local.defaults.properties с помощью предоставленного ключа API.

2. Откройте local.defaults.properties и обновите значение свойства MAPS_API_KEY :

     MAPS_API_KEY=YOUR_API_KEY
   

3. Нажмите «Сборка» и изучите детали реализации SDK.

   • В классе Java обратите внимание на код реализации.

   • В XML-макете обратите внимание на дизайн макета и текст.

   • В файле build.gradle обратите внимание на SDK в зависимостях.

Дополнительную информацию о том, как ключ API добавляется в манифест, см. в плагине Gradle Secrets.

Бегать

1. Подключите Android-устройство к компьютеру или используйте эмулятор.

   • Устройство Android Ознакомьтесь с инструкциями по включению параметров разработчика на вашем устройстве Android и настройке системы для обнаружения устройства.
   • Эмулятор Используйте Android Virtual Device (AVD) Manager для настройки виртуального устройства. При выборе эмулятора убедитесь, что вы выбрали образ, включающий API Google.

2. В Android Studio щелкните пункт меню «Выполнить» (или значок кнопки воспроизведения), а затем выберите цель развертывания.

После создания и запуска приложение предоставляет пользователю целевую страницу со списком демонстраций.

Этот шаблон представления и соответствующая структура исходного кода должны быть знакомы пользователям демонстраций Google Maps SDK. Это связано с тем, что демонстрация GoogleMap разработана так, чтобы быть похожей на демонстрационное приложение Maps API . Основное отличие заключается в том, что демонстрация Navigation SDK позволяет пользователю выбирать, на каком классе представления он хотел бы протестировать демонстрацию: NavigationView или MapView , где это применимо.

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

Важно: Классы MapView , MapFragment и SupportMapFragment требуют, чтобы на устройствах было установлено приложение служб Google Play. Если вы запустите новый эмулятор или сбросите настройки очень старого устройства, образ Android может поставляться с очень устаревшими предустановленными службами Google Play. В таких случаях вам придется подождать, пока он автоматически загрузит более новую версию, или вручную обновить службы Play через Google Play Store.