Azure Maps (Prévisualização)

O Azure Maps fornece APIs geoespaciais para mapeamento, encaminhamento, geocodificação e geocodificação reversa.

Este conector está disponível nos seguintes produtos e regiões:

Service Class Regiões
Estúdio Copiloto Standard Todas as regiões Power Automate exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Standard Todas as regiões Power Apps exceto as seguintes:
     - China Cloud operado pela 21Vianet
Power Automate Standard Todas as regiões Power Automate exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contact
Nome Microsoft
URL https://www.microsoft.com/
Metadados do conector
Publisher Microsoft
Sítio Web https://azure.microsoft.com/products/azure-maps
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Dados; Produtividade

Azure Maps Connector

Tipo: Sem código | Tier: Standard | Estado: Pré-visualização

Fornece capacidades de mapeamento, encaminhamento, geocodificação e geocodificação reversa através da API Azure Maps REST. Os pedidos são tratados inteiramente pela política APIM — não existe uma aplicação web conectora.

Authentication

Autenticação de chave API. As ligações requerem uma chave de subscrição do Azure Maps.

Parâmetro Tipo Required Description
subscription_key securestring Yes Azure Maps subscription key

A chave é extraída do token de ligação e passada para o Azure Maps como subscription-key parâmetro de consulta pela política ( / CheckForTokenGetAuthHeaderValue).

Disponibilidade na Cloud

Nuvem Available
Public Yes
Fairfax (GCC) Yes
GCC High Yes
Departamento de Defesa dos EUA (DoD) Yes

Ações

Obtém rota — GetRoute

Calcule uma rota de condução ou a pé entre dois pontos de passagem. Os pontos de passagem devem ser pares de coordenadas (latitude,longitude). Não são suportados endereços — geocodifica-os primeiro usando Obter localização por endereço.

Endpoint (após a política):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

A política converte os parâmetros de consulta ao estilo GET num corpo GeoJSON FeatureCollection POST, inverte coordenadas para longitude,latitude ordem e mapeia valores de evitação/otimização para equivalentes ao Azure Maps.

Parâmetro Required Tipo Description
Ponto de Passagem 1 (wp.0) Yes cadeia (de caracteres) Ponto de partida como latitude,longitude (por exemplo) 47.610,-122.107
Ponto de Passagem 2 (wp.1) Yes cadeia (de caracteres) Ponto final como latitude,longitude (por exemplo) 47.612,-122.204
Modo de viagem (travelMode) No cadeia (de caracteres) driving (predefinido) ou walking
Evite rodovias No boolean Mapas para avoid=limitedAccessHighways
Evite portagens No boolean Mapas para avoid=tollRoads
Evite ferries No boolean Mapas para avoid=ferries
Evite atravessar as fronteiras dos países No boolean Mapas para avoid=borderCrossings
Optimize No cadeia (de caracteres) fastestWithoutTraffic, fastestWithTraffic ou shortest

Resposta: Resumo do percurso com distância de viagem (metros), duração (segundos), duração com o trânsito (segundos) e detalhes do percurso.

Nota: O encaminhamento de trânsito não é suportado. Azure Maps Route Directions apenas suporta driving e walking.

Obtenha a localização por morada — GetLocationByAddress

Geocodifica um endereço estruturado para coordenadas e detalhes de localização.

Ponto final:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

Parâmetro Required Tipo Description
Linha de endereçamento (addressLine) No cadeia (de caracteres) Linha da rua (por exemplo) 15595 NE 36th St
Localidade (locality) No cadeia (de caracteres) Cidade (por exemplo) Redmond
Distrito administrativo (adminDistrict) No cadeia (de caracteres) Abreviatura de estado (por exemplo, WA)
Código postal (postalCode) No cadeia (de caracteres) ZIP ou código postal (por exemplo 98052)
Região rural (countryRegion) No cadeia (de caracteres) Código de país ISO de 2 letras (por exemplo US)
Resultados máximos (top) No número inteiro 1–20, padrão 5

Resposta: GeoJSON FeatureCollection. Cada funcionalidade tem:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Medium, ou Low
  • properties.address — addressLine, locality, adminDistricts, postalCode, ( countryRegion objeto com name e ISO), formattedAddress

Nota: A geocodificação do Azure Maps não suporta endereços na China.

Obtenha localização por ponto — GetLocationByPoint

Inverta coordenadas de latitude/longitude geocódigo para um endereço.

Endpoint (após a política):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

A política combina os parâmetros separados latitude e longitude no coordinates parâmetro de consulta por longitude,latitude ordem.

Parâmetro Required Tipo Description
Latitude pontual (latitude) Yes double por exemplo, 47.64054
Longitude pontual (longitude) Yes double por exemplo, -122.12934

Resposta: O mesmo esquema de Obter localização por endereço (GetLocationByAddress_Response).

Obtenha um mapa estático — GetMap

Obtém uma imagem estática centrada num ponto.

Endpoint (após a política):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

A política combina latitude/longitude no center parâmetro (longitude,latitude), mapeia imagerySet para o valor do Azure Maps style e passa o alfinete opcional como pins parâmetro.

