Развертывание вашей карты

Когда карта будет подготовлена для использования в поле, разверните ее для ваших мобильных работников. Поделитесь картой с сотрудниками, и тогда они смогут найти ее в ArcGIS Field Maps или открыть ее по ссылке. Если мобильным сотрудникам предстоит работа офлайн, они могут скачать подготовленные вами карты или скопировать MMPK непосредственно на свои устройства. Предоставьте своим мобильным работникам помощь по использованию приложения, настроив полевое руководство для проектов сбора данных вашей организации или путем предоставления инструкций по публикации их местоположения. Вы также можете использовать ПО управления мобильным устройством (MDM) для развертывания и настройки мобильного приложения.

Публикация карты для использования в Field Maps

Field Maps предоставляет доступ к картам, которые принадлежат мобильному работнику или совместно используются организацией ArcGIS или группой, включающей мобильного работника. Создание группы является необязательным пунктом, но это поможет управлять тем, у кого из мобильных сотрудников будет доступ к вашим картам и данным. Для того чтобы ваши мобильные сотрудники могли получить доступ к вашей опубликованной карте, они должны быть участниками организации ArcGIS. Если в вашей опубликованной карте есть возможность редактирования, у них также должно быть право на редактирование объектов.

  1. Если мобильные работники пока не являются участниками организации ArcGIS (в ArcGIS Online или ArcGIS Enterprise), вы должны создать для них учетные записи.

    См. Приглашение и добавление пользователей в ArcGIS Onlineили Добавить пользователя к порталу в ArcGIS Enterprise.

    Для использования создаваемые учетные записи должны соответствовать требованиям учетной записи ArcGIS для работы в Field Maps.

  2. Откройте доступ к карте и слоям для организации ArcGIS, либо создайте группу для управления доступом к вашим картам и данным.

Открытие карты по ссылке

Мобильные работники могут найти вашу карту в Field Maps или вы можете предоставить им прямую URL-ссылку на нее. Чтобы ваши мобильные работники могли легко открыть нужную карту и приступить к работе, отправьте ссылку непосредственно на вашу карту через электронную почту, текстовое сообщение, веб-страницу или другое приложение. Используйте ссылки на Field Maps, которые при нажатии открывают Field Maps с картой, которую должны использовать мобильные сотрудники. Если для карты включена возможность редактирования, они смогут начать сбор данных, когда откроется карта. Если ваши мобильные работники работают в автономном режиме, ссылки по-прежнему работают.

Ссылки в Field Maps

Ссылки Field Maps имеют следующий формат: https://fieldmaps.arcgis.app?parameter=value&parameter=value, где пары параметр - значение заменяются значениями, которые вы хотите использовать для открытия карты. Например, https://fieldmaps.arcgis.app?referenceContext=center&itemID=3ac4145c1ac44aea86e9ed42e00fbb0d&center=34.0547155,-117.1961714 использует параметр itemID и значение 3ac4145c1ac44aea86e9ed42e00fbb0d для того, чтобы открыть карту с этим ID. Параметр referenceContext и его значение center определяют тип действия, которое должно быть выполнено в приложении, в данном случае, центрирование карты. Параметр center и значение 34.0547155,-117.1961714 указывают координаты для центрирования карты.

Параметры

Следующие параметры поддерживаются ссылками Field Maps. Если параметры не будут переданы, то при касании этой ссылки откроется Field Maps (или будет предложено открыть приложение).

ПараметрЗначенияПримечания

anonymousAccess

Используется при вызове карты или MMPK, которые являются общедоступными и не требуют ввода учетных данных для доступа, или при входе в портал на Field Maps, который разрешает анонимный доступ.

  • Требует itemID при вызове карты с публичным доступом.
  • Значение - Логическое (Булево), true или false.
  • По умолчанию false.

bookmark

Настройка закладки для карты

  • Необходимы itemID и referenceContext=center.
  • Откройте карту с определенной точкой обзора, указав закладку на карте. Пробелы кодируются знаком +.
  • Ссылка не может содержать параметров, отличных от itemID и bookmark.

callback

