Демоверсия

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

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

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

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

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

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

Начиная с Navigation SDK для Android версии 4.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 и настроить систему для обнаружения устройства.
    • Эмулятор mdash;Используйте диспетчер виртуальных устройств Android (AVD) для настройки виртуального устройства. Выбирая эмулятор, убедитесь, что вы выбрали образ, включающий 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 в зависимостях.

См. плагин secrets gradle для получения дополнительной информации о том, как ключ API добавляется в манифест.

Бег

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

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

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

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

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

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