Azure Maps (предварительная версия)

Azure Maps предоставляет геопространственные API для сопоставления, маршрутизации, геокодирования и обратного геокодирования.

Этот соединитель доступен в следующих продуктах и регионах:

Service Class Regions
Copilot Studio Стандарт Все регионы Power Automate за исключением следующих:
     — Облако Китая, управляемое 21Vianet
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Azure регионы Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps кроме следующих:
     — Облако Китая, управляемое 21Vianet
Power Automate Стандарт Все регионы Power Automate за исключением следующих:
     — Облако Китая, управляемое 21Vianet
Contact
Имя Корпорация Майкрософт
URL https://www.microsoft.com/
Метаданные соединителя
Publisher Корпорация Майкрософт
Веб-сайт https://azure.microsoft.com/products/azure-maps
Политика конфиденциальности https://privacy.microsoft.com/privacystatement
Categories Данные; Продуктивность

Соединитель Azure Maps

Тип: Без кода | Уровня: Стандартный | Статус: Предварительный просмотр

Предоставляет возможности сопоставления, маршрутизации, геокодирования и обратного геокодирования через Azure Maps REST API. Запросы обрабатываются полностью политикой APIM— веб-приложение соединителя отсутствует.

Authentication

Проверка подлинности ключа API. Для подключений требуется ключ подписки Azure Maps.

Parameter Type Required Description
subscription_key securestring Yes Ключ подписки Azure Maps

Ключ извлекается из маркера подключения и передается в Azure Maps в качестве subscription-key параметра запроса политикой ( / CheckForTokenGetAuthHeaderValue).

Доступность облака

Облачные технологии Available
Публика Yes
Fairfax (GCC) Yes
GCC High Yes
DoD Yes

Действия

Получение маршрута — GetRoute

Вычислите маршрут вождения или ходьбы между двумя точками пути. Точки пути должны быть парами координат (latitude,longitude). Адреса не поддерживаются— геокодировать их сначала с помощью получения расположения по адресу.

Конечная точка (после политики):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Политика преобразует параметры запроса в стиль GET в текст GeoJSON FeatureCollection POST, переворачивает координаты в longitude,latitude порядок и сопоставляет значения и не оптимизирует значения в Azure Maps эквиваленты.

Parameter Required Type Description
Точка пути 1 (wp.0) Yes string Начальная точка как latitude,longitude (например, 47.610,-122.107)
Точка пути 2 (wp.1) Yes string Конечная точка как latitude,longitude (например, 47.612,-122.204)
Режим путешествия (travelMode) Нет string driving (по умолчанию) или walking
Избегайте шоссе Нет boolean Карты с avoid=limitedAccessHighways
Избегайте сборов Нет boolean Карты с avoid=tollRoads
Избегайте паромов Нет boolean Карты с avoid=ferries
Избегайте пересечения границ страны Нет boolean Карты с avoid=borderCrossings
Optimize Нет string fastestWithoutTraffic, fastestWithTraffic или shortest

Ответ: Сводка маршрута с расстоянием движения (метров), длительностью (в секундах), длительностью с трафиком (секунды) и сведениями о ногах маршрута.

Примечание: Транзитная маршрутизация не поддерживается. Azure Maps маршруты поддерживаются driving только и walking.

Получение расположения по адресу— GetLocationByAddress

Геокодируйте структурированный адрес для координат и сведений о расположении.

Конечная точка:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

Parameter Required Type Description
Адресная строка (addressLine) Нет string Линия улицы (например, 15595 NE 36th St)
Locality (locality) Нет string Город (например, Redmond)
Административный район (adminDistrict) Нет string Сокращение состояния (например, WA)
Почтовый индекс (postalCode) Нет string ПОЧТОВЫй индекс или почтовый индекс (например, 98052)
Регион страны (countryRegion) Нет string Код страны ISO 2-буквы (например) US
Максимальные результаты (top) Нет целое число 1–20, по умолчанию 5

Ответ: GeoJSON FeatureCollection. Каждая функция имеет:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Mediumили Low
  • properties.address— addressLine, locality, adminDistrictspostalCode, countryRegion (объект с name и ISO),formattedAddress

Примечание. Azure Maps геокодирование не поддерживает адреса в Китае.

Получение расположения по точкам — GetLocationByPoint

Обратная координата широты и долготы геокода на адрес.

Конечная точка (после политики):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

Политика объединяет отдельные latitude параметры и longitude параметры в coordinates параметр запроса в longitude,latitude порядке.

Parameter Required Type Description
Точка широты (latitude) Yes double Например, 47.64054
Точка долготы (longitude) Yes double Например, -122.12934

Ответ: Та же схема, что и получение расположения по адресу (GetLocationByAddress_Response).

Получение статической карты — GetMap

Получение изображения статической карты в центре точки.

Конечная точка (после политики):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Политика объединяет широту или долготу в center параметр (longitude,latitude), сопоставляется imagerySet со значением Azure Maps style и передает необязательную отжимку в качестве pins параметра.

