Поделиться через


Render - Get Map Static Image

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

Этот API включает параметры для базовой визуализации данных:

  • Канцелярные канцеляры в нескольких стилях.
  • Отрисовка геометрических типов кругов, контуров и многоугольников.

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

Размеры параметра bbox ограничены в зависимости от уровня масштаба. Это гарантирует, что полученное изображение имеет соответствующий уровень детализации.

Масштаб Диапазон min Lon Максимальный диапазон Лона Диапазон минимальных латов Максимальный диапазон латов
0 56,25 360.0 30.1105585173 180.0
1 28.125 360.0 14.87468995 180.0
2 14.063 351.5625 7.4130741851 137.9576312246
3 7.03125 175.78125 3.7034501005 73.6354071932
4 3.515625 87.890625 1.8513375155 35.4776115315
5 1.7578125 43.9453125 0.925620264 17.4589959239
6 0.87890625 21.97265625 0.4628040687 8.6907788223
7 0.439453125 10.986328125 0.2314012764 4.3404320789
8 0.2197265625 5.4931640625 0.1157005434 2.1695927024
9 0.1098632812 2.7465820312 0.0578502599 1.0847183194
10 0.0549316406 1.3732910156 0.0289251285 0.5423494021
11 0.0274658203 0.6866455078 0.014462564 0.2711734813
12 0.0137329102 0.3433227539 0.007231282 0.1355865882
13 0.0068664551 0.171661377 0.003615641 0.067793275
14 0.0034332275 0.0858306885 0.0018078205 0.0338966351
15 0.0017166138 0.0429153442 0.0009039102 0.0169483173
16 0.0008583069 0.0214576721 0.0004519551 0.0084741586
17 0.0004291534 0.0107288361 0.0002259776 0.0042370793
18 0.0002145767 0.005364418 0.0001129888 0.0021185396
19 0.0001072884 0.002682209 5.64944E-05 0.0010592698
20 5.36442E-05 0.0013411045 2.82472E-05 0.0005296349

Примечание . В API необходимо указать параметр center или bbox .

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Параметры URI

Имя В Обязательно Тип Описание
api-version
query True

string

Номер версии API Azure Maps Текущая версия — 01.04.2024.

bbox
query

number[]

Ограничивающий прямоугольник определяется двумя широтами и двумя долготами, которые представляют четыре стороны прямоугольной области на Земле. Формат: "minLon, minLat, maxLon, maxLat" (в double).

Примечание. Обязательные параметры — bbox или center. Они являются взаимоисключающими. Bbox не следует использовать с высотой или шириной.

Максимальный и минимальный допустимые диапазоны для Lat и Lon определяются для каждого уровня масштабирования в таблице в верхней части этой страницы.

center
query

number[]

Координаты центральной точки в double. Формат: "lon,lat". Диапазон долготы: от -180 до 180. Диапазон широт: от -90 до 90.

Примечание. Обязательные параметры — center или bbox. Они являются взаимоисключающими.

height
query

integer

int32

Высота результирующего изображения в пикселях. Диапазон от 80 до 1500. Значение по умолчанию — 512. Его не следует использовать с bbox.

language
query

string

Язык, на котором должны возвращаться результаты поиска. Должен быть одним из поддерживаемых тегов языка IETF без учета регистра. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию.

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

path
query

string[]

Стиль и расположения пути (в двойном формате). Используйте этот параметр для дополнительного добавления линий, многоугольников или кругов к изображению. Стиль пути описывает внешний вид линии и заливки. (Убедитесь, что этот параметр правильно кодирует URL-адрес, так как он будет содержать зарезервированные символы, такие как каналы и знаки препинания.)

Параметр Path поддерживается в SKU учетной записи Azure Maps, начиная с S1. Несколько экземпляров параметра path позволяют указать несколько геометрических объектов со своими стилями. Количество параметров на запрос ограничено 10, а количество расположений — 100 на путь.

Чтобы отобразить круг с радиусом 100 метров и центральной точкой в широте 45°N и долготе 122°W с помощью стиля по умолчанию, добавьте параметр querystring.

