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

Traffic - Get Traffic Incident Tile

  • Ссылка
Служба:
Maps
Версия API:
1.0

Используйте для получения 256 x 256 пикселей плитки с инцидентами дорожного движения.

API Traffic Incident Tile — это запрос HTTP GET, возвращающий плитки 256 x 256 пикселей с инцидентами трафика. Все плитки используют одну и ту же систему сетки. Так как плитки трафика используют прозрачные изображения, их можно слоить поверх плиток карты для создания составного дисплея. Плитки дорожного движения отображают графику, чтобы указать трафик на дорогах в указанной области.

GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
С использованием необязательных параметров: 
GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&t={t}

Параметры URI

Имя В Обязательно Тип Описание
format
 path True

TileFormat

Требуемый формат ответа. Возможные значения — png & pbf.
api-version
 query True

string

Номер версии API Azure Maps.
style
 query True

TrafficIncidentTileStyle

Стиль, используемый для отрисовки плитки. Этот параметр недопустим, если формат pbf.
x
 query True

integer (int32)

Координата X плитки в сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

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

integer (int32)

Координата Y плитки в сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

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

integer (int32)

Уровень масштабирования для требуемой плитки. Для растровых плитки значение должно находиться в диапазоне: 0–22 (включительно). Для векторных плитки значение должно находиться в диапазоне: 0–22 (включительно). Дополнительные сведения см. в уровнях масштабирования и сетке плиток.
t
 query

string

Эталонное значение для состояния трафика в определенное время, полученное из вызова API Viewport, атрибут trafficModelId в поле trafficState. Он обновляется каждую минуту и действителен в течение двух минут до истечения времени ожидания. Используйте -1 для получения последних сведений о трафике. Значение по умолчанию: последние сведения о трафике.

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

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

string

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

Ответы

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

object

Этот объект возвращается из успешного вызова плитки "Инцидент трафика"

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Заголовки

Content-Type: string
Other Status Codes

ErrorResponse

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

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

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

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 или с помощью PowerShell, CLI, пакетов SDK Azure или REST API.

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

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

Тип: apiKey
В: query

SAS Token

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

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

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

Тип: apiKey
В: header

Примеры

Request a tile depicting a traffic incident

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

GET https://atlas.microsoft.com/traffic/incident/tile/png?api-version=1.0&style=night&zoom=10&x=175&y=408

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

Код состояния:
200 
{}

Определения

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

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

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

Ответ на ошибку
TileFormat

Требуемый формат ответа. Возможные значения — png & pbf.
TrafficIncidentTileStyle

Стиль, используемый для отрисовки плитки. Этот параметр недопустим, если формат pbf.

ErrorAdditionalInfo

Object

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

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

object

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

string

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

ErrorDetail

Object

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

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

ErrorAdditionalInfo[]

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

string

Код ошибки.
details

ErrorDetail[]

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

string

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

string

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

ErrorResponse

Object

Ответ на ошибку

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

ErrorDetail

Объект ошибки.

TileFormat

Перечисление

Требуемый формат ответа. Возможные значения — png & pbf.

Значение Описание
pbf

Векторный рисунок в формате pbf. Поддерживает уровни масштабирования от 0 до 22.
png

Изображение в формате PNG. Поддерживает уровни масштабирования от 0 до 18.

TrafficIncidentTileStyle

Перечисление

Стиль, используемый для отрисовки плитки. Этот параметр недопустим, если формат pbf.

Значение Описание
night

Ночной стиль.
s1

Создает линии трафика с цветными шевронами, указывающими на серьезность.
s2

Создает обычные линии с определенной степенью свечения.
s3

Создает обычные линии с определенной степенью свечения, отличающейся от стиля s2.