Parâmetro Required Tipo Description
Latitude central (latitude) Yes double por exemplo, 47.64054
Longitude central (longitude) Yes double por exemplo, -122.12934
Estilo de mapa (imagerySet) Yes cadeia (de caracteres) Ver mapeamento de estilo abaixo
Nível de zoom (zoomLevel) Yes cadeia (de caracteres) 0–20, padrão 10
Largura (pixels) No número inteiro Padrão 512
Altura (pixels) No número inteiro Padrão 512
Formato de imagem No cadeia (de caracteres) jpeg ou png (por defeito png). GIF não é suportado.
Latitude do pino No double Latitude de localização do alfinete
Longitude do pino No double Longitude de localização do alfinete
Etiqueta de pino No cadeia (de caracteres) Texto do rótulo curto

Mapeamento de conjuntos de imagens:

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

Resposta: Imagem binária (image/jpeg ou image/png). Nos fluxos do Power Automate, o corpo de resposta é codificado em base64. Para mostrar ou guardar a imagem:

  • Use a base64ToBinary() expressão para converter antes de guardar no OneDrive/SharePoint.
  • Use uma tabela HTML ou Enviar uma ação de email com uma <img src="data:image/png;base64,{body/$content}"> etiqueta para renderizar inline.

Notas de Política

  • subscription-key é injetada pela política; nunca é transmitido pelo chamador.
  • Os x-ms-apim-tokens cabeceamentos e origin são cortados em reboque.
  • Content-Type: application/json é forçado a todos os pedidos que não sejam de imagem; As respostas de imagem restauram o tipo de conteúdo correto image/* no outbound.
  • GetRoute converte um pedido simples de parâmetro de consulta num POST com um corpo GeoJSON — os chamadores não precisam de construir o corpo eles próprios.

Ficheiros

File Purpose
apiDefinition.swagger.json Definição OpenAPI
Desdobramento/policies.xml Política APIM
Desdobramento/PolicySourceCode.cs Lógica de política C#
connector-config-internal.json Autenticação e configuração do ambiente
connector-config-cli.json Capacidades (actions)
connector-config-certification.json Nome da API (azuremaps) e nível (Standard)
connector-config-metadata.json Metadados de propriedade

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome Tipo Description Required
Chave de subscrição securestring Azure Maps subscription key True

Ações

Obtenha localização por morada (Pré-visualização)

Geocodifica um endereço para obter as suas coordenadas e detalhes de localização.
Obtenha localização por ponto (Pré-visualização)

Obtenha as informações de localização associadas às coordenadas de latitude e longitude.
Obter a rota (Pré-visualização)

Calcule uma rota de condução ou de caminhada usando pontos de passagem. Os pontos de passagem devem ser fornecidos como coordenadas de latitude e longitude.
Obter mapa estático (Pré-visualização)

Obtém uma imagem estática centrada num ponto. O GIF não é suportado; Usa JPEG ou PNG.

Obtenha localização por morada (Pré-visualização)

ID da Operação:
GetLocationByAddress

Geocodifica um endereço para obter as suas coordenadas e detalhes de localização.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Linha de endereço
 addressLine string

A linha da rua de um endereço (sem incluir cidade, estado, etc.).
Localidade (Cidade)
 locality string

A localidade, como uma cidade dos EUA.
Distrito administrativo (Estado)
 adminDistrict string

Uma subdivisão, como uma abreviatura de estado dos EUA (por exemplo, WA).
Código postal
 postalCode string

O código postal ou postal.
Região do país
 countryRegion string

O código de país ISO de 2 letras (por exemplo, EUA).
Resultados máximos
 top integer

Número máximo de resultados a devolver (1-20). Padrão: 5.

Devoluções

Body
GetLocationByAddress_Response

Obtenha localização por ponto (Pré-visualização)

ID da Operação:
GetLocationByPoint

Obtenha as informações de localização associadas às coordenadas de latitude e longitude.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Latitude do ponto
 latitude True double

A coordenada de latitude para inverter o geocódigo. Exemplo: 47.64054
Longitude do ponto
 longitude True double

A coordenada de longitude para inverter o geocódigo. Exemplo: -122.12934

Devoluções

Body
GetLocationByAddress_Response

Obter a rota (Pré-visualização)

ID da Operação:
GetRoute

Calcule uma rota de condução ou de caminhada usando pontos de passagem. Os pontos de passagem devem ser fornecidos como coordenadas de latitude e longitude.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Ponto de passagem 1
 wp.0 True string

Ponto de passagem inicial como latitude, longitude (por exemplo, 47.610,-122.107).
Ponto de passagem 2
 wp.1 True string

Ponto de passagem final como latitude, longitude (por exemplo, 47.612,-122.204).
Modo de viagem
 travelMode string

O modo de viagem para a rota.
Evite rodovias
 avoid_highways boolean

Evita o uso de rodovias no percurso.
Evite portagens
 avoid_tolls boolean

Evita o uso de estradas com portagem no percurso.
Evite ferries
 avoid_ferry boolean

Evita o uso de balsas na rota.
Evite atravessar as fronteiras dos países
 avoid_borderCrossing boolean

Evita atravessar as fronteiras do país na rota.
Optimize
 optimize string

Especifica para que otimizar a rota.

Devoluções

Body
GetRoute_Response

Obter mapa estático (Pré-visualização)

ID da Operação:
GetMap

Obtém uma imagem estática centrada num ponto. O GIF não é suportado; Usa JPEG ou PNG.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Latitude central
 latitude True double

A latitude do centro do mapa. Exemplo: 47.64054
Longitude central
 longitude True double

A longitude do centro do mapa. Exemplo: -122.12934
Estilo do mapa
 imagerySet True string

O estilo do mapa a exibir.
Nível de zoom
 zoomLevel True string

O nível de zoom entre 0 e 20. Padrão: 10
Largura (pixels)
 width integer

A largura da imagem de saída em pixels. Padrão: 512
Altura (pixels)
 height integer

A altura da imagem de saída em pixels. Padrão: 512
Formato de imagem
 format string

O formato da imagem. Padrão: png
Latitude do pino
 pushpinLatitude double

Latitude de alfinete.
Longitude do pino
 pushpinLongitude double

Longitude do alfinete.
Etiqueta de pino
 pushpinLabel string

Etiqueta de alfinete (até 3 caracteres).

Devoluções

response
GetMap_Response

Definições

GetRoute_Response

Name Caminho Tipo Descrição
Tipo
 type string

Tipo GeoJSON (sempre FeatureCollection).
Features
 features array of object

Conjunto de funcionalidades GeoJSON: Waypoint (início/fim), ManeuverPoint (passos passo a passo) e RoutePath (resumo da rota).
Tipo de recurso
 features.type string
Geometry
 features.geometry object
Tipo de Funcionalidade
 features.properties.type string

Tipo de funcionalidade: Waypoint (pontos de início/fim), Maneuverpoint (passo a passo) ou RoutePath (resumo geral da rota).
Distância (metros)
 features.properties.distanceInMeters float

Distância total do percurso em metros. Presente nas funcionalidades do RoutePath.
Duração (segundos)
 features.properties.durationInSeconds integer

Tempo estimado de viagem em segundos (sem trânsito). Presente nas funcionalidades do RoutePath.
Atraso no trânsito (segundos)
 features.properties.trafficDelayInSeconds integer

Tempo extra em segundos devido ao trânsito. Presente nas funcionalidades do RoutePath.
Congestionamento de tráfego
 features.properties.trafficCongestion string

Nível de congestionamento de trânsito (por exemplo, Baixo, Médio, Alto). Presente nas funcionalidades do RoutePath.
Dados de tráfego utilizados
 features.properties.trafficDataUsed string

Tipo de dados de tráfego utilizados (por exemplo, Nenhum, Fluxo). Presente nas funcionalidades do RoutePath.
Partida em
 features.properties.departureAt string

Tempo estimado de partida (ISO 8601). Presente nas funcionalidades do RoutePath.
Chegada a
 features.properties.arrivalAt string

Tempo estimado de chegada (ISO 8601). Presente nas funcionalidades do RoutePath.
Texto de Instrução
 features.properties.instruction.text string

Texto de instruções legível para humanos (por exemplo, 'Vire à esquerda na NE 8th St').
Tipo de manobra
 features.properties.instruction.maneuverType string

Código de tipo de manobra (ex.: VirarEsquerda, VirarDireita, Reto, Chegar Final).
Índice de Pontos de Passagem
 features.properties.order.inputIndex integer

Índice do ponto de passagem de entrada correspondente (0 = início, 1 = fim).
Índice de Pernas
 features.properties.order.legIndex integer

Índice do percurso a que esta característica pertence.

GetLocationByAddress_Response

Name Caminho Tipo Descrição
Tipo
 type string

Tipo GeoJSON (sempre FeatureCollection).
Features
 features array of object

Conjunto de características de localização geocodificadas.
Tipo de recurso
 features.type string
Tipo de geometria
 features.geometry.type string
Coordenadas
 features.geometry.coordinates array of double

Coordenadas como [longitude, latitude].
Tipo de Funcionalidade
 features.properties.type string

Tipo de funcionalidade: Endereço ou PopulatedPlace.
Confiança
 features.properties.confidence string

Nível de confiança do jogo (Alto, Médio, Baixo).
Códigos de Jogo
 features.properties.matchCodes array of string

Códigos de correspondência (Bom, Ambíguo, Acima na Hierarquia).
Linha de endereço
 features.properties.address.addressLine string

Linha de endereço.
Localidade (Cidade)
 features.properties.address.locality string

Cidade ou localidade.
Distritos Administrativos
 features.properties.address.adminDistricts array of object

Conjunto de distritos administrativos (por exemplo, estado, condado).
Nome curto
 features.properties.address.adminDistricts.shortName string
Nome
 features.properties.address.adminDistricts.name string
Código Postal
 features.properties.address.postalCode string

Código postal ou CEP.
Região do País
 features.properties.address.countryRegion string

Nome do país ou da região.
Endereço formatado
 features.properties.address.formattedAddress string

Cadeia de endereços formatada completa.

GetMap_Response

Imagem do Mapa
binary