path=ra100||-122 45

Обратите внимание, что долгота приходится до широты. После кодирования URL-адреса это будет выглядеть следующим образом:

path=ra100%7C%7C-122+45

Во всех приведенных здесь примерах для ясности показан параметр path без кодировки URL-адреса.

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

path=||-122 45|-119.5 43.2|-121.67 47.12

Многоугольник указывается с закрытым путем, где первая и последняя точки равны. Например, используйте

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

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

Модификаторы стиля

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

Чтобы изменить цвет контура, используйте модификатор стиля "lc" и укажите цвет в формате HTML/CSS RGB, который представляет собой шестизначное шестнадцатеричное число (трехзначная форма не поддерживается). Например, чтобы использовать глубокий розовый цвет, который можно указать как #FF1493 в CSS, используйте

path=lcFF1493||-122 45|-119.5 43.2

Для создания более сложного визуального стиля можно объединить несколько модификаторов стиля.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

Сводка модификатора стиля

Модификатор Описание Type Диапазон
lc Цвет линии строка От 000000 до FFFFFF
fc Цвет заливки строка От 000000 до FFFFFF
la Line alpha (непрозрачность) FLOAT От 0 до 1
fa Альфа-заливка (непрозрачность) FLOAT От 0 до 1
lw Толщина линии int32 (0, 50]
Ра Радиус круга (метры) FLOAT Больше 0
pins
query

string[]

Стиль и экземпляры канцелярской кнопки. Используйте этот параметр, чтобы при необходимости добавить канцеляры в образ. Стиль канцелярской кнопки описывает внешний вид канцелярских ветвей, а экземпляры указывают координаты канцелярских опор (в двойном формате) и необязательные метки для каждого контакта. (Убедитесь, что значения этого параметра правильно кодируются в URL-адресе, так как он будет содержать зарезервированные символы, такие как каналы и знаки препинания.)

SKU S0 учетной записи Azure Maps поддерживает только один экземпляр параметра pins. Другие номера SKU позволяют нескольким экземплярам параметра pins указывать несколько стилей закрепления.

Чтобы отобразить канцеляр в широте 45°N и долготе 122°W с помощью встроенного стиля канцелярской кнопки по умолчанию, добавьте параметр querystring.

pins=default||-122 45

Обратите внимание, что долгота наступает перед широтой. После кодирования URL-адреса это будет выглядеть следующим образом:

pins=default%7C%7C-122+45

Для ясности во всех примерах показан параметр pins без кодировки URL-адреса.

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

pins=default||-122 45|-119.5 43.2|-121.67 47.12

SKU учетной записи S0 Azure Maps допускает только пять канцелярских ветвей. Другие номера SKU учетных записей не имеют этого ограничения.

Модификаторы стиля

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

Чтобы изменить цвет канцелярской кнопки, используйте модификатор стиля "co" и укажите цвет с помощью формата HTML/CSS RGB, который представляет собой шестизначное шестнадцатеричное число (трехзначная форма не поддерживается). Например, чтобы использовать глубокий розовый цвет, который можно указать как #FF1493 в CSS, используйте

pins=default|coFF1493||-122 45

Метки канцелярской кнопки

Чтобы добавить метку к контактам, поместите метку в одинарные кавычки непосредственно перед координатами. Избегайте использования специальных символов, таких как | или || , в метке. Например, чтобы пометить три контакта значениями "1", "2" и "3", используйте

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

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

pins=none||'A'-122 45|'B'-119.5 43.2

Чтобы изменить цвет меток канцелярской кнопки, используйте модификатор стиля цвета метки "lc". Например, чтобы использовать розовые канцелярские ветви с черными метками, используйте

pins=default|coFF1493|lc000000||-122 45

Чтобы изменить размер меток, используйте модификатор стиля размера метки "ls". Размер метки представляет приблизительную высоту текста метки в пикселях. Например, чтобы увеличить размер метки до 12, используйте

pins=default|ls12||'A'-122 45|'B'-119 43

