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

Скоро на платформе Google Maps появится новый стиль карт. Это обновление стиля карты включает новую цветовую палитру по умолчанию и улучшения интерфейса и удобства использования карты. Все стили карт будут автоматически обновлены в марте 2025 г. Дополнительную информацию о доступности и о том, как принять участие раньше, см. в разделе «Новый стиль карты для платформы Google Maps ».

Эта страница переведена с помощью Cloud Translation API.

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

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

Как должно отображаться уведомление об Условиях использования Navigation SDK?

В вашем приложении должно быть реализовано диалоговое окно с уведомлением об Условиях использования Navigation SDK, которое должен принять каждый драйвер. Это диалоговое окно дает водителю возможность согласиться с Условиями обслуживания. Текстовый файл условий предоставляется вместе с Navigation SDK.

В Android используйте метод NavigationApi.showTermsAndConditionsDialog чтобы отобразить диалоговое окно, содержащее термины.

В iOS вызовите GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName .

Какие языки поддерживаются голосовыми указаниями?

Любые языки, поддерживаемые Google Maps Mobile, автоматически доступны для навигационного SDK. На устройстве установлен системный язык по умолчанию, и приложение не может изменить этот параметр; однако приложение имеет доступ к более чем 70 языкам.

Сохраняется ли пеленг при выходе водителя из режима навигации?

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

В iOS, чтобы продолжать получать обновления местоположения и направления в фоновом режиме, реализуйте привязку дорог и установите для allowsBackgroundLocationUpdates значение YES .

Доступны ли полилинии при запуске или изменении маршрута?

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

Необходимо ли пользователям приложения устанавливать Google Maps Mobile?

Нет, для навигационного SDK не требуется установка Google Maps Mobile на устройстве.

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

Нет, навигационный SDK в настоящее время не предоставляет эту функциональность.

Показывает ли Navigation SDK направление движения по полосам движения при приближении к поворотному моменту?

Да. Направление движения доступно и отображается по умолчанию.

Проблемы

В Xcode 12 приложения для симулятора создаются неправильно. Как я могу это исправить?

Чтобы устранить эту проблему, откройте настройки сборки проекта Xcode и добавьте arm64 в список Excluded Architectures только для сборок «iOS Simulator».

Для получения дополнительной информации см. следующую ветку StackOverflow .

GMSMapView не загружается.

Если GMSMapView не загружается:

Убедитесь, что NavSDK включен в Cloud Console.
Если Nav SDK установлен, но ваш проект не использует API-интерфейсы Nav SDK, удалите его из двоичного файла.

Сеть

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

Данные

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

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

В iOS вызовите GMSNavigator.routeLegs(read) .

Доступно ли пошаговое руководство по маршруту в начале маршрута?

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

Как ETA сообщается пользователям приложения?

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

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

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

Получите этапы путешествия с помощью Navigator.getRouteSegments() .
Вызовите GMSNavigator.timeToNextDestination для каждого участка пути.
Пересылайте информацию о времени в клиентское приложение, как вы сейчас делаете это для драйвера ETA.

Можно ли использовать RoadSnappedLocationProvider для получения текущего местоположения водителя, если навигация не находится на переднем плане?

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

В iOS, чтобы навигация работала в фоновом режиме, реализуйте прослушиватель для GMSRoadSnappedLocationProviderListener и установите для allowsBackgroundLocationUpdates значение TRUE .

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

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

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

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

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

В iOS реализуйте прослушиватель GMSNavigatorListener.didUpdateRemainingDistance для управления расстоянием между уведомлениями.

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

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

В iOS отключите фоновое уведомление для местоположений с привязкой к дороге, задав для GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates значение NO.

Чтобы отключить фоновую обработку других уведомлений о местоположении, вызовите GMSNavigator.sendsBackgroundNotifications(NO) .

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

Могу ли я раскрасить лучший вариант маршрута?

Нет. Цветовое кодирование определенного варианта маршрута в настоящее время не поддерживается.

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

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

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

В iOS используйте следующее:

Вызовите GMSNavigator.routeLegs(read) .
На последнем этапе вызовите GMSNavigator.timeToNextDestination .
Скройте расчетное время прибытия текущей путевой точки, используя для MSMapView.settings.navigationFooterEnabled=NO значение FALSE.
Отобразите расчетное время прибытия конечного пункта назначения.

Как я могу скрыть обновления ETA?

Вы можете отключить карты ETA следующими способами:

В Android используйте navigationView.setEtaCardEnabled(false) .
В iOS используйте GMSMapView.settings.navigationFooterEnabled=NO .

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

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

В iOS используйте GMSMapView.settings.navigationHeaderPrimaryBackgroundColor чтобы установить стиль цвета фона. Чтобы скрыть или показать верхний и нижний колонтитул, используйте свойства navigationFooterEnabled и navigationHeaderEnabled GMSUISettings .

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

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

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

Могу ли я показать пользователю приложения метку места назначения, отличную от местоположения назначения по умолчанию?

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

В iOS вы создаете и отображаете GMSMarker для пункта назначения.

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

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

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

В iOS используйте GMSNavigator и его прослушиватели для получения уведомлений при изменении маршрута или рекомендации нового маршрута:

В контроллере представления карты реализуйте протокол GMSNavigatorListener и протокол GMSRoadSnappedLocationProviderListener .
Реализуйте GMSNavigatorListener.navigatorDidChangeRoute .
Получите доступ к новому маршруту, используя свойства routeLegs и currentRouteLeg GMSNavigator .

Может ли водитель выйти из навигации, не пройдя маршрут?

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

В iOS вызовите GMSNavigator.clearDestinations .

Симулятор

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

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

В iOS используйте GMSLocationSimulator.simulateAlongNewRouteToDestinations , чтобы имитировать путешествие, включающее изменение маршрута. Если вы не ожидаете каких-либо изменений маршрута, вы можете использовать GMSLocationSimulator.simulateLocationsAlongExistingRoute или GMSLocationSimulator.simulateAlongNewRouteToDestinations .

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

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

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

Для обработки кликов по уведомлению используйте 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 .