Parameter Required Type Description
Центральная широта (latitude) Yes double Например, 47.64054
Центральная долгота (longitude) Yes double Например, -122.12934
Стиль карты (imagerySet) Yes string См. сопоставление стилей ниже
Уровень масштабирования (zoomLevel) Yes string 0–20, по умолчанию 10
Ширина (в пикселях) Нет целое число По умолчанию 512
Высота (в пикселях) Нет целое число По умолчанию 512
Формат изображения Нет string jpeg или png (по умолчанию png). GIF не поддерживается.
Широта pushpin Нет double Широта расположения pushpin
Долготу pushpin Нет double Долготу расположения pushpin
Метка pushpin Нет string Текст короткой метки

Сопоставление наборов изображений:

imagerySet ввод Azure Maps style
Road main
Aerial satellite
AerialWithLabels satellite_road_labels
CanvasDark dark
CanvasLight road_shaded_relief
CanvasGray grayscale_light

Ответ: Двоичный образ (image/jpeg или image/png). В Power Automate потоки текст ответа закодирован в кодировке Base64. Чтобы отобразить или сохранить изображение, выполните следующие действия.

  • base64ToBinary() Используйте выражение для преобразования перед сохранением в OneDrive/SharePoint.
  • Используйте html-таблицу или отправьте действие электронной почты с тегом <img src="data:image/png;base64,{body/$content}"> для отображения встроенных данных.

