Преобразование настраиваемых данных для просмотра на растровой карте

  • Статья

В этой статье описывается, как использовать команду Get Map Static Image с функциональностью композиции изображений. Функциональность композиции изображений поддерживает получение статических растровых плиток, содержащих пользовательские данные.

Ниже приведены примеры пользовательских данных:

  • пользовательские вешки;
  • Наклейки
  • геометрические наложения.

Совет

Чтобы отобразить простую карту на веб-странице, часто бывает более экономично использовать веб-пакет SDK Azure Maps, а не службу статических изображений. Веб-пакет SDK использует фрагменты карт, и, если пользователь не изменяет карту и не масштабирует ее, он зачастую создает лишь часть транзакции на каждую загрузку карты. Веб-пакет SDK для Azure Карты имеет параметры отключения сдвига и масштабирования. Кроме того, веб-пакет SDK для Azure Карты предоставляет более широкий набор параметров визуализации данных, чем веб-служба статической карты.

Необходимые компоненты

В этой статье используется приложение Postman, но вы можете выбрать и другую среду разработки API.

Важно!

В примерах URL-адресов замените {Your-Azure-Maps-Subscription-key} ключ подписки azure Карты.

Визуализация вешек с метками и настраиваемого изображения

Примечание.

В этом разделе требуется учетная запись Azure Карты в ценовой категории 1-го или 2-го поколения. Ценовая категория azure Карты 1-го поколения S0 поддерживает только один экземпляр параметра закреплений. Он позволяет преобразовать для просмотра до пяти вешек, указанных в запросе URL-адреса, с настраиваемым изображением.

Выход на пенсию ценовой категории Azure Карты 1-го поколения

Ценовая категория 1-го поколения устарела и будет прекращена на 9.15.26. Ценовая категория 2-го поколения заменяет ценовую категорию 1-го поколения (как S0, так и S1). Если учетная запись Azure Карты выбрана ценовая категория 1-го поколения, вы можете перейти на ценовую категорию 2-го поколения, прежде чем она будет прекращена, в противном случае она будет автоматически обновлена. Дополнительные сведения см. в статье "Управление ценовой категорией учетной записи Azure Карты".

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

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

  1. В приложении Postman выберите New (Создать).

  2. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос).

  3. Введите имя запроса для запроса, например получение статического изображения карты.

  4. Выберите метод HTTP GET.

  5. Введите следующий URL-адрес:

    https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2022-08-01&layer=basic&style=main&zoom=12&center=-73.98,%2040.77&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27CentralPark%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png

  6. Выберите Отправить.

  7. Служба возвращает следующее изображение:

    A custom pushpin with a label.

Преобразование многоугольника для просмотра с использованием функций цвета и прозрачности

Примечание.

Для этой процедуры требуется учетная запись Azure Карты 1-го поколения (S1) или ценовая категория 2-го поколения.

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

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

  1. В приложении Postman выберите New (Создать).

  2. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос).

  3. Введите имя запроса, например GET, многоугольник.

  4. Выберите метод HTTP GET.

  5. Введите следующий URL-адрес службы отрисовки:

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&sku=S1&zoom=14&height=500&Width=500&center=-74.040701, 40.698666&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063
&subscription-key={Your-Azure-Maps-Subscription-key}

  6. Служба возвращает следующее изображение:

    Render an opaque polygon.

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

Примечание.

Для этой процедуры требуется учетная запись Azure Карты 1-го поколения (S1) или ценовая категория 2-го поколения.

Внешний вид вешек можно изменить, добавив модификаторы стиля. Например, чтобы увеличить или уменьшить вешки и их метки, используйте модификатор стиля масштабирования sc. Этот модификатор принимает значение больше нуля. Значение 1 — это стандартный масштаб. Значения, превышающие 1, делают закрепление большими, а значения меньше 1 делают их меньше. Дополнительные сведения о модификаторах стиля см. в параметре Path команды Get Map Static Image.

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

  1. В приложении Postman выберите New (Создать).

  2. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос).

  3. Введите имя запроса, например GET, многоугольник.

  4. Выберите метод HTTP GET.

  5. Введите следующий URL-адрес службы отрисовки:

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}

  6. Выберите Отправить.

  7. Служба возвращает следующее изображение:

    Render a circle with custom pushpins.

  8. Затем измените цвет отжимов, изменив co модификатор стиля. Если вы посмотрите на значение pins параметра (pins=default|la15+50|al0.66|lc003C62|co002D62|), обратите внимание, что текущий цвет имеет значение #002D62. Чтобы изменить цвет #41d42a, замените #002D62 на #41d42a. Параметр pins теперь имеет значение pins=default|la15+50|al0.66|lc003C62|co41D42A|. Запрос должен выглядеть как следующий URL-адрес:

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}

  9. Выберите Отправить.

  10. Служба возвращает следующее изображение:

    Render a circle with updated pushpins.

Аналогичным образом можно изменять, добавлять и удалять другие модификаторы стиля.

Следующие шаги

Отрисовка — получение статического изображения карты