Метки размещаются по центру на канцелярской кнопке "label anchor". Расположение привязки предопределено для встроенных канцелярских опор и находится в центре верхней части настраиваемых канцелярских опор (см. ниже). Чтобы переопределить привязку метки, используйте модификатор стиля la и укажите координаты пикселей X и Y для привязки. Эти координаты находятся относительно верхнего левого угла изображения канцелярской кнопки. Положительные значения X перемещают привязку вправо, а положительные значения Y — вниз. Например, чтобы разместить привязку метки на 10 пикселей вправо и на 4 пикселя над верхним левым углом изображения канцелярской кнопки, используйте

pins=default|la10 -4||'A'-122 45|'B'-119 43

Пользовательские канцелярская ветвь

Чтобы использовать пользовательское изображение канцелярской кнопки, используйте слово custom в качестве имени стиля булавки, а затем укажите URL-адрес после сведений о расположении и метки. Максимальный допустимый размер настраиваемого изображения метки составляет 65 536 пикселей. Используйте два символа, чтобы указать расположения и начать URL-адрес. Например,

pins=custom||-122 45||http://contoso.com/pushpins/red.png

После кодирования URL-адреса это будет выглядеть следующим образом:

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

По умолчанию пользовательские изображения отрисовываются по центру по координатам булавки. Обычно это не идеально, так как оно скрывает расположение, которое вы пытаетесь выделить. Чтобы переопределить расположение привязки изображения закрепления, используйте модификатор стиля "an". При этом используется тот же формат, что и модификатор стиля привязки метки "la". Например, если на пользовательском изображении закреплений есть кончик булавки в левом верхнем углу изображения, можно установить привязку к этой точке с помощью

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

Примечание. Если вы используете модификатор цвета co с пользовательским изображением канцелярской кнопки, указанный цвет заменит RGB-канал пикселей на изображении, но оставит альфа-канал (непрозрачность) без изменений. Обычно это делается только с помощью пользовательского изображения сплошного цвета.

Масштабирование, поворот и прозрачность

Вы можете увеличивать или уменьшать вешки и их метки с помощью модификатора стиля для масштабирования "sc". Это значение больше нуля. Значение 1 — это стандартный масштаб. Значения, превышающие 1, будут увеличивать кнопки, а меньше 1 будут их уменьшать. Например, чтобы нарисовать канцеляры на 50 % больше, чем обычно, используйте

pins=default|sc1.5||-122 45

Вы можете повернуть канцелярские опоры и их метки с помощью модификатора стиля поворота "ro". Это число градусов поворота по часовой стрелке. Используйте отрицательное число для поворота против часовой стрелки. Например, чтобы повернуть опоры на 90 градусов по часовой стрелке и удвоить их размер, используйте

pins=default|ro90|sc2||-122 45

Вы можете сделать кнопки и их метки частично прозрачными, указав модификатор альфа-стиля al. Это число от 0 до 1, указывающее непрозрачность опор. Ноль делает их полностью прозрачными (и невидимыми), а 1 делает их полностью непрозрачными (что по умолчанию). Например, чтобы сделать канцеляры и их метки непрозрачными только на 67 %, используйте

pins=default|al.67||-122 45

Сводка модификатора стиля

Модификатор Описание Type Диапазон
al Альфа (непрозрачность) FLOAT От 0 до 1
любой Закрепление привязки <int32, int32> *
co Цвет закрепления строка От 000000 до FFFFFF
la Привязка метки <int32, int32> *
lc Цвет метки строка От 000000 до FFFFFF
ls Размер метки FLOAT Больше 0
ro Поворот FLOAT От -360 до 360
Sc Масштабирование FLOAT Больше 0
  • Координаты X и Y могут находиться в любом месте закрепленного изображения или поля вокруг него. Размер поля — это минимальная ширина и высота булавки.
tilesetId
query

TilesetId

Возвращаемый стиль карты. Возможные значения: microsoft.base.road, microsoft.base.darkgrey и microsoft.imagery. Значение по умолчанию — microsoft.base.road. Дополнительные сведения см. в разделе Render TilesetId.