URL для вызова при сборе устройства или наблюдения заполнен

  • Требует itemID, либо referenceContext=addFeature, referenceContext=updateFeature или referenceContext=shareLocation, а также featureSourceURL.
  • При необходимости, перед вызовом URL-адреса, предложите подсказку пользователю, заданную параметром callbackprompt.
  • Если параметры передаются в URL-адресе обратного вызова, значение каждого параметра должно быть закодировано в URL, а затем закодирован весь URL-адрес обратного вызова (включая повторное кодирование значений).

callbackPrompt

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

  • Требует itemID, либо referenceContext=addFeature, referenceContext=updateFeature или referenceContext=shareLocation, а также callback.
  • Значение должно быть в формате URL (пробелы должны быть закодированы как + или %20).

center

Набор координат широты и долготы (y, x), по которым центрируется карта

  • Необходимы itemID и referenceContext=center.
  • Координаты центра должны быть представлены как разделенная запятыми пара значений широта/долгота (y, x) в WGS84 (WKID: 4326).

featureAttributes

Словарь JSON записей в форме для нового собранного объекта

  • Требует itemID, либо referenceContext=addFeature или referenceContext=updateFeature, а также featureSourceURL.
  • Указанные записи перезаписывают все существующие значения.
  • Если запись отсутствует в редактируемой форме или указан неверный тип значения, запись игнорируется.
  • Даты должны быть представлены в виде числового значения в миллисекундах с начала эпохи времени (эпохи Unix).
  • Записи со связанным доменом кодированных значений используют код домена (не описание домена).
  • Записи должны быть закодированы в URL перед передачей в Field Maps.

featureID

Уникально идентифицирует объект в слое, который нужно обновить. Должно быть поле GlobalID.

  • Необходим referenceContext=updateFeature.
  • Слой, содержащий объект, должен поддерживать обновления объектов.

featureSourceURL

URL-ссылка слоя, где начинается сбор данных

  • Требует itemID и либо referenceContext=addFeature или referenceContext=updateFeature
  • Дополнительно укажите входные данные для формы с помощью параметра featureAttributes.

foreignKeyField

Поле в дочерней таблице, которое определяет отношение и получает ключ из родительского объекта.

  • Необходимы referenceContext=addRelatedFeature, itemID, featureSourceURL и featureID.

geometry

Определяют местоположение для нового собранного объекта

  • Требует itemID, либо referenceContext=addFeature или referenceContext=updateFeature, а также featureSourceURL.
  • Значение - это координата, содержащая x, y и z, или представление геометрии JSON (точка, линия или полигон).
  • Значения JSON должны быть закодированы в URL.

itemID

itemID открывающейся карты

  • Необходим referenceContext.
  • itemID указан в URL-ссылке страницы элемента карты. Например, если URL-адрес страницы элемента карты https://www.arcgis.com/home/item.html?id=0c900ae2a1084d27b608233921ef1a84, то ID элемента карты будет 0c900ae2a1084d27b608233921ef1a84.
  • Поддерживаемые типы карты включают веб-карты, MMPK и офлайн-области.

locationSharingDuration

Задает продолжительность публикации местоположений в часах

  • Необходимы referenceContext=shareLocation и locationSharingON=true.
  • Единица измерения — часы, десятичные дроби поддерживаются.

locationSharingON

Указывает, включено или выключено отслеживание местоположений

  • Необходим referenceContext=shareLocation.
  • Значение - Логическое (Булево), true или false.

locationSharingShareLKLOnly

Задает, как хранится история публикации местоположений

  • Необходимы referenceContext=shareLocation и locationSharingON=true.
  • Значение - Логическое (Булево), true или false.
  • Если для locationSharingLKLOnly задано true, история публикации местоположений точек отслеживания не сохраняется.

locationSharingUploadLKLFrequency

Показывает частоту обновления последнего известного местоположения

  • Необходимы referenceContext=shareLocation и locationSharingON=true.
  • Перезаписывает настройку по умолчанию в 60 секунд.
  • Единица измерения – секунды, значение должно быть больше 5. Максимального ограничения нет.
  • Этот параметр сохраняется между сеансами до выхода пользователя из системы.
  • Тип значения - целое число.

portalURL

