Часто задаваемые вопросы

Подробности о продукте

Сеть и подключение

Данные

Настройка пользовательского интерфейса

Маршрутизация

Симулятор

Рабочие процессы

Мобильные услуги

Подробности о продукте

В вашем приложении должно быть реализовано диалоговое окно с уведомлением об Условиях использования Navigation SDK, которое должен принять каждый пользователь. Этот диалог дает пользователю возможность согласиться с Условиями обслуживания. Текстовый файл условий предоставляется вместе с Navigation SDK. Используйте метод NavigationApi.showTermsAndConditionsDialog , чтобы отобразить диалоговое окно, содержащее термины.
Любые языки, поддерживаемые Google Maps Mobile, автоматически доступны для навигационного SDK. На устройстве установлен системный язык по умолчанию, и приложение не может изменить этот параметр; однако приложение имеет доступ к более чем 70 языкам.

Да. После запуска LocationListener продолжает работать в фоновом режиме. Ваше приложение продолжает фиксировать положение дороги и поддерживать направление.

Да. Когда маршрут создается или изменяется, RouteChangeListener предоставляет полилинии.

Нет, для навигационного SDK не требуется установка Google Maps Mobile на устройстве.
Нет, в настоящее время навигационный SDK не предоставляет эту функцию.
Да. Направление движения доступно и отображается по умолчанию.
Какие версии JDK поддерживает Navigation SDK?
Navigation SDK поддерживает LTS-версии Java SE, которые активно поддерживаются Oracle. Эти версии указаны как имеющие премьер-поддержку в плане поддержки Oracle Java SE .

Сеть и подключение

Как навигационный SDK справляется с плохим сетевым подключением?
Навигационный SDK предварительно кэширует маршрут для каждой поездки. Предварительно кэшированная информация включает в себя информацию о маршруте за 15-20 минут и альтернативы маршрута на случай отклонения пользователя от маршрута. Навигационный SDK определяет местоположение с помощью GPS и датчиков устройства.
Как навигационный SDK обрабатывает плохие или потерянные сигналы GPS?

После того как навигация запустится и Navigation SDK хотя бы один раз получит сигнал GPS, он отобразит сообщение «Поиск GPS...» в следующих ситуациях:

  • Если с момента последнего получения сигнала GPS прошло более 10 секунд.
  • Если позиция маршрута переместилась более чем на 500 м с момента последнего получения сигнала GPS.

Если SDK не получает GPS-сигнал в течение длительного периода времени, продвижение по маршруту, обозначенному в приложении положением шеврона, может замедлиться вплоть до полной остановки. В этом случае шеврон на карте останется в месте, указанном последним сигналом GPS. SDK не выйдет из режима навигации автоматически из-за отсутствия сигнала GPS. Однако он может быть не в состоянии обеспечить руководство, пока снова не получит сигнал.

Доступен ли автономный режим?
Нет, в настоящее время Navigation SDK не поддерживает автономный режим; однако SDK предоставляет предварительно кэшированную информацию о путешествии.

Данные

Могу ли я получить все остановки/пункты назначения в поездке перед началом маршрута?

Да. Чтобы получить указания по маршруту, вызовите Navigator.getRouteSegments() .

Доступно ли пошаговое руководство по маршруту в начале маршрута?
Да. Навигационный SDK предоставляет список сегментов маршрута. Кроме того, пользователь может пролистать карточку направлений в заголовке, чтобы увидеть каждый маневр.
Как ETA сообщается пользователям приложения?

Выполните следующие действия, чтобы предоставить пользователям приложения информацию о расчетном времени прибытия:

  1. Получите время и расстояние для всех путевых точек, используя Navigator.getTimeAndDistanceList() .
  2. Отправьте эту информацию клиентскому приложению так же, как вы делаете это для драйвера ETA.
Можно ли использовать RoadSnappedLocationProvider для получения текущего местоположения пользователя, если навигация не находится на переднем плане?

Да. RoadSnappedLocationProvider по умолчанию работает в фоновом режиме.

Поддерживает ли навигационный SDK геозону?

Нет. В контексте навигации remainingTimeOrdistanceChangeListener имеет преимущество перед геозоной. Геозона может не учитывать геометрию дороги и не быть сосредоточена точно на той точке, к которой движется пользователь.

Вы можете аппроксимировать эту функцию, используя remainingTimeOrdistanceChangeListener .

  1. Установите порог для определения частоты обратных вызовов.
  2. Проверьте оставшееся расстояние до пункта назначения.

Например, если вы установите пороговое значение 100 м, вы получите обратный вызов, когда расстояние до пункта назначения изменится на 100 м. По мере уменьшения расстояния вы можете обновить этот порог до меньшего значения и получать более частые обратные вызовы. Затем проверьте оставшееся расстояние, чтобы определить, достаточно ли вы близки к месту посадки/высадки.

Могу ли я отключить уведомления, когда приложение «Навигация» работает в фоновом режиме?

Да. Используйте Navigator.setHeadsUpNotificationEnabled для управления уведомлениями. Этот метод имеет логический аргумент. FALSE отключает уведомления; TRUE включает уведомления.

Регистратор транзакций отслеживает получение и возврат с помощью уникального идентификатора, который Google регистрирует в целях анализа продукта. Если вы являетесь клиентом мобильных служб , Google рекомендует вам внедрить NavigationTransactionRecorder для регистрации записей ваших транзакций.

Настройка пользовательского интерфейса

Могу ли я раскрасить лучший вариант маршрута?
Нет. Цветовое кодирование определенного варианта маршрута в настоящее время не поддерживается.
Может ли навигационный SDK отображать расчетное время прибытия для конечного пункта назначения?

