Синглтон, предоставляющий методы управления навигацией.
Все методы гарантированно потокобезопасны, за исключением setAudioGuidance и setHeadsUpNotificationEnabled, которые необходимо вызывать в потоке пользовательского интерфейса.
Сводка вложенных классов
| интерфейс | Navigator.ArrivalListener | Определяет сигнатуры методов, которые вызываются, когда водитель прибывает в точку маршрута. | |
| @интерфейс | Навигатор.АудиоГиданс | AudioGuidance — это набор флагов, используемых для указания того, какие виды звуковых оповещений и указаний используются во время навигации. | |
| интерфейс | Navigator.RemainingTimeOrDistanceChangedListener | Определяет сигнатуры методов, которые вызываются при изменении оставшегося времени или расстояния до следующего пункта назначения. | |
| интерфейс | Navigator.RouteChangedListener | Определяет сигнатуры методов, которые вызываются при изменении маршрута. | |
| перечисление | Навигатор.RouteStatus | RouteStatus — это код состояния, который представляет результат расчета маршрута, доступ к которому осуществляется через Future, возвращаемый setDestination(Waypoint) . | |
Краткое описание общедоступного метода
| абстрактная пустота | уборка () Очищает внутреннее состояние Навигатора. |
| абстрактная пустота | ОчиститьНазначения () Очищает все ранее установленные пункты назначения и удаляет все рассчитанные маршруты с карты. |
| абстрактная пустота | ClearLicensePlateRestrictionInfo () Очищает информацию о номерном знаке текущего водителя. |
| абстрактная пустота | ClearRemainingTimeOrDistanceChangedListener () Очищает прослушиватель от изменений оставшегося времени или расстояния. |
| абстрактная путевая точка | continueToNextDestination () Удаляет текущий пункт назначения. |
| абстрактный ListenableResultFuture <RouteInfo> | fetchRouteInfo ( путевая точка, RoutingOptions RouteOptions) Возвращает информацию о маршрутах на основе каждого значения RoutingOptions.RoutingStrategy . |
| абстрактный сегмент маршрута | getCurrentRouteSegment () Возвращает текущий этап пути. |
| абстрактное время и расстояние | getCurrentTimeAndDistance () Возвращает расчетное время и расстояние от текущей позиции до текущего пункта назначения. |
| абстрактный список <RouteSegment> | getRouteSegments () Возвращает список сегментов маршрута. |
| абстрактный симулятор | получитьСимулятор () Возвращает объект Simulator для использования во время тестирования. |
| абстрактный список <TimeAndDistance> | getTimeAndDistanceList () Возвращает список времени и расстояний, соответствующих каждому пункту назначения на текущем маршруте, представляющий расчетное время и расстояние от текущей позиции до каждого пункта назначения. |
| абстрактный список < LatLng > | getTraveledRoute () Возвращает маршрут, пройденный на данный момент во время этого сеанса навигации (с момента последнего вызова startGuidance() ). |
| абстрактное логическое значение | isGuidanceRunning () Возвращает true , если руководство в данный момент выполняется. |
| абстрактная пустота | setArrivalListener (прослушиватель Navigator.ArrivalListener ) Регистрирует прослушиватель событий прибытия. |
| абстрактная пустота | setAudioGuidance (целое руководство) Устанавливает, какие типы звуковых указаний (включая вибрацию) включены. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestination (пункт назначения маршрутной точки , RoutingOptions routerOptions, DisplayOptions displayOptions) Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestination (пункт назначения маршрутной точки , параметры RoutingOptions ) Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestination ( пункт назначения) Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestinations (Список пунктов назначения < Waypoint >, параметры RoutingOptions ) Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestinations (Список пунктов назначения < Waypoint >, RoutingOptions routerOptions, DisplayOptions displayOptions) Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактный ListenableResultFuture < Navigator.RouteStatus > | setDestinations (Список < Маршрутные точки > пункты назначения) Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. |
| абстрактная пустота | setHeadsUpNotificationEnabled (логическое значение включено) Устанавливает, следует ли отображать всплывающие уведомления. |
| абстрактная пустота | setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode) Устанавливает информацию о номерном знаке текущего водителя. |
| абстрактная пустота | setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener прослушиватель) Регистрирует прослушиватель на случай, если оставшееся время или расстояние до пункта назначения изменится более чем на указанное пороговое значение. |
| абстрактная пустота | setRouteChangedListener (прослушиватель Navigator.RouteChangedListener ) Регистрирует прослушиватель событий изменения маршрута. |
| абстрактная пустота | setSpeedingListener ( SpeedingListener SpeedingListener) Регистрирует SpeedingListener для определения процента превышения ограничения скорости, с которым в данный момент движется водитель. |
| абстрактная пустота | startGuidance (Намерение резюмеIntent) То же, что startGuidance() , но с указанием намерения, которое можно использовать для возобновления работы приложения из уведомления в строке состояния навигатора. |
| абстрактная пустота | начатьРуководство () Если пункт назначения задан и для него рассчитан маршрут, запускается пошаговая навигация по маршруту. |
| абстрактная пустота | стопРуководство () Останавливает пошаговое навигационное руководство. |
Публичные методы
публичная абстрактная очистка пустоты ()
Очищает внутреннее состояние Навигатора.
Примечание. вызов этого метода отменит все ожидающие запросы к setDestinations(List )setDestinations(List ) .
public абстрактная пустота ClearDestinations ()
Очищает все ранее установленные пункты назначения и удаляет все рассчитанные маршруты с карты. Если навигация работает, это автоматически остановит ее.
public Abstract void ClearLicensePlateRestrictionInfo ()
Очищает информацию о номерном знаке текущего водителя. Это будет применяться только к вызовам setDestination, сделанным после установки этого значения.
public Abstract void ClearRemainingTimeOrDistanceChangedListener ()
Очищает прослушиватель от изменений оставшегося времени или расстояния.
общедоступная абстрактная путевая точка continueToNextDestination ()
Удаляет текущий пункт назначения. После этого вызова направление будет направлено к следующему пункту назначения, а информация о старом пункте назначения недоступна.
Возврат
- руководство по путевой точке теперь движется к нулю или к нулю, если путевых точек больше не осталось
общедоступный абстрактный ListenableResultFuture <RouteInfo> fetchRouteInfo ( путевая точка, RoutingOptions routerOptions)
Возвращает информацию о маршрутах на основе каждого значения RoutingOptions.RoutingStrategy . RoutingOptions.RoutingStrategy игнорируется, поскольку этот метод возвращает информацию о маршруте для всех стратегий маршрутизации.
Примечание. Это значение пересчитывается при каждом вызове и может не соответствовать маршрутам, которые в настоящее время используются для навигации, поскольку за это время могли быть обновлены данные о трафике и других факторах.
Параметры
| путевая точка | точка назначения маршрута |
|---|---|
| Параметры маршрутизации | параметры, используемые для получения информации о маршруте |
Возврат
- возвращенное будущее
общедоступный абстрактный RouteSegment getCurrentRouteSegment ()
Возвращает текущий этап пути. Этот RouteSegment будет иметь начальную позицию как самую последнюю известную (с привязкой к дороге) позицию устройства.
Возврат
- объект сегмента маршрута или
null, если текущего маршрута нет.
публичный абстрактный TimeAndDistance getCurrentTimeAndDistance ()
Возвращает расчетное время и расстояние от текущей позиции до текущего пункта назначения.
Возврат
- объект времени и расстояния или
null, если текущего маршрута нет
общедоступный абстрактный список < RouteSegment > getRouteSegments ()
Возвращает список сегментов маршрута. Пункт назначения каждого возвращенного сегмента будет соответствовать пункту назначения, установленному setDestination(s).
публичный абстрактный симулятор getSimulator ()
Возвращает объект Simulator для использования во время тестирования.
общедоступный абстрактный список < TimeAndDistance > getTimeAndDistanceList ()
Возвращает список времени и расстояний, соответствующих каждому пункту назначения на текущем маршруте, представляющий расчетное время и расстояние от текущей позиции до каждого пункта назначения.
общедоступный абстрактный список < LatLng > getTraveledRoute ()
Возвращает маршрут, пройденный на данный момент во время этого сеанса навигации (с момента последнего вызова startGuidance() ). Записанный маршрут состоит из привязанных к дороге местоположений, которые будут возвращены RoadSnappedLocationProvider , и упрощен для удаления избыточных точек, например превращения последовательных коллинеарных точек в один сегмент линии.
общедоступное абстрактное логическое значение isGuidanceRunning ()
Возвращает true , если руководство в данный момент выполняется. Обратите внимание, что руководство будет выполняться только после расчета маршрута к пункту назначения и вызова startGuidance() .
public Abstract void setArrivalListener (прослушиватель Navigator.ArrivalListener )
Регистрирует прослушиватель событий прибытия. Переопределяет любые ранее зарегистрированные прослушиватели.
Примечание. Чтобы избежать утечек памяти, setNavArrivalListener(null) следует вызывать, когда прослушиватель больше не требуется.
Параметры
| слушатель | слушатель зарегистрироваться. Может быть установлено значение null , чтобы очистить ранее зарегистрированный прослушиватель. |
|---|
public Abstract void setAudioGuidance (int Guide)
Устанавливает, какие типы звуковых указаний (включая вибрацию) включены. По умолчанию вибрация, голос и передача голоса по Bluetooth (если доступно) включены.
Этот метод необходимо вызывать в потоке пользовательского интерфейса.
Параметры
| руководство | комбинация флагов Navigator.AudioGuidance , определяющая, какие типы звуковых указаний следует включить |
|---|
общедоступный абстрактный ListenableResultFuture < Navigator.RouteStatus > setDestination (пункт назначения маршрутной точки , RoutingOptions RouteOptions, DisplayOptions displayOptions)
Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения.
Параметры
| место назначения | новый пункт назначения, который нужно установить |
|---|---|
| Параметры маршрутизации | параметры, которые будут использоваться для создания маршрута |
| Показать варианты | параметры, которые будут использоваться для отображения маршрута |
Возврат
- возвращенное будущее
Броски
| Исключение нулевого указателя | если данный пункт назначения равен нулю |
|---|
public Abstract ListenableResultFuture < Navigator.RouteStatus > setDestination (пункт назначения маршрутной точки , параметры RoutingOptions )
Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения. Для отображения маршрута будут использоваться параметры DisplayOptions по умолчанию.
Параметры
| место назначения | новый пункт назначения, который нужно установить |
|---|---|
| параметры | параметры, которые будут использоваться для создания маршрута |
Возврат
- возвращенное будущее
Броски
| Исключение нулевого указателя | если данный пункт назначения равен нулю |
|---|
public Abstract ListenableResultFuture < Navigator.RouteStatus > setDestination ( пункт назначения)
Устанавливает единый пункт назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения. Параметры RoutingOptions по умолчанию будут использоваться для поиска маршрута, а параметры DisplayOptions по умолчанию будут использоваться для его отображения.
Параметры
| место назначения | новый пункт назначения, который нужно установить |
|---|
Возврат
- возвращенное будущее
Броски
| Исключение нулевого указателя | если данный пункт назначения равен нулю |
|---|
public Abstract ListenableResultFuture < Navigator.RouteStatus > setDestinations (Список пунктов назначения < Waypoint >, параметры RoutingOptions )
Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения. Для отображения маршрута будут использоваться параметры DisplayOptions по умолчанию.
Параметры
| направления | новый список пунктов назначения, который будет установлен |
|---|---|
| параметры | параметры, которые будут использоваться для создания маршрута |
Возврат
- возвращенное будущее
общедоступный аннотация ListenableResultFuture < Navigator.RouteStatus > setDestinations (List < Waypoint > пункты назначения, RoutingOptions routerOptions, DisplayOptions displayOptions)
Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения.
Параметры
| направления | новый список пунктов назначения, который будет установлен |
|---|---|
| Параметры маршрутизации | параметры, которые будут использоваться для создания маршрута |
| Показать варианты | параметры, которые будут использоваться для отображения маршрута |
Возврат
- возвращенное будущее
общедоступный абстрактный ListenableResultFuture < Navigator.RouteStatus > setDestinations (Список < Waypoint > пунктов назначения)
Устанавливает несколько пунктов назначения для навигации, отменяя любые ранее установленные пункты назначения. Возвращенное будущее будет установлено на OK , если найден маршрут от местоположения пользователя до заданного пункта назначения. Параметры RoutingOptions по умолчанию будут использоваться для поиска маршрута, а параметры DisplayOptions по умолчанию будут использоваться для его отображения.
Параметры
| направления | новый список пунктов назначения, который будет установлен |
|---|
Возврат
- возвращенное будущее
public Abstract void setHeadsUpNotificationEnabled (логическое значение включено)
Устанавливает, следует ли отображать всплывающие уведомления. По умолчанию уведомление включено. События Heads-up — это события навигации, такие как повороты и т. д., которые отображаются, когда карта не видна.
Этот метод необходимо вызывать в потоке пользовательского интерфейса.
Параметры
| включено | флаг, указывающий, следует ли включать хедз-ап-уведомления |
|---|
public Abstract void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode)
Устанавливает информацию о номерном знаке текущего водителя. Это позволяет нам обходить определенные типы дорожных ограничений, основанные на номерном знаке. Это будет применяться только к вызовам setDestination, сделанным после установки этого значения. В идеале вы должны позвонить сюда сразу после получения навигатора.
Параметры
| rawLicensePlateLastDigit | Последняя цифра номерного знака (должна быть от 0 до 9). |
|---|---|
| лицензияТаблицаКодСтраны | В настоящее время мы поддерживаем Индонезию (ID) и Бразилию (BZ). Другие могут поддерживаться в будущем, и вы можете заранее предоставить эту информацию. |
public Abstract void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener прослушиватель)
Регистрирует прослушиватель на случай, если оставшееся время или расстояние до пункта назначения изменится более чем на указанное пороговое значение. Переопределяет любые ранее зарегистрированные прослушиватели.
Прослушиватель может быть вызван в результате (например) перемещения пользователя, изменения условий дорожного движения, изменения маршрута, изменения пункта назначения или когда впервые становятся известны оставшееся время и расстояние.
Примечание. Чтобы избежать утечек памяти, clearNavProgressionListener() следует вызывать, когда прослушиватель больше не требуется.
Параметры
| timeChangeThresholdSeconds | Если абсолютное изменение оставшегося времени в секундах больше или равно этому значению, то вызывается прослушиватель. Этот порог не должен быть отрицательным. |
|---|---|
| расстояниеИзменитьПорогМетры | Если абсолютное изменение оставшегося расстояния в метрах больше или равно этому значению, то вызывается прослушиватель. Этот порог не должен быть отрицательным. |
| слушатель | слушатель зарегистрироваться. Не должно быть null . |
public Abstract void setRouteChangedListener (прослушиватель Navigator.RouteChangedListener )
Регистрирует прослушиватель событий изменения маршрута. Переопределяет любые ранее зарегистрированные прослушиватели.
Примечание. Чтобы избежать утечек памяти, setNavRouteChangeListener(null) следует вызывать, когда прослушиватель больше не требуется.
Параметры
| слушатель | слушатель зарегистрироваться. Может быть установлено значение null , чтобы очистить ранее зарегистрированный прослушиватель. |
|---|
публичный абстрактный недействительный setSpeedingListener ( SpeedingListener SpeedingListener)
Регистрирует SpeedingListener для определения процента превышения ограничения скорости, с которым в данный момент движется водитель.
Установив null SpeedingListener или не установив его, вы не будете получать никаких данных о превышении скорости.
Параметры
| Превышение скоростиСлушатель |
|---|
public Abstract void startGuidance (Намерение ResumeIntent)
То же, что startGuidance() , но с указанием намерения, которое можно использовать для возобновления работы приложения из уведомления в строке состояния навигатора. Без этого намерения невозможно возобновить работу приложения из строки состояния.
Параметры
| резюмеНамерение | намерение возобновить применение. В большинстве случаев подойдет значение, возвращаемое функцией android.app.Activity#getIntent() . |
|---|
публичный абстрактный void startGuidance ()
Если пункт назначения задан и для него рассчитан маршрут, запускается пошаговая навигация по маршруту. Если маршрут еще не рассчитан, пошаговое руководство начнется сразу после его расчета.
Вы должны явно вызвать функцию stopGuidance(), чтобы остановить службу навигации. Навигационная служба не отключается автоматически по прибытии. Если вы хотите остановить службу навигации по прибытии, вам необходимо вызвать stopGuidance() в NavArrivalListener.
Примечание: этот метод не меняет положение Camera .
публичная абстрактная пустота stopGuidance ()
Останавливает пошаговое навигационное руководство.