URL портала вашей организации

  • Если указан, и мобильный сотрудник вышел из системы или подключен к другому порталу (в том числе ArcGIS Online), им предлагается выйти из системы, а затем появляется экран входа в организацию с полями для ввода учетных данных.
  • Укажите тот же URL-адрес, который вы вводите в браузере, когда хотите получить доступ к порталу, например, https://myportal.mycompany.com/arcgis.

referenceContext

Что должно делать приложение, если оно откроется и пользователь вошел в систему

Поддерживаются следующие значения:

  • addFeature
  • addRelatedFeature
  • center
  • открыть
  • поиск
  • shareLocation
  • updateFeature
Примечание:

Если вы хотите использовать несколько значений ReferenceContext в одном URL, например, open и search, укажите только одно значение — основное использование параметра ReferenceContext. Например, если указать search, это будет значить, что карта — open. См. примеры ссылок Field Maps ниже.

scale

Масштаб (в единицах карты), в котором должна быть отрисована карта

  • Необходимы itemID и center.

search

Адрес, место, координаты или объект, который нужно найти

  • Необходим itemID.
  • Пробелы кодируются знаком +.
  • Объекты идентифицируются с использованием тех же терминов, которые используются для их поиска на карте.

useAntennaHeight

Определяет, должна ли высота антенны текущего приемника быть вычтена из z-значения каждой вершины местоположения

  • Необходимы itemID, referenceContext=addFeature, geometry и featureSourceURL.
  • Значение - Логическое (Булево), true или false.
  • По умолчанию false.
Примечание:

Скоро появится поддержка Android.

useLocationProfile

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

  • Необходимы itemID, referenceContext=addFeature, geometry и featureSourceURL.
  • Значение - Логическое (Булево), true или false.
  • По умолчанию false.
Примечание:

Скоро появится поддержка Android.

wkid

Определяет координаты центра в другой пространственной привязке

  • Необходимы itemID, center и scale.
  • Если параметр не определен, значения по умолчанию WKID: 4326 (WGS84).

Продолжайте читать примеры использования этих параметров для задания определенного поведения с помощью ссылки Field Maps.

Открытие карты

Используйте следующие параметры, чтобы открыть карту:

  • referenceContext=open
  • itemID
  • portalURL (дополнительно)

Поддерживаемые типы карты включают веб-карты, MMPK и офлайн-области.

Ниже приведены примеры:

Доступ к публичной карте без выполнения входа

Для доступа к публичной карте используйте следующие параметры:

  • referenceContext=open
  • itemID
  • anonymousAccess=true
  • portalURL (дополнительно)

Ниже приведен пример:

  • https://fieldmaps.arcgis.app/?referenceContext=open&itemID=5dce807aeb5c4b33bce767d278df9c3d&anonymousAccess=true

Войдите в портал, который разрешает анонимный доступ

Используйте следующие параметры для доступа в портал, который разрешает анонимный доступ.

  • anonymousAccess=true
  • portalURL

Ниже приведен пример:

  • https://fieldmaps.arcgis.app/?portalURL=https://myportal.mycompany.com/gis&anonymousAccess=true

Задайте центрирование и масштаб карты

Используйте следующие параметры, чтобы задать центрирование и масштаб карты вместо того, чтобы использовать настройки центра карты и масштаба по умолчанию при открытии карты.

  • referenceContext=center
  • itemID
  • center
  • scale (дополнительно)
  • wkid (дополнительно)
  • bookmark (дополнительно)

Система координат по умолчанию WGS84, но ее можно изменить с помощью параметра wkid.

Ниже приведены примеры:

Поиск на карте

Используйте следующие параметры, чтобы открыть карту и выполнить поиск адреса, места, координат или объекта (устройства или наблюдения):

  • referenceContext=search
  • itemID
  • search

Ниже приведены примеры:

Посмотреть закладку

Используйте следующие параметры, чтобы посмотреть местоположение, указанное закладкой на карте.

  • referenceContext=center
  • itemID
  • bookmark

В следующем примере открывается карта, указанная закладкой под названием Centennial Park:

https://fieldmaps.arcgis.app/?referenceContext=center&itemID=0c900ae2a1084d27b608233921ef1a84&bookmark=Centennial+Park

