Виджет Мое местоположение позволяет просматривать и записывать ваше местоположение и перемещения. Виджет может извлекать местоположение вашего устройства и создавать отдельные точки, называемые местоположениями, или непрерывно записывать точки и создавать линии, называемые путями. В дополнение к широте и долготе, виджет записывает время, высоту, скорость, направление и точность. Местоположения и пути становятся источниками выходных данных, что позволяет использовать данные, созданные виджетом Мое местоположение, с другими виджетами, такими как Таблица и Список.
Experience Builder сохраняет данные, полученные с помощью виджета Мое местоположение, в браузере вашего устройства. Если вы обновите страницу или закроете окно браузера, данные будут потеряны. Чтобы сохранить данные, вы можете включить действие Экспорт в настройках виджета Действие и экспортировать их в JSON, CSV, GeoJSON или элемент ArcGIS.
Примеры
Используйте этот виджет для поддержки требований к разработке приложений, таких как:
- Вы хотите, чтобы бригады экстренного реагирования отмечали места падения линий электропередач после шторма.
 - Вы хотите создать линейные объекты, идя по новой тропе и постоянно записывая свое местоположение.
 - Вы хотите отследить грузовик по маршруту доставки.
 
Примечания по использованию
Виджету требуется подключение к виджету Карта.
Когда вы включаете этот виджет в приложение с помощью расположения Панель, панель предоставляет пользователям следующие возможности:
- Получить местоположение - получить новую точку. Эта кнопка появляется, если в настройках виджета отключено Следить за местоположением.
 - Начать наблюдение - начать непрерывное получение местоположений. Эта кнопка появляется, если в настройках виджета отключено Следить за местоположением.
 - Завершить наблюдение - закончить получение местоположений. Это позволяет создавать путь.
 - Трассировка пути - создание пути вручную. Это можно сделать когда наблюдение запущено.
 - Показывать на карте или Скрывать на карте - показывать или скрывать символы местоположений на карте.
Подсказка:
Настройки видимости слоев синхронизируются между виджетом Мое местоположение и виджетами Спрятать, Слои карты и Карта. Если вы скроете слой с помощью одного виджета, он также будет скрыт для других виджетов.
 - Вы можете удалить отдельные записи с помощью кнопки Удалить запись или удалить все записи с помощью кнопки Очистить результаты.
Примечание:
Удаление местоположений может привести к повторному созданию связанных путей. Удаление путей может привести к удалению связанных местоположений.
 
Когда вы включаете этот виджет в приложение с расположением Полоса, панель инструментов предоставляет пользователям все те же возможности, за исключением того, что действия с данными недоступны.
В следующей таблице перечислены поля атрибутов, которые виджет Мое местоположение может записывать для местоположений и путей:
| Поле | Тип | Описание | 
|---|---|---|
ObjectID  | Число  | Управляемое системой поле ID.  | 
Timestamp  | Дата  | Дата и время записи точки.  | 
Longitude  | Число  | Долгота записанной точки.  | 
Latitude  | Число  | Широта записанной точки.  | 
LineID  | Число  | Идентификатор, указывающий на линию, к которой относится точка.  | 
Altitude  | Число  | Высота устройства захвата, измеряемая в метрах над уровнем моря (MSL)  | 
Orientation  | Число  | Ориентация устройства захвата.  | 
Speed  | Число  | Скорость устройства захвата в метрах в секунду.  | 
Accuracy  | Число  | Точность записанного местоположения в метрах.  | 
Виджет Мое местоположение создает источник выходных данных, который могут использовать другие виджеты. Например, вы можете просмотреть местоположения в виджете Таблица. Для этого добавьте виджет Таблица в приложение и щелкните Новый лист в настройках виджета. Щелкните Выходные данные и выберите Вид вывода местоположений или Вид вывода путей.
Настройки
Виджет Мое местоположение включает следующие настройки:
- Выбрать виджет Карта - выберите виджет Карта.
 - Расположение - выберите стиль интерфейса виджета: Панель или Полоса.
 - Общие настройки — Настройка основных параметров.
- Выделить местоположение - отобразить полученные местоположения и текущее местоположение пользователя на подключенной карте.
- Цвет символа - измените цвет символов местоположений на карте.
 - Показывать ориентацию по компасу - добавьте символ треугольника к текущему местоположению пользователя, который показывает ориентацию устройства.
 - Показывать точность местоположения - добавьте буфер к текущему местоположению пользователя, который показывает точность определения местоположения.
 
 - Масштаб - задайте масштаб, при котором пользователь получает или выбирает запись, карта будет масштабирована до этой записи.
 - Таймаут (секунда) - максимальное время для получения местоположения точки. Если виджету требуется больше времени для захвата точки, чем задано, он выводит сообщение о Местоположение не может быть получено.
 - Выберите поля - установите отметку рядом с каждым полем, чтобы включить их в сгенерированные данные.
Примечание:
Поля Идентификатор объекта и Метка времени являются обязательными.
 - Следить за местоположением - автоматическое и непрерывное получение местоположений. Включение этой опции приводит к построению путей.
- Поток - выберите, как часто виджет будет получать новую точку, по времени или по расстоянию.
Примечание:
Заданный вами интервал - это минимально возможное расстояние между захваченными точками. Однако фактическая производительность может меняться в зависимости от браузера и других компонентов вашей веб-среды.
 - Ручная трассировка пути - включите кнопку Трассировка пути на панели виджетов во время выполнения. Эта кнопка позволяет пользователю вручную создавать маршрут в любой момент в процессе просмотра.
 
 - Поток - выберите, как часто виджет будет получать новую точку, по времени или по расстоянию.
 - Показывать слои времени запуска в списках слоев — показывает слои Местоположений и Путей, созданные виджетом Мое местоположение, в списках слоев других виджетов, таких как виджет Слои карты, виджет Легенда и инструмента Слои Виджета карты.
 - Активация по умолчанию - если вы включите этот параметр, виджет начнет захватывать точки, как только приложение загрузится. Если вы отключите этот параметр, виджет начнет захват точек только тогда, когда пользователь нажмет кнопку Начать наблюдение.
 
 - Выделить местоположение - отобразить полученные местоположения и текущее местоположение пользователя на подключенной карте.
 
Опции взаимодействия
Этот виджет поддерживает действия, которые можно настроить на вкладке Действие в настройках виджета.
Включите действия с данными, чтобы добавить кнопки в пользовательский интерфейс виджета для выполнения задач обработки данных, таких как экспорт, масштабирование до местоположений и просмотр записей в таблице. Чтобы использовать действия с данными во время выполнения, щелкните Действия 
 и выберите действие с данными из появившегося ниспадающего меню.