trafficLayer
query

TrafficTilesetId

Необязательное значение, указывающее на отсутствие потока трафика, наложенного на результат изображения. Возможные значения: microsoft.traffic.relative.main и none. Значение по умолчанию — none, указывающее, что поток трафика не возвращается. Если указан параметр tilesetId, связанный с трафиком, возвращает изображение карты с соответствующим уровнем трафика. Дополнительные сведения см. в разделе Render TilesetId.

view
query

LocalizedMapView

Параметр View (также называемый параметром user region) позволяет отобразить правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию для параметра View задано значение Unified, даже если вы не определили его в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное определение параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которых доступны карты, изображения и другие данные и содержимое сторонних производителей, доступ к которому вы имеете через Azure Maps. Пример: view=IN.

Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления .

width
query

integer

int32

Ширина результирующего изображения в пикселях. Диапазон от 80 до 2000. Значение по умолчанию — 512. Его не следует использовать с bbox.

zoom
query

integer

int32

Требуемый уровень масштабирования карты. Поддержка значения масштаба в диапазоне от 0 до 20 (включительно) для tilesetId— microsoft.base.road или microsoft.base.darkgrey. Поддержка значения масштаба в диапазоне от 0 до 19 (включительно) для tilesetId — microsoft.imagery. Значение по умолчанию — 12.

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток.

Заголовок запроса

Имя Обязательно Тип Описание
x-ms-client-id

string

Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности Идентификатора Microsoft Entra. Он представляет уникальный идентификатор для учетной записи Azure Maps и может быть получен из API учетной записи плоскости управления Azure Maps. Инструкции по использованию безопасности Microsoft Entra ID в Azure Maps см. в следующих статьях .

Accept

MediaType

Поле "Принять заголовок" можно использовать для указания настроек в отношении типов носителей ответов. Допустимые типы мультимедиа: image/jpeg и image/png. Возвращает изображение в image/png, если не указан заголовок Accept.

Ответы

Имя Тип Описание
200 OK

object

Это изображение возвращается из успешного вызова Get Map Static Image.

Media Types: "image/jpeg", "image/png"

Заголовки

Content-Type: string

Other Status Codes

ErrorResponse

Произошла непредвиденная ошибка.

Media Types: "image/jpeg", "image/png"

Безопасность

AADToken

Это потоки Microsoft Entra OAuth 2.0 . В сочетании с управлением доступом на основе ролей Azure его можно использовать для управления доступом к REST API Azure Maps. Элементы управления доступом на основе ролей Azure используются для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Любому пользователю, группе или субъекту-службе может быть предоставлен доступ через встроенную или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.

Для реализации сценариев рекомендуется ознакомиться с основными понятиями проверки подлинности. Таким образом, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, которые могут управлять доступом к определенным API и областям.

Примечания

  • Это определение безопасности требует использования заголовка x-ms-client-id , чтобы указать, к какому ресурсу Azure Maps приложение запрашивает доступ. Его можно получить из API управления Картами.

объект Authorization URL предназначен для экземпляра общедоступного облака Azure. Национальные облака имеют уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra. * Управление доступом на основе ролей Azure настраивается из плоскости управления Azure с помощью портала Azure, PowerShell, CLI, пакетов Sdk для Azure или REST API. * Использование веб-пакета SDK Azure Maps позволяет настраивать приложение на основе конфигурации для нескольких вариантов использования.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, который подготавливается при создании ресурса Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов AZURE SDK или REST API.

С помощью этого ключа любое приложение авторизовано для доступа ко всем REST API. Иными словами, в настоящее время их можно рассматривать как главные ключи учетной записи, для которой они выдаются.

Для общедоступных приложений мы рекомендуем использовать межсерверный доступ к REST API Azure Maps, где этот ключ можно безопасно хранить.

Тип: apiKey
В: header

SAS Token

Это маркер подписанного URL-адреса, который создается из операции SAS list в ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK для Azure или REST API.

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

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

Тип: apiKey
В: header

Примеры

Successful Static Image Request

Образец запроса

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Пример ответа