Начало сбора объектов

Откройте карту и начните сбор данных об объектах, используя следующие параметры. При необходимости укажите записи в форме для применения их к новому объекту или наблюдению.

  • itemID
  • referenceContext=addFeature
  • featureSourceURL
  • geometry (дополнительно) — если указано, определяет форму объекта. В противном случае для точки или первой вершины, если это линия или полигон, используется GPS-местоположение мобильного работника.
  • useAntennaHeight (дополнительно)
  • useLocationProfile (дополнительно)
  • featureAttributes (дополнительно)
  • callback (дополнительно)
  • callbackPrompt (дополнительно)
Примечание:

Скоро появится поддержка useAntennaHeight и useLocationProfile в ссылках на Android.

Ниже приведены примеры:

Начать обновление объекта

Откройте карту и начните обновлять существующие объекты, используя следующие параметры. При необходимости укажите записи в форме для применения их к обновленному объекту или наблюдению.

  • itemID
  • referenceContext=updateFeature
  • featureSourceURL
  • featureID
  • featureAttributes (дополнительно)
  • geometry (дополнительно)
  • callback (дополнительно)
  • callbackPrompt (дополнительно)
Примечание:

Это не применимо к строкам таблицы

Ниже приведены примеры:

Добавьте связанный объект

Откройте карту и добавьте новый связанный объект со следующими параметрами:

  • itemID
  • referenceContext=addRelatedFeature
  • featureSourceURL
  • featureID
  • foreignKeyField

Следующая ссылка-пример открывает карту и добавляет связанные объект, основанный на имени поля внешнего ключа, с которым связан новый объект:

https://fieldmaps.arcgis.app/?referenceContext=addRelatedFeature&itemID=0c900ae2a1084d27b608233921ef1a84& featureSourceURL=https://services9.arcgis.com/QjGvjfQhsHAmqfjP/arcgis/rest/ services/DamageAssessment_Apr2018_631d0895e7d3404bb78e8e04e92d896e/FeatureServer/ 1&featureID=bb0a0c92-9f53-4367-a6a1-bc6edc605be0&foreignKeyField=FacilityID

Начать публикацию местоположения

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

  • referenceContext=shareLocation
  • locationSharingON=true
  • locationSharingDuration

В следующем примере ссылка включает публикацию местоположения на 120 часов:

https://fieldmaps.arcgis.app/?referenceContext=shareLocation&locationSharingOn=true&locationSharingDuration=120​

Примечание:

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

https://fieldmaps.arcgis.app/?referenceContext=shareLocation&locationSharingOn=false

Предоставление руководства по сбору данных

Несмотря на то, что данная документация предоставляет информацию об использовании Field Maps, мобильным работникам, собирающим данные, в поле часто требуется что-то более легкое — что-то, что можно распечатать и взять с собой (особенно если они работают в автономном режиме). Предоставление им базового одностраничного руководства по работе в поле, которое помогает в решении типовых задач и устранении некоторых проблем, упрощает вашу работу по поддержке мобильных работников. Предоставляется шаблон полевого руководства, сфокусированный на основных задачах сбора данных и написанный для полевых рабочих. Используйте его, чтобы начать создавать свои собственные справочные материалы для мобильных работников.

  1. Скачайте шаблон полевого руководства..
  2. Настройте руководство (добавьте логотип, подсказки по решению проблем, специфичных для вашей организации и т.п.). Убедитесь, что не забыли удалить первую часть, где содержатся инструкции по настройке.
  3. Обеспечение мобильных работников руководством.

    Мобильные работники могут держать руководство в кармане и использовать его для устранения проблем, пока находятся в поле.

Предоставьте инструкции по публикации местоположения

Если вашей организации требуется публикация местоположения, полезно предоставить мобильным работникам инструкции о том, как начать публикацию их местоположения в Field Maps. Шаблон инструкций по публикации местоположения приведен ниже:

  1. Скачайте шаблон инструкции по публикации местоположения..
  2. Следуйте инструкциям в документе, чтобы настроить шаблон и поделиться им с мобильными работниками.

Управление мобильным устройством