Да. Используйте следующие методы:

  1. Получите время и расстояние для всех путевых точек, используя Navigator.getTimeAndDistanceList() .
  2. Скройте расчетное время прибытия текущей путевой точки, используя NavigationFragment.setEtaCardEnabled(false) .
  3. Отобразите расчетное время прибытия конечного пункта назначения.
Как я могу скрыть обновления ETA?

Вы можете отключить карты ETA, вызвав navigationView.setEtaCardEnabled(false) .

Какие настройки пользовательского интерфейса доступны для карточек верхнего и нижнего колонтитула?

Используйте StylingOptions , чтобы установить стиль цвета фона. Чтобы скрыть или отобразить верхний и нижний колонтитул, используйте функции-члены setHeaderEnabled и setFooterEnabled NavigationFragment .

Маршрутизация

Могу ли я предоставить пользователю конкретный маршрут или удалить альтернативные маршруты?
Нет. По умолчанию предоставляется несколько маршрутов, и самый быстрый маршрут имеет приоритет. Вы можете изменить маршрут по умолчанию, добавив к своему запросу такие настройки, как «избегать автомагистралей и платных дорог». Добавление путевых точек также влияет на маршрут.
Могу ли я показать пользователю приложения метку места назначения, отличную от местоположения назначения по умолчанию?

Да. Создайте Marker с собственным названием пункта назначения и широтой/долготой. Navigation SDK отображает пользовательский заголовок и координаты на NavigationMap .

Могу ли я использовать Navigation SDK для отслеживания отклонений от заданного пути?

Да. Используйте Navigator.setRouteChangedListener для получения уведомлений при изменении маршрута или рекомендации нового маршрута:

  1. Зарегистрируйте прослушиватель, который проверяет положение устройства на маршруте с помощью метода Navigator.setRouteChangedListener .
  2. Добавьте код в обработчик событий обратного вызова onRouteChanged :
    • Отправьте пользователю приложения сообщение с обновленной информацией о расчетном времени прибытия и расстоянии.
    • Отслеживайте местоположение устройства.
    • [необязательно] Добавьте другие функции, необходимые вашему приложению для обработки случаев, когда пользователь отклоняется от заданного маршрута.
Может ли пользователь выйти из навигации, не пройдя маршрут?

Да. Вызовите метод Navigator.stopGuidance() чтобы остановить навигацию.

Симулятор

Поддерживает ли симулятор изменения маршрута?

Да. Вызовите simulateLocationsAlongNewRoute , чтобы смоделировать путешествие, включающее изменение маршрута. Метод simulateLocationsAlongExistingRoute игнорирует изменения существующего маршрута.

Рабочие процессы

Как закрыть уведомление после закрытия активности, содержащей фрагмент навигации?

Уведомление о навигации остается видимым во время навигации, когда действие закрыто. Когда автомобиль прибудет в пункт назначения, навигация прекратится, а уведомление исчезнет.

Для обработки кликов по уведомлению используйте Navigator.startGuidance(intent resumeIntent) . resume intent срабатывает, когда пользователь приложения щелкает уведомление. Обычно Navigator.startguidance(getIntent()) вызывается из основного действия, которое вызывает действие, когда пользователь приложения щелкает уведомление.

Мобильные услуги

Чем отличается использование Navigation SDK для клиентов мобильных услуг?

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

Мобильные продукты в настоящее время доступны только избранным клиентам. Свяжитесь с вашим торговым представителем для получения дополнительной информации.

Как узнать, являюсь ли я клиентом мобильных услуг?
Если вы не уверены, реализуете ли вы в настоящее время навигационный SDK в качестве клиента мобильных служб, найдите в своем коде вызов ReportBillableEvent . Только клиенты мобильных служб должны вызывать метод ReportBillableEvent .

Как выставляется счет за навигационный SDK для клиентов мобильных служб?
Для клиентов мобильных служб выставление счетов и цены на навигационный SDK зависят от соглашения об обслуживании, заключенного с платформой Google Maps. Информацию о том, как обеспечить правильность выставления счетов за реализацию мобильных служб, см. в разделе Проверка выставления счетов . Для получения дополнительной информации о выставлении счетов за мобильные услуги обратитесь к своему торговому представителю.

Какие API-интерфейсы Navigation SDK следует использовать только клиентам мобильных служб?

В навигационном SDK есть несколько API, которые предназначены только для клиентов мобильных служб , которым Google выставляет счета за каждую транзакцию. Если вы не являетесь клиентом мобильных услуг, следующие методы бесполезны:

Если я являюсь клиентом мобильных служб, могу ли я также использовать реализацию навигационного SDK, не связанную с мобильными службами?

Да, клиенты мобильных служб могут использовать реализации Navigation SDK как для мобильных служб, так и для не-мобильных служб. Однако одновременно в приложении можно использовать только один тип реализации. Вам также необходимо создать новый проект Google Cloud, учетную запись для выставления счетов и ключ API отдельно от тех, которые вы используете при реализации мобильных сервисов. Дополнительную информацию см. в обзоре настройки Navigation SDK .

Для получения дополнительной информации об использовании реализации Navigation SDK, не связанной с мобильными службами, включая перенос приложения из одного типа реализации в другой, обратитесь к представителю своего аккаунта Google.

Примечание. Если вы в настоящее время не являетесь клиентом Mobility Services и хотите узнать больше о наборе API и SDK Mobility Services, обратитесь в отдел продаж платформы Google Maps .