Заметки о политике

  • subscription-key внедряется политикой; он никогда не передается от вызывающего абонента.
  • origin Заголовки x-ms-apim-tokens и заголовки удаляются во входящий трафик.
  • Content-Type: application/json принудительно применяется ко всем запросам, не являющихся изображениями; Ответы изображений восстанавливают правильный image/* тип контента при исходящем трафике.
  • GetRoute преобразует простой запрос на параметр запроса в POST с текстом GeoJSON— вызывающие объекты не должны создавать текст самостоятельно.

Файлы

File Purpose
apiDefinition.swagger.json Определение OpenAPI
Развертывание илиpolicies.xml Политика APIM
Развертывание и PolicySourceCode.cs Логика C# политики
connector-config-internal.json Настройка проверки подлинности и среды
connector-config-cli.json Возможности (actions)
connector-config-certification.json Имя API (azuremaps) и уровень (стандартный)
connector-config-metadata.json Метаданные владения

Создание подключения

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

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя Type Description Required
Ключ подписки securestring Ключ подписки Azure Maps True

Действия

Получение маршрута (предварительная версия)

Вычислите маршрут вождения или ходьбы с помощью точек пути. Точки пути должны быть предоставлены в виде координат широты, долготы.
Получение расположения по адресу (предварительная версия)

Геокодирование адреса для получения координат и сведений о расположении.
Получение расположения по точкам (предварительная версия)

Получение сведений о расположении, связанных с координатами широты и долготы.
Получение статической карты (предварительная версия)

Получение изображения статической карты в центре точки. GIF не поддерживается; используйте JPEG или PNG.

Получение маршрута (предварительная версия)

Идентификатор операции:
GetRoute

Вычислите маршрут вождения или ходьбы с помощью точек пути. Точки пути должны быть предоставлены в виде координат широты, долготы.

Параметры

Имя Ключ Обязательно Тип Описание
Точка пути 1
 wp.0 True string

Начиная с точки зрения широты, долготы (например, 47,610,-122.107).
Точка пути 2
 wp.1 True string

Конечная точка пути в виде широты, долготы (например, 47,612,-122.204).
Режим путешествия
 travelMode string

Режим путешествия для маршрута.
Избегайте шоссе
 avoid_highways boolean

Избегает использования шоссе в маршруте.
Избегайте сборов
 avoid_tolls boolean

Избегает использования платных дорог в маршруте.
Избегайте паромов
 avoid_ferry boolean

Избегает использования паромов в маршруте.
Избегайте пересечения границ страны
 avoid_borderCrossing boolean

Избегает пересечения границ страны в маршруте.
Optimize
 optimize string

Указывает, для чего оптимизировать маршрут.

Возвращаемое значение

Тело
GetRoute_Response

Получение расположения по адресу (предварительная версия)

Идентификатор операции:
GetLocationByAddress

Геокодирование адреса для получения координат и сведений о расположении.

Параметры

Имя Ключ Обязательно Тип Описание
Адресная строка
 addressLine string

Линия улицы адреса (не включая город, штат и т. д.).
Местные жители (город)
 locality string

Местные жители, такие как город США.
Административный район (штат)
 adminDistrict string

Подразделение, например сокращение штата США (например, WA).
Почтовый индекс
 postalCode string

Почтовый или ПОЧТОВЫй индекс.
Регион страны
 countryRegion string

Код страны ISO 2-букв (например, США).
Максимальное количество результатов
 top integer

Максимальное количество возвращаемых результатов (1–20). Значение по умолчанию: 5.

Возвращаемое значение

Тело
GetLocationByAddress_Response

Получение расположения по точкам (предварительная версия)

Идентификатор операции:
GetLocationByPoint

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

Параметры

Имя Ключ Обязательно Тип Описание
Точка широты
 latitude True double

Координата широты для обратного геокода. Пример: 47.64054
Точка долготы
 longitude True double

Координата долготы для обратного геокода. Пример: -122.12934

Возвращаемое значение

Тело
GetLocationByAddress_Response

Получение статической карты (предварительная версия)

Идентификатор операции:
GetMap

Получение изображения статической карты в центре точки. GIF не поддерживается; используйте JPEG или PNG.

Параметры

Имя Ключ Обязательно Тип Описание
широта центра
 latitude True double

Широта центра карты. Пример: 47.64054
Центральная долгота
 longitude True double

Долгота центра карты. Пример: -122.12934
Стиль карты
 imagerySet True string

Стиль карты для отображения.
Уровень масштабирования
 zoomLevel True string

Уровень масштабирования от 0 до 20. Значение по умолчанию: 10
Ширина (в пикселях)
 width integer

Ширина выходного изображения в пикселях. По умолчанию: 512
Высота (в пикселях)
 height integer

Высота выходного изображения в пикселях. По умолчанию: 512
Формат изображения
 format string

Формат изображения. По умолчанию: png
Широта pushpin
 pushpinLatitude double

Широта pushpin.
Долготу pushpin
 pushpinLongitude double

Долготу pushpin.
Метка pushpin
 pushpinLabel string

Метка Pushpin (до 3 символов).

Возвращаемое значение

response
GetMap_Response

Определения

GetRoute_Response

Имя Путь Тип Описание
Type
 type string

Тип GeoJSON (always FeatureCollection).
Features
 features array of object

Массив функций GeoJSON: Waypoint (start/end), ManeuverPoint (повернутые шаги) и RoutePath (сводка маршрута).
Тип компонента
 features.type string
Geometry
 features.geometry object
Тип компонента
 features.properties.type string

Тип функции: Точка пути (начальные и конечные точки), Маневрpoint (пошаговый шаг) или RoutePath (общая сводка маршрута).
Расстояние (метры)
 features.properties.distanceInMeters float

Общее расстояние маршрута в метрах. Присутствует в функциях RoutePath.
Длительность (в секундах)
 features.properties.durationInSeconds integer

Предполагаемое время перемещения в секундах (без трафика). Присутствует в функциях RoutePath.
Задержка трафика (секунды)
 features.properties.trafficDelayInSeconds integer

Дополнительное время в секундах из-за трафика. Присутствует в функциях RoutePath.
Пробки
 features.properties.trafficCongestion string

Уровень перегрузки трафика (например, низкий, средний, высокий). Присутствует в функциях RoutePath.
Используемые данные трафика
 features.properties.trafficDataUsed string

Тип используемых данных трафика (например, None, Flow). Присутствует в функциях RoutePath.
Отъезд по адресу
 features.properties.departureAt string

Предполагаемое время отъезда (ISO 8601). Присутствует в функциях RoutePath.
Прибытие в
 features.properties.arrivalAt string

Предполагаемое время прибытия (ISO 8601). Присутствует в функциях RoutePath.
Текст инструкции
 features.properties.instruction.text string

Текст инструкций, доступный для чтения человеком (например, "Слева на NE 8th St").
Тип маневра
 features.properties.instruction.maneuverType string

Код типа маневра (например, TurnLeft, TurnRight, Straight, ArriveFinish).
Индекс точки пути
 features.properties.order.inputIndex integer

Индекс соответствующей входной точки пути (0 = начало, 1 = конец).
Индекс ноги
 features.properties.order.legIndex integer

Индекс ноги маршрута, к которой принадлежит эта функция.

GetLocationByAddress_Response

Имя Путь Тип Описание
Type
 type string

Тип GeoJSON (always FeatureCollection).
Features
 features array of object

Массив функций геокодированного расположения.
Тип компонента
 features.type string
Тип геометрии
 features.geometry.type string
Координаты
 features.geometry.coordinates array of double

Координаты как [долгота, широта].
Тип компонента
 features.properties.type string

Тип компонента: адрес или заполненное место.
Уверенность
 features.properties.confidence string

Уровень достоверности совпадения (высокий, средний, низкий).
Коды совпадений
 features.properties.matchCodes array of string

Коды совпадений (Хороший, неоднозначный, UpHierarchy).
Строка адреса
 features.properties.address.addressLine string

Адресная строка улицы.
Местные жители (город)
 features.properties.address.locality string

Город или населённый пункт.
Административные районы
 features.properties.address.adminDistricts array of object

Массив административных районов (например, штат, округ).
Короткое имя
 features.properties.address.adminDistricts.shortName string
Имя
 features.properties.address.adminDistricts.name string
Почтовый индекс
 features.properties.address.postalCode string

Почтовый или ПОЧТОВЫй индекс.
Регион страны
 features.properties.address.countryRegion string

Имя страны или региона.
Форматированный адрес
 features.properties.address.formattedAddress string

Полная отформатированная строка адреса.

GetMap_Response

Изображение карты
binary