Управление мобильным устройством (MDM) - программное обеспечение, используемое для администрирования мобильных устройств в организации. MDM используется для повышения безопасности данных и сети, а также для установки и применения для мобильных устройств специальных политик. Кроме того, использование MDM повышает эффективность развертывания приложений и управления ими на мобильных устройствах, включая контроль за тем, как и когда обновляется приложение. Дополнительные сведения о подходе Esri к MDM, см. в разделе Техническая документация по безопасности мобильных решений ArcGIS в ArcGIS Trust Center.

При подготовке к развертыванию Field Maps на мобильных устройствах вашей организации через MDM, существует ряд параметров приложения и профиля, которые вы, возможно, захотите настроить. К ним относятся URL-адрес портала и настройки VPN для каждого приложения.

Конфигурация приложения Field Maps

Конфигурация приложения (также называемая AppConfig) описывает формат предоставления параметров приложения, в том числе таких как URL портала, между прочих. Вместо того чтобы настраивать эти параметры вручную при каждой установке мобильного приложения, вы можете использовать свой MDM для автоматического задания и применения настроек приложения. Эти настройки задаются словарем, состоящим из пар «ключ-значение», находящимся в файле XML. Порядок создания словаря зависит от используемого MDM. Для получения подробной информации о настройке приложения посетите Сообщество AppConfig.

Следующие настройки Field Maps можно задать с помощью конфигурации приложения в MDM:

КлючЗначениеПримечания

anonymousAccess

Задает, будет ли выполнен вход анонимно или требуются учетные данные

  • Значение параметра anonymousAccess игнорируется, если выполняются следующие условия:
    • Не указан portalURL.
    • Указанный в portalURL портал не поддерживает анонимный доступ.
  • Если anonymousAccess - true, а также задан portalURL, то при открытии Field Maps учетные данные не требуются, вы войдете на портал анонимно.
  • Значение - Логическое (Булево), true или false.
Примечание:

При анонимном подключении к порталу публичные карты из Группы Избранного появятся в списке Карты. Мобильные сотрудники могут выполнять поиск общедоступных карт на портале.

isAutoSyncEnabled

Определяет, включена ли автосинхронизация

  • Значение - Логическое (Булево), true или false.
  • По умолчанию true.
  • Если isAutoSyncEnabled - false, кнопка переключения автосинхронизации скрыта из настроек Профиль и панели Синхронизация на мобильном устройстве.

locationProfiles

Определяет параметры одного или нескольких профилей расположения

  • Требуются следующие параметры:
    • name - Имя профиля местоположения.
    • mapCoordinateSystem - Код WKID для системы координат карты.
    • gnssCoordinateSystem - Код WKID для системы координат получателя GNSS.
    • horizontalDatumTransformationName - Имя преобразования горизонтального датума.
  • Если locationProfiles содержит несколько наборов значений, первый профиль местоположения в списке задан в профиле по умолчанию.
  • Например, [ { "name":"RTK", "mapCoordinateSystem":3857, "gnssCoordinateSystem": 6318, "horizontalDatumTransformationName": "~WGS_1984_(ITRF08)_To_NAD_1983_2011" }].
  • Тип значения - строковый.

offsetProvider

Определяет провайдера смещения

  • Поддерживаются следующие значения:
    • Bad Elf Flex
    • Eos Tools Pro
    • Spike
      Примечание:

      Spike поддерживается только в iOS.

  • Тип значения - строковый.

portalURL

URL портала вашей организации

  • Когда Field Maps открыто, оно напрямую переходит на экран входа в ваш портал организации.
  • Например, https://myportal.mycompany.com/gis.
  • Тип значения - строковый.

locationSharingMode

Определяет, оптимизируется ли время работы батареи при записи треков

  • Если locationSharingMode - optimized, при определении времени записи дорожек учитывается активность устройства.
  • Если locationSharingMode - unoptimized, треки записываются независимо от активности устройства.
  • Подробнее см. раздел Оптимизация расхода заряда батареи.
  • Тип значения - строковый.

locationSharingUploadLKLFrequency

Показывает частоту обновления последнего известного местоположения

  • Перезаписывает настройку по умолчанию в 60 секунд.
  • Единица измерения – секунды, значение должно быть больше 5. Максимального ограничения нет.
  • Этот параметр сохраняется между сеансами до выхода пользователя из системы.
  • Тип значения - целое число.

