Получает информацию о провайдерах геопозиционирования, которые доступны в системе.
Синтаксис
ПолучитьПровайдеров(<ТолькоДоступных>)Полное описание, параметры и ограничения
СредстваГеопозиционирования.ПолучитьПровайдеров (LocationTools.GetProviders)
СредстваГеопозиционирования (LocationTools)
ПолучитьПровайдеров (GetProviders)
Доступен, начиная с версии 8.3.3.
Синтаксис:
ПолучитьПровайдеров(<ТолькоДоступных>)
Параметры:
<ТолькоДоступных> (необязательный)
Тип: Булево.
Если параметр имеет значение Истина - метод вернет список провайдеров, доступных в данный момент.
Если параметр имеет значение Ложь - метод вернет список всех провайдеров, присутствующих на устройстве.
Значение по умолчанию: Истина.
Возвращаемое значение:
Тип: Массив.
Массив из значений типа ИнформацияПровайдераГеопозиционирования, содержащий найденные провайдеры геопозиционирования.
Описание:
Получает информацию о провайдерах геопозиционирования, которые доступны в системе.
Доступность:
Мобильный клиент, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.3.3.
Методическая информация
Практические примеры
Подключить и отключить свой обработчик доступности провайдеров
Полный модуль сохраняет собственное ОписаниеОповещения и передаёт тот же объект для отключения. Координаты не отслеживаются.
Где и как запускать
Полный клиентский модуль собственной мобильной управляемой формы. Назначьте команды указанным процедурам; функции/экспортные обработчики разместите на уровне модуля.
Подготовка
Используйте собственное отдельное учебное мобильное приложение и собственный телефон. Эти методы доступны в мобильном клиенте/мобильном приложении (клиент), не в серверном общем модуле и не в тонком клиенте Windows.
Создайте собственную управляемую форму с указанными в уроке командами и вставьте полный модуль одного урока. Для реального чтения/отслеживания вручную разрешите геопозиционирование приложению в ОС; проверьте требуемые разрешения и возможности в настройках собственного мобильного приложения.
Включённая геолокация устройства не равна разрешению конкретному приложению. Провайдер может использовать сеть, быть платным, расходовать батарею или не поддерживать отдельное поле. Отказ в доступе не обходите.
Последнее измерение не обязательно свежее. Точные координаты не выводятся в сообщения, не записываются в файл и не отправляются на ваш сервер. Геопровайдер ОС сам может использовать сеть согласно своим настройкам.
В уроках отслеживания сначала изучите команду остановки. Не закрывайте форму до отключения собственных обработчиков/геозоны. Не используйте чужое приложение или приложение с рабочими геозонами.
&НаКлиенте
Перем УчебноеОповещениеПровайдеров;
&НаКлиенте
Процедура НачатьНаблюдение(Команда)
Если УчебноеОповещениеПровайдеров <> Неопределено Тогда
ВызватьИсключение "Сначала остановите прежнее собственное наблюдение";
КонецЕсли;
УчебноеОповещениеПровайдеров = Новый ОписаниеОповещения("УчебнаяДоступностьИзменилась", ЭтотОбъект, "guide-providers");
СредстваГеопозиционирования.ПодключитьОбработчикИзмененияДоступностиПровайдеров(УчебноеОповещениеПровайдеров);
Сообщить("Собственный обработчик подключён. После опыта нажмите ОстановитьНаблюдение");
КонецПроцедуры
&НаКлиенте
Процедура УчебнаяДоступностьИзменилась(ИмяПровайдера, Доступен, ДополнительныеПараметры) Экспорт
Если ДополнительныеПараметры <> "guide-providers" Тогда
Возврат;
КонецЕсли;
Сообщить("Провайдер " + ИмяПровайдера + "; доступен: " + Строка(Доступен));
Сообщить("Доступных сейчас: " + Строка(СредстваГеопозиционирования.ПолучитьПровайдеров(Истина).Количество()));
КонецПроцедуры
&НаКлиенте
Процедура ОстановитьНаблюдение(Команда)
Если УчебноеОповещениеПровайдеров = Неопределено Тогда
Сообщить("Собственный обработчик не сохранён");
Возврат;
КонецЕсли;
СредстваГеопозиционирования.ОтключитьОбработчикИзмененияДоступностиПровайдеров(УчебноеОповещениеПровайдеров);
УчебноеОповещениеПровайдеров = Неопределено;
Сообщить("Собственный обработчик отключён");
КонецПроцедурыРазбор по шагам
Создайте команды НачатьНаблюдение и ОстановитьНаблюдение. ОписаниеОповещения хранится в клиентской переменной формы, а не создаётся заново при отключении.
Экспортная процедура имеет три параметра: имя провайдера, доступность, дополнительные параметры уведомления.
Событие относится к доступности провайдера, не к смене координат. Показываем имя, состояние и число доступных провайдеров.
Отключаем только собственное оповещение и очищаем переменную после успешного вызова. При исключении она остаётся для повторного осмысленного завершения, не для скрытого бесконечного повтора.
Как проверить результат
На собственном телефоне переключите геолокацию вручную: если ОС сообщает изменение провайдера, появляется соответствующий вывод. Отсутствие события не выдавайте за доказанный сбой регистрации.
После ОстановитьНаблюдение этот собственный обработчик больше не должен получать новые события. Повторная остановка сообщает отсутствие сохранённого обработчика.
Ожидаемый результат
Подготовлен полный жизненный цикл одного обработчика доступности.
На что обратить внимание
Закрытие формы не заменяет явное отключение собственного обработчика в упражнении.
Не отключайте обработчики приложения по чужим строковым именам.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выбрать провайдер геопозиционирования с учётом точности и батареи
Сравниваем все реальные провайдеры устройства и два варианта выбора. Пока не запрашиваем координаты и не включаем отслеживание.
Где и как запускать
Полный клиентский модуль собственной мобильной управляемой формы. Назначьте команды указанным процедурам; функции/экспортные обработчики разместите на уровне модуля.
Подготовка
Используйте собственное отдельное учебное мобильное приложение и собственный телефон. Эти методы доступны в мобильном клиенте/мобильном приложении (клиент), не в серверном общем модуле и не в тонком клиенте Windows.
Создайте собственную управляемую форму с указанными в уроке командами и вставьте полный модуль одного урока. Для реального чтения/отслеживания вручную разрешите геопозиционирование приложению в ОС; проверьте требуемые разрешения и возможности в настройках собственного мобильного приложения.
Включённая геолокация устройства не равна разрешению конкретному приложению. Провайдер может использовать сеть, быть платным, расходовать батарею или не поддерживать отдельное поле. Отказ в доступе не обходите.
Последнее измерение не обязательно свежее. Точные координаты не выводятся в сообщения, не записываются в файл и не отправляются на ваш сервер. Геопровайдер ОС сам может использовать сеть согласно своим настройкам.
В уроках отслеживания сначала изучите команду остановки. Не закрывайте форму до отключения собственных обработчиков/геозоны. Не используйте чужое приложение или приложение с рабочими геозонами.
&НаКлиенте
Процедура ВыполнитьПример(Команда)
Сообщить("Геолокация включена в настройках устройства: " + Строка(СредстваГеопозиционирования.ИспользованиеДанныхГеопозиционированияВключено()));
Все = СредстваГеопозиционирования.ПолучитьПровайдеров(Ложь);
Доступные = СредстваГеопозиционирования.ПолучитьПровайдеров(Истина);
Сообщить("Всего провайдеров: " + Строка(Все.Количество()));
Сообщить("Доступно сейчас: " + Строка(Доступные.Количество()));
Для Каждого Провайдер Из Все Цикл
Сообщить("Провайдер: " + Провайдер.Имя);
Сообщить("Доступен: " + Строка(Провайдер.Доступен));
Сообщить("Точность, м: " + Строка(Провайдер.Точность));
Сообщить("Энергопотребление, баллов: " + Строка(Провайдер.Энергопотребление));
Сообщить("Платный: " + Строка(Провайдер.Платный));
Сообщить("Использует сеть передачи данных: " + Строка(Провайдер.ИспользуетСетьПередачиДанных));
Сообщить("Использует сотовую сеть: " + Строка(Провайдер.ИспользуетСотовуюСеть));
Сообщить("Использует спутники: " + Строка(Провайдер.ИспользуетСпутники));
Сообщить("Поддерживает высоту: " + Строка(Провайдер.ПоддерживаетВысоту));
Сообщить("Поддерживает направление: " + Строка(Провайдер.ПоддерживаетНаправление));
Сообщить("Поддерживает скорость: " + Строка(Провайдер.ПоддерживаетСкорость));
ПоИмени = СредстваГеопозиционирования.ПолучитьПровайдера(Провайдер.Имя, Ложь);
Сообщить("По имени найден: " + Строка(ПоИмени <> Неопределено));
КонецЦикла;
Точный = СредстваГеопозиционирования.ПолучитьСамогоТочногоПровайдера(Истина);
Если Точный = Неопределено Тогда
Сообщить("Самый точный провайдер отсутствует или сейчас недоступен");
Иначе
Сообщить("Самый точный: " + Точный.Имя);
КонецЕсли;
Экономичный = СредстваГеопозиционирования.ПолучитьСамогоЭнергоЭкономичногоПровайдера(Истина);
Если Экономичный = Неопределено Тогда
Сообщить("Самый энергоэкономичный провайдер отсутствует или сейчас недоступен");
Иначе
Сообщить("Самый энергоэкономичный: " + Экономичный.Имя);
КонецЕсли;
КонецПроцедурыРазбор по шагам
ПолучитьПровайдеров(Ложь) включает присутствующие, но недоступные провайдеры; Истина оставляет доступные сейчас. Порядок массива не является ранжированием качества.
Все 11 свойств информации провайдера только для чтения. Точность указана в метрах, энергопотребление — в баллах 0–10, а не в ваттах или процентах батареи.
ПолучитьПровайдера ищет по реально полученному имени. Не угадываем фиксированное имя gps, одинаковое для всех ОС.
Самый точный/экономичный при Истина может вернуть Неопределено, если именно этот провайдер недоступен. Это не обещание выбрать следующий доступный из списка.
ИспользованиеДанныхГеопозиционированияВключено показывает настройку устройства, не пользовательское согласие приложению и не успешное измерение.
Как проверить результат
Числа, имена и свойства соответствуют собственному устройству; пустой список обрабатывается без индекса 0.
В сообщениях нет широты/долготы и не зарегистрированы обработчики изменения положения.
Ожидаемый результат
Получены реальные характеристики источников геопозиционирования без выдуманных возможностей устройства.
На что обратить внимание
Заявленная точность провайдера не равна точности конкретного измерения.
ПоддерживаетСкорость не гарантирует, что каждое измерение содержит скорость.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.