Traffic - Get Traffic Flow Tile

Служба:

Maps

Версия API:

1.0

Используется для получения 256 x 256 пиксельных плиток с потоком трафика.

Замечание

Прекращение поддержки службы "Трафик Azure Maps версии 1"

Служба "Трафик Azure Maps" версии 1 объявлена устаревшей и будет прекращена 31.03.28. Чтобы избежать перебоев в обслуживании, все звонки к сервису Traffic v1 должны быть обновлены до 31.03.28. Дополнительные сведения см. в статье Перенос API трафика Azure Maps 1.0.

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

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}

С использованием необязательных параметров:

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

Параметры URI

Имя	В	Обязательно	Тип	Описание
format	path	True	TileFormat	Требуемый формат ответа. Возможные значения — png & pbf.
api-version	query	True	string	Номер версии API Azure Maps.
style	query	True	TrafficFlowTileStyle	Стиль, используемый для отрисовки плитки.
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 (включительно). Дополнительные сведения см. в уровнях масштабирования и сетке плиток.
thickness	query		integer (int32) minimum: 1 maximum: 20	Значение ширины строки, представляющей трафик. Это значение является умножением и допустимым диапазоном значений от 1 до 20. Значение по умолчанию — 10. Этот параметр недопустим, если формат pbf.

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

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает учетную запись, предназначенную для использования с моделью безопасности Microsoft Entra ID. Этот уникальный идентификатор для учетной записи Azure Maps можно получить с помощью API учетной записи плоскости управления Azure Maps. Дополнительные сведения об использовании безопасности Microsoft Entra ID в Azure Maps см. в статье Управление проверкой подлинности в 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 tile depicting the traffic flow

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

HTTP

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

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

Код состояния:

200

"binary string image"

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
TileFormat	Требуемый формат ответа. Возможные значения — png & pbf.
TrafficFlowTileStyle	Стиль, используемый для отрисовки плитки.

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.

Значение	Описание
png	Изображение в формате PNG. Поддерживает уровни масштабирования от 0 до 18.
pbf	Векторный рисунок в формате pbf. Поддерживает уровни масштабирования от 0 до 22.

TrafficFlowTileStyle

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

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

Значение	Описание
absolute	Цвета отражают абсолютную скорость измерения. Абсолютная скорость — это возможность доступа к полной скорости.
relative	Это скорость относительно свободного потока, выделение областей перегрузки визуализации потока трафика. Свободный поток относится к условиям, в которых нет заторможения, и трафик может следовать ограничениям скорости. Наиболее используемый вариант визуализации потока трафика на карте.
relative-delay	Отображает относительные цвета только в том случае, если они отличаются от скоростей свободного потока. Этот параметр будет выделять только области перегрузки.
reduced-sensitivity	Отображает относительные цвета, но для изменения цвета требуется большее различие от свободного потока. Этот режим действителен только в том случае, если формат png.