locationSharingShareLKLOnly

Задает, как хранится история публикации местоположений

  • Значение - Логическое (Булево), true или false.
  • Если для locationSharingLKLOnly задано true, история публикации местоположений точек отслеживания не сохраняется.

locationSharingUploadTracksFrequency

Показывает частоту загрузки трека

  • Перезаписывает настройку по умолчанию в приложении.
  • Единица измерения – секунды, значение должно быть больше 30.
  • Тип значения - целое число.

maxRefreshTokenExpiration

Задает время истечения для токена

  • Перезаписывает настройку по умолчанию, использующую постоянный токен обновления.
  • Единицы измерения — минуты.
  • Тип значения - целое число.
  • Можно использовать любое целое число, начиная с 2 минут.
  • Значение 0 будет соответствовать настройкам портала maxTokenExpirationMinutes с максимальным значением в 90 дней. Если указанное значение больше этого параметра, токен будет соответствовать максимальному значению, которое может быть создано для данного типа токена.
  • Значение -1 является значением по умолчанию и указывает на постоянный токен обновления.
Примечание:

Дополнительные сведения об истечении срока действия токена см. в разделе Задание максимального времени истечения токена.

useInAppAuth

Указывает, будет ли использоваться веб-представление для входа и авторизации в Field Maps.

  • Значение - Логическое (Булево), true или false.
  • По умолчанию false.
  • Если useInAppAuth - false, будет запущена страница входа с помощью потока вне процесса.
  • Если useInAppAuth - true, страница входа будет использовать веб-представление, встроенное в приложение.
Внимание:

Если для доступа к внутренним ресурсам требуется VPN, а ваша организация ограничивает VPN-доступ к браузерам на управляемых устройствах, то для настройки успешного входа на ваши порталы возможно потребуется задать для useInAppAuth значение true.

Примечание:

Если Field Maps открыт по ссылке Field Maps, то параметры, указанные в ссылке, будут иметь преимущество над конфигурацией приложения.

Виртуальная частная сеть для приложения

Настройка виртуальной частной сети для приложения (per-app VPN) в MDM позволяет ограничить доступ к внутренним ресурсам для определенных управляемых приложений. Field Maps может быть развернут в этой конфигурации. Чтобы настроить использование VPN на уровне приложения для Field Maps, см. документацию к ПО используемого MDM.

Внимание:

Если вы работаете с iOS, Safari используется для отображения в Field Maps экрана входа на портал. Чтобы обеспечить корректную работу при включенной VPN для приложения, домен вашего портала (например, mycompany.com) должен быть указан в настройке Домены Safari в профиле VPN приложения, которую вы используете. Если Домены Safari заданы некорректно, то назначенные мобильные устройства не смогут получить к экрану входа на портал в Field Maps. Либо можно задать useInAppAuth как true, что приведет к тому, что процесс входа будет полностью происходить во встроенном в приложение веб-представлении, а не через Safari.

Если вы задали Домен Safari в профиле VPN для приложения, как описано выше, приложение браузер Safari также может получить доступ к домену портала, который вы указали в Доменах Safari. Если вы хотите заблокировать такой доступ, настройте Ограничение iOS (если это доступно в вашем MDM) на Блокировать приложение браузера Safari на нужных устройствах.

Если ваши устройства работают на Android, вкладки Chrome Custom (или предпочитаемый вами браузер) используются для отображения экрана входа на портал в Field Maps. У браузера должен быть VPN-доступ к нему, чтобы корректно работать с VPN, включенным для приложения. Имейте в виду, что можно задать для useInAppAuth значение true, чтобы избегать этого требования и использовать для процесса входа встроенное в приложение веб-представление.

После настройки параметров VPN для приложения Field Maps в MDM, при запуске приложения на управляемом мобильном устройстве оно автоматически подключится к заданному VPN. Когда Field Maps работает в фоновом режиме, VPN для каждого приложения все еще подключен, но только к Field Maps. Когда Field Maps закрыт, мобильное устройство автоматически отключается от VPN на уровне приложения.