Демоверсия

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

Будьте готовы

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

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

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

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

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

Google предлагает два приложения, которые помогут вам разобраться в возможностях Navigation SDK в сочетании с API Google Карт, в зависимости от вашего уровня опыта. Разработчики, знакомые с API Google Карт, могут обратить внимание на демонстрационную версию 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 (AVD) для настройки виртуального устройства. При выборе эмулятора убедитесь, что выбранный вами образ включает API Google.

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

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

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

Новые пользователи NavSDK, вероятно, сочтут эти два варианта наиболее полезными.

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

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

Примечание: В большинстве случаев мы рекомендуем использовать SupportNavigationFragment — оболочку для NavigationView — вместо прямого взаимодействия с NavigationView . Подробнее см. в разделе «Рекомендации по взаимодействию с навигационной картой» .

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

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

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

Параметр SwappingMapAndNavActivity

Примечание: эта опция поможет вам при переходе с версии 1 на версию 4. Мы рекомендуем использовать только 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 Manager (AVD) для настройки виртуального устройства. При выборе эмулятора убедитесь, что выбранный вами образ включает 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.