Render - Get Map Attribution

Ссылка

Служба:: Maps

Версия API:: 2024-04-01

Используйте для получения сведений об авторских правах на карту.

Get Map Attribution API позволяет пользователям запрашивать сведения об авторских правах на карту для раздела набора плиток.

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	string	Номер версии API Azure Maps Текущая версия — 01.04.2024.
bounds	query	True	number[]	Строка, представляющая прямоугольную область ограничивающего прямоугольника. Параметр bounds определяется 4 координатами ограничивающего прямоугольного прямоугольна, с долготой и широтой WGS84 юго-западного угла, а затем wgs84 долготой и широтой северо-восточного угла. Строка представлена в следующем формате: `[SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude]`.
tilesetId	query	True	TilesetID	Набор плиток — это коллекция растровых или векторных данных, разбитая на однородную сетку квадратных плиток с предустановленными уровнями масштаба. Каждый набор плиток имеет tilesetId , используемый при выполнении запросов. TilesetId для наборов плиток, созданных с помощью Azure Maps Creator, создаются с помощью API создания набора плиток. Ниже перечислены готовые наборы плиток, предоставляемые Azure Maps. Например, microsoft.base.
zoom	query	True	integer int32	Уровень масштабирования для требуемой атрибуции карты.

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

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

Ответы

Имя	Тип	Описание
200 OK	MapAttribution	ОК
Other Status Codes	ErrorResponse	Произошла непредвиденная ошибка.

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

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 Attribution Request

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

HTTP

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372

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

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

{
  "copyrights": [
    "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
  ]
}

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
MapAttribution	Присвоение авторских прав для запрошенного раздела набора фрагментов.
TilesetID	Набор плиток — это коллекция растровых или векторных данных, разбитая на однородную сетку квадратных плиток с предустановленными уровнями масштаба. Каждый набор плиток имеет tilesetId , используемый при выполнении запросов. TilesetId для наборов плиток, созданных с помощью Azure Maps Creator, создаются с помощью API создания набора плиток. Ниже перечислены готовые наборы плиток, предоставляемые Azure Maps. Например, microsoft.base.

ErrorAdditionalInfo

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

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

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

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

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

Имя	Тип	Описание
error	ErrorDetail	Объект error.

MapAttribution

Присвоение авторских прав для запрошенного раздела набора фрагментов.

Имя	Тип	Описание
copyrights	string[]	Список строк авторских прав.

TilesetID

Набор плиток — это коллекция растровых или векторных данных, разбитая на однородную сетку квадратных плиток с предустановленными уровнями масштаба. Каждый набор плиток имеет tilesetId , используемый при выполнении запросов. TilesetId для наборов плиток, созданных с помощью Azure Maps Creator, создаются с помощью API создания набора плиток. Ниже перечислены готовые наборы плиток, предоставляемые Azure Maps. Например, microsoft.base.

Имя	Тип	Описание
microsoft.base	string	Базовая карта — это стандартная карта, отображающая дороги, природные и искусственные признаки, а также метки для этих признаков в векторной плитке. Поддерживает уровни масштабирования от 0 до 22. Формат: vector (pbf).
microsoft.base.darkgrey	string	Все слои с нашим темно-серым стилем. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.base.hybrid	string	Отображает данные дороги, границы и метки в векторной плитке. Поддерживает уровни масштабирования от 0 до 22. Формат: vector (pbf).
microsoft.base.hybrid.darkgrey	string	Данные дорог, границ и меток в нашем темно-сером стиле. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.base.hybrid.road	string	Данные дорог, границ и меток в нашем основном стиле. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.base.labels	string	Отображает метки для дорог, естественных и искусственных признаков в векторной плитке. Поддерживает уровни масштабирования от 0 до 22. Формат: vector (pbf).
microsoft.base.labels.darkgrey	string	Пометка данных в нашем темно-сером стиле. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.base.labels.road	string	Пометка данных в основном стиле. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.base.road	string	Все слои с нашим основным стилем. Поддерживает уровни масштабирования от 0 до 22. Формат: растровый (png).
microsoft.imagery	string	Сочетание спутниковых и аэроснимков. Доступно только в ценовом номере SKU S1. Поддерживает уровни масштабирования от 1 до 19. Формат: растровый (jpeg).
microsoft.terra.main	string	Затенение рельефа и слои терры. Поддерживает уровни масштаба от 0 до 6. Формат: растровый (png).
microsoft.traffic.absolute	string	плитки абсолютного трафика в векторе
microsoft.traffic.absolute.main	string	плитки абсолютного трафика в растре в нашем основном стиле.
microsoft.traffic.delay	string	плитки трафика в векторе
microsoft.traffic.delay.main	string	плитки трафика в растре в нашем основном стиле
microsoft.traffic.incident	string	плитки инцидентов в векторе
microsoft.traffic.reduced.main	string	плитки с уменьшенным трафиком в растре в нашем основном стиле
microsoft.traffic.relative	string	плитки относительного трафика в векторе
microsoft.traffic.relative.dark	string	плитки относительного трафика в растре в нашем темном стиле.
microsoft.traffic.relative.main	string	плитки относительного трафика в растре в нашем основном стиле.
microsoft.weather.infrared.main	string	Плитки с инфракрасной погодой. Последние инфракрасные спутниковые снимки показывают облака по их температуре. Дополнительные сведения см. в статье Покрытие метеорологических служб Azure Maps. Дополнительные сведения о возвращаемых спутниковых данных см. в статье Службы погоды в Azure Maps. Поддерживает уровни масштабирования от 0 до 15. Формат: растровый (png).
microsoft.weather.radar.main	string	Плитки метеорологического радара. Последние изображения метеорологических радаров, включая области дождя, снега, льда и смешанных условий. Дополнительные сведения о покрытии службы погоды Azure Maps см. в статье Покрытие метеорологических служб Azure Maps. Дополнительные сведения о данных радаров см. в статье Службы погоды в Azure Maps. Поддерживает уровни масштабирования от 0 до 15. Формат: растровый (png).

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