Content-Type: image/png
"{file}"

Определения

Имя Описание
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

LocalizedMapView

Параметр View (также называемый параметром user region) позволяет отобразить правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию для параметра View задано значение Unified, даже если вы не определили его в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное определение параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которых доступны карты, изображения и другие данные и содержимое сторонних производителей, доступ к которому вы имеете через Azure Maps. Пример: view=IN.

Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления .

MediaType

Поле "Принять заголовок" можно использовать для указания настроек в отношении типов носителей ответов. Допустимые типы мультимедиа: image/jpeg и image/png. Возвращает изображение в image/png, если не указан заголовок Accept.

TilesetId

Возвращаемый стиль карты. Возможные значения: microsoft.base.road, microsoft.base.darkgrey и microsoft.imagery. Значение по умолчанию — microsoft.base.road. Дополнительные сведения см. в разделе Render TilesetId.

TrafficTilesetId

Необязательное значение, указывающее на отсутствие потока трафика, наложенного на результат изображения. Возможные значения: microsoft.traffic.relative.main и none. Значение по умолчанию — none, указывающее, что поток трафика не возвращается. Если указан параметр tilesetId, связанный с трафиком, возвращает изображение карты с соответствующим уровнем трафика. Дополнительные сведения см. в разделе Render TilesetId.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект error.

LocalizedMapView

Параметр View (также называемый параметром user region) позволяет отобразить правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию для параметра View задано значение Unified, даже если вы не определили его в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное определение параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которых доступны карты, изображения и другие данные и содержимое сторонних производителей, доступ к которому вы имеете через Azure Maps. Пример: view=IN.

Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления .

Имя Тип Описание
AE

string

Объединенные Арабские Эмираты (арабское представление)

AR

string

Аргентина (аргентинское представление)

Auto

string

Данные карт возвращаются с учетом IP-адреса запроса.

BH

string

Бахрейн (арабское представление)

IN

string

Индия (индийское представление)

IQ

string

Ирак (арабское представление)

JO

string

Иордан (арабское представление)

KW

string

Кувейт (арабское представление)

LB

string

Ливан (арабское представление)

MA

string

Марокко (марокканское представление)

OM

string

Оман (арабское представление)

PK

string

Пакистан (пакистанское представление)

PS

string

Палестинская Автономия (арабское представление)

QA

string

Катар (арабское представление)

SA

string

Саудовская Аравия (арабское представление)

SY

string

Сирия (арабское представление)

Unified

string

Унифицированное представление (прочие)

YE

string

Йемен (арабское представление)

MediaType

Поле "Принять заголовок" можно использовать для указания настроек в отношении типов носителей ответов. Допустимые типы мультимедиа: image/jpeg и image/png. Возвращает изображение в image/png, если не указан заголовок Accept.

Имя Тип Описание
image/jpeg

string

Возвращает изображение в формате jpeg.

image/png

string

Возвращает изображение в формате PNG.

TilesetId

Возвращаемый стиль карты. Возможные значения: microsoft.base.road, microsoft.base.darkgrey и microsoft.imagery. Значение по умолчанию — microsoft.base.road. Дополнительные сведения см. в разделе Render TilesetId.

Имя Тип Описание
microsoft.base.darkgrey

string

TilesetId содержит все слои с темно-серым стилем.

microsoft.base.road

string

TilesetId содержит все слои с основным стилем отрисовки.

microsoft.imagery

string

TilesetId содержит сочетание спутниковых и аэроснимков.

TrafficTilesetId

Необязательное значение, указывающее на отсутствие потока трафика, наложенного на результат изображения. Возможные значения: microsoft.traffic.relative.main и none. Значение по умолчанию — none, указывающее, что поток трафика не возвращается. Если указан параметр tilesetId, связанный с трафиком, возвращает изображение карты с соответствующим уровнем трафика. Дополнительные сведения см. в разделе Render TilesetId.

Имя Тип Описание
microsoft.traffic.relative.main

string

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

none

string

Значение по умолчанию, без наложения потока трафика.