Демоверсия

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

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

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

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

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

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.

  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 щелкните пункт меню «Выполнить» (или значок кнопки воспроизведения), а затем выберите цель развертывания.

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

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

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

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

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

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

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

Параметр SwappingMapAndNavActivity

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

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

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

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

Строить

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

  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 в ситуациях, когда вы используете стороннюю библиотеку, которая ожидает взаимодействия с этим классом.