Использование параметров URL

В ArcGIS Instant Apps вы можете добавлять параметры URL к URL-адресу вашего приложения при публикации и настраивать пользовательские параметры. Вы можете использовать параметры URL для включения инструкций при открытии ссылки приложения. Например, вы можете масштабировать приложение к определенному местоположению или уровню масштаба, приблизить к объекту с помощью всплывающего окна и т.д.

Структура параметров

Параметры добавляются в конец строки URL и форматируются в виде пары ключ-значение, через знак равенства (=). Чтобы добавить параметры, необходимо использовать амперсанд (&) для их подключения к URL-адресу.

URL Instant Apps с параметрами использует следующую структуру:

https://<domain>/apps/instant/<Template>/index.html?<AppID>&<param1=value>&<param2=value>&<param3=value>&...

Примечание:

В этой статье в качестве скобок используются символы «меньше» и «больше» (<>). Не добавляйте символы в свой URL-адрес.

<Template> — это шаблон Instant Apps вашего приложения.

<AppID> — уникальный идентификатор веб-приложения. Шаблоны Instant Apps (например, Базовый шаблон, используемый ниже) используют идентификатор приложения для открытия в качестве параметра URL:

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146

Чтобы добавить несколько параметров, разделяйте их амперсандами (&):

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=en&center=-157.7118,20.7413&level=7

В этом примере были добавлены все параметры locale, center и level.

Основные параметры

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

Примечание:

Не каждый шаблон Instant Apps поддерживает следующие параметры. Обязательно протестируйте свое приложение, чтобы убедиться, что параметр поддерживается.

Указание местоположения

Задайте местоположение, на котором будет центрировано ваше приложение при открытии URL-адреса. Задайте центр с географическими координатами (x,y) с помощью center=<x>,<y>.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&center=-157.7118,20.7413

Приложение откроется на координатах (-157.7118, 20.7413).

Указание уровня масштабирования

Задайте определенный уровень с помощью параметра level. Добавьте level=<zoom level value>.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&level=2

Приложение открывается в более мелком масштабе, чем задано в приложении по умолчанию.

Указание экстента

Используйте две географические координаты (x,y) для указания экстента карты. Используйте extent=<MinX>,<MinY>,<MaxX>,<MaxY>. Первая пара координат (MinX,MinY) должна определять юго-западный угол желаемого экстента карты. Вторая пара координат (MaxX,MaxY) должна определять северо-восточный угол желаемого экстента карты.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&extent=-73.28,42.08,-68.46,42.04

Приложение откроется с нужным экстентом карты.

Поиск местоположения объекта

Чтобы найти местоположение или объект после открытия приложения, используйте параметр find. Карта масштабируется до ближайшего совпадения, и появляется маркер выноски. Используйте find=<search string>.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&find=michigan

Приложение приблизится к штату Мичиган в качестве наилучшего результата поиска.

Добавление маркера со всплывающим окном

При открытии URL-адреса приблизьтесь к маркеру с всплывающим окном при помощи параметра marker. Параметр использует следующие свойства. Чтобы пропустить свойство, используйте двойные запятые (,,).

Примечание:

Весь параметр должен быть закодирован. URL-кодирование заменяет символы знаком процента (%), за которым будет идти их соответствующие шестнадцатеричные коды (hex). Для получения дополнительной информации и кодирования строк см. URLEncoder.io.

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

marker=<x>,<y>,<WKID>,<title>,<symbol URL>,<label>

• <x>,<y> — географические координаты маркера:
• <WKID> – пространственная привязка координат для добавления на карту. Если вы не укажете WKID, то будут использоваться координаты географической системы координат (GCS).
• <title> — заголовок всплывающего окна. Если вы не укажете заголовок, то всплывающее окно будет пустым.
• <symbol URL>– Символ для точки. Если вы не укажете символ, то используется символ маркера черный кружок.
• <label> — текст для включения в описание всплывающего окна.

Параметр приблизит маркер. Щелкните маркер, чтобы открыть всплывающее окно.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&marker=-166.50,24.77,,Papah%C4%81naumoku%C4%81kea%20Marine%20National%20Monument,,One%20of%20the%20world%27s%20largest%20protected%20areas.%20This%20monument%20is%20home%20to%20native%20cultural%20significance%20and%20protects%20critical%20endemic%20species.

URL-адрес создаст маркер и всплывающее окно в указанных координатах. Всплывающее окно названо Papahānaumokuākea Marine National Monument с текстом.

Переключение языка приложения

Настройте свой URL-адрес, чтобы открыть приложение на определенном языке. Используйте параметр locale и двухбуквенный код языка ISO 639-1. Instant Apps поддерживает все языки, которые поддерживает ArcGIS Online. Добавьте locale=<language code>.

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

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=vi

Пользовательский интерфейс приложения теперь при открытии настроен на вьетнамский язык.

Создание параметров Общего доступа

Вы можете создать URL-адрес своего приложения со сгенерированными параметрами, используя функцию Общий доступ. Созданный URL-адрес может сохранять текущий вид карты и открывать всплывающие окна.

Примечание:

Некоторые шаблоны не поддерживают инструмент Общий доступ. Обратитесь кматрице инструментов приложений (PDF)чтобы увидеть, какие шаблоны поддерживают Общий доступ.

Следующие параметры могут быть автоматически созданы с помощью функции общий доступ:

• locale=<language code>
• center=<x>,<y>
• level=<LOD>
• selectedFeature=<feature>

Параметр selectedFeature открывает всплывающее окно объекта.

Чтобы использовать функцию Общий доступ для создания URL-адреса со сгенерированными параметрами, выполните следующие действия:

1. На боковой панели отключите режим Экспресс и при появлении запроса на подтверждение щелкните Продолжить.
2. На боковой панели щелкните Интерактивность, чтобы открыть панель.
3. Щелкните Общий доступ, чтобы открыть меню Общий доступ.
4. Включите опцию Общий доступ. Это активирует инструмент Общий доступ в вашем приложении.
5. На веб-карте настройте вид карты, которой будет открывать URL-адрес.

   Кроме того, вы можете выбрать объект, если хотите, чтобы URL-адрес открывал выбранный объект и его всплывающее окно.

6. Щелкните инструмент Общий доступ.
7. Нажмите Копировать ссылку, чтобы скопировать в буфер обмена URL-адрес вашего приложения.

   Этот URL-адрес будет содержать добавленные параметры, которые откроют ваше приложение для просмотра и всплывающего окна выбранного объекта (если это настроено). Кроме того, этот URL всегда закодирован.

Создание настраиваемого параметра URL

Вы можете создать в своем приложении Instant Apps пользовательский параметр URL, который приближает объект и отображает всплывающее окно при открытии приложения. Пользовательские параметры URL можно комбинировать с другими параметрами URL. Они поддерживаются в 3D-вьюере, Основном, Интерактивной легенде, Репортере и Боковой панели. Основной и Боковая панель также поддерживают пользовательские параметры URL, применяемые к нескольким слоям.

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

1. На боковой панели отключите режим Экспресс и при появлении запроса на подтверждение щелкните Продолжить.
2. Щелкните Настройки поиска и выполните поиск имени параметра URL.

   Появятся настройки Параметра URL.

3. В разделе Имя параметра URL введите имя вашего пользовательского параметра.

   Это будет пользовательский параметр, который нужно добавить к URL-адресу вашего приложения.

4. В слое поиска параметров URL выберите векторный слой из приложения, в котором вы хотите использовать свой пользовательский параметр для поиска.
5. Рядом с выбранным векторным слоем щелкните Поле, чтобы открыть ниспадающее меню полей.

   Выберите поле в слое поиска, по которому будет выполняться поиск с помощью настраиваемого параметра.

6. Щелкните Готово.
7. Щелкните Опубликовать, чтобы развернуть пользовательские конфигурации параметров.

Ваш пользовательский параметр URL настроен. Вы можете добавить пользовательский параметр с идентифицирующим ваш объект значением к URL-адресу приложения, используя структуру <assigned name>=<field value>. При открытии приложения оно приблизится к желаемому объекту и отобразит всплывающее окно.

Например, если пользовательский параметр назван «site» и он должен выполнять поиск по названиям мест, добавьте site=<site name> в конец URL-адреса вашего веб-приложения, чтобы оно приблизилось к указанному объекту. В этом примере приложения морских охраняемых территорий NOAA следующий параметр приблизит Национальный морской заповедник залива Монтерей и откроет всплывающее окно объекта: site=Monterey Bay National Marine Sanctuary.

Следующий URL показывает это:

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&site=Monterey%20Bay%20National%20Marine%20Sanctuary