Azure Mapas (versão prévia)

Azure Mapas fornece APIs geoespaciais para mapeamento, roteamento, geocodificação e geocodificação reversa.

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

Service Class Regions
Copilot Studio Standard Todas as regiões Power Automate exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     - Azure regiões da 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
Publicador Microsoft
Site https://azure.microsoft.com/products/azure-maps
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Dados; Produtividade

Conector do Azure Mapas

Tipo: Sem código | Camada: Padrão | Status: Visualizar

Fornece recursos de mapeamento, roteamento, geocodificação e geocodificação reversa por meio da API REST Azure Mapas. As solicitações são tratadas inteiramente pela política APIM – não há nenhum aplicativo Web do conector.

Authentication

Autenticação de chave de API. As conexões exigem uma chave de assinatura Azure Mapas.

Parâmetro Tipo Required Descrição
subscription_key secureString Sim Chave de assinatura do Azure Mapas

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

Disponibilidade de nuvem

Nuvem Available
Público Sim
Fairfax (GCC) Sim
GCC High Sim
DoD Sim

Ações

Obter rota — GetRoute

Calcule uma rota de condução ou caminhada entre dois pontos de passagem. Os pontos de passagem devem ser pares de coordenadas (latitude,longitude). Não há suporte para endereços – geocodificá-los primeiro usando Obter localização por endereço.

Ponto de extremidade (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 no estilo GET em um corpo POST GeoJSONFeatureCollection, inverte coordenadas em longitude,latitude ordem e mapeia valores de evitar/otimizar para Azure Mapas equivalentes.

Parâmetro Required Tipo Descrição
Waypoint 1 (wp.0) Sim cadeia Ponto de partida como latitude,longitude (por exemplo 47.610,-122.107)
Waypoint 2 (wp.1) Sim cadeia Ponto final como latitude,longitude (por exemplo 47.612,-122.204)
Modo de viagem (travelMode) No cadeia driving (padrão) ou walking
Evitar rodovias No booliano Mapeia para avoid=limitedAccessHighways
Evitar pedágios No booliano Mapeia para avoid=tollRoads
Evitar balsas No booliano Mapeia para avoid=ferries
Evite cruzar fronteiras do país No booliano Mapeia para avoid=borderCrossings
Optimize No cadeia fastestWithoutTraffic, fastestWithTraffic ou shortest

Resposta: Resumo da rota com distância de viagem (metros), duração (segundos), duração com tráfego (segundos) e detalhes da perna da rota.

Nota: Não há suporte para roteamento de trânsito. O Azure Mapas rotear direções só dá driving suporte e walking.

Obter localização por endereço — GetLocationByAddress

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

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

Parâmetro Required Tipo Descrição
Linha de endereço (addressLine) No cadeia Linha de rua (por exemplo 15595 NE 36th St)
Localidade (locality) No cadeia Cidade (por exemplo Redmond)
Distrito de administração (adminDistrict) No cadeia Abreviação de estado (por exemplo WA)
Cep (postalCode) No cadeia CEP ou cep (por exemplo 98052)
Região do país (countryRegion) No cadeia Código do país iso de 2 letras (por exemplo US)
Resultados máximos (top) No inteiro 1 a 20, padrão 5

Resposta: GeoJSON FeatureCollection. Cada recurso tem:

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

Observação: Azure Mapas geocodificação não dá suporte a endereços na China.

Obter localização por ponto — GetLocationByPoint

Coordenadas inversas de latitude/longitude de código geográfico para um endereço.

Ponto de extremidade (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 e longitude separados latitude no parâmetro de coordinates consulta em longitude,latitude ordem.

Parâmetro Required Tipo Descrição
Latitude de ponto (latitude) Sim double Por exemplo: 47.64054
Longitude de ponto (longitude) Sim double Por exemplo: -122.12934

Resposta: Mesmo esquema que Obter localização por endereço (GetLocationByAddress_Response).

Obter mapa estático — GetMap

Obtenha uma imagem de mapa estático centralizada em um ponto.

Ponto de extremidade (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 Azure Mapas style e passa o pushpin opcional como um pins parâmetro.

Parâmetro Required Tipo Descrição
Latitude central (latitude) Sim double Por exemplo: 47.64054
Longitude central (longitude) Sim double Por exemplo: -122.12934
Estilo de mapa (imagerySet) Sim cadeia Veja o mapeamento de estilos abaixo
Nível de zoom (zoomLevel) Sim cadeia 0 a 20, padrão 10
Largura (pixels) No inteiro Padrão 512
Altura (pixels) No inteiro Padrão 512
Formato de imagem No cadeia jpeg ou png (padrão png). Não há suporte para GIF.
Latitude do pino de push No double Latitude do local do pushpin
Longitude de pino de push No double Longitude do local do pushpin
Rótulo de pushpin No cadeia Texto de rótulo curto

Mapeamento do conjunto de imagens:

imagerySet Entrada Azure Mapas 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). Em Power Automate fluxos, o corpo da resposta é codificado em base64. Para exibir ou salvar a imagem:

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

Notas da política

  • subscription-key é injetado pela política; ele nunca é passado pelo chamador.
  • Os x-ms-apim-tokens cabeçalhos e os origin cabeçalhos são despojados na entrada.
  • Content-Type: application/json é forçado em todas as solicitações que não são de imagem; as respostas de imagem restauram o tipo de conteúdo correto image/* na saída.
  • GetRoute converte uma solicitação simples de parâmetro de consulta em um POST com um corpo GeoJSON — os chamadores não precisam construir o próprio corpo.

Arquivos

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

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default 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.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome Tipo Descrição Required
Chave de Assinatura secureString Chave de assinatura do Azure Mapas True

Ações

Obter localização por endereço (versão prévia)

Geocodificar um endereço para obter suas coordenadas e detalhes de localização.
Obter localização por ponto (versão prévia)

Obtenha as informações de localização associadas às coordenadas de latitude e longitude.
Obter mapa estático (versão prévia)

Obtenha uma imagem de mapa estático centralizada em um ponto. Não há suporte para GIF; use JPEG ou PNG.
Obter rota (versão prévia)

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

Obter localização por endereço (versão prévia)

ID da operação:
GetLocationByAddress

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Linha de endereço
 addressLine string

A linha de rua de um endereço (não incluindo cidade, estado, etc.
Localidade (Cidade)
 locality string

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

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

O cep ou CEP.
Região do país
 countryRegion string

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

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

Retornos

Corpo
GetLocationByAddress_Response

Obter localização por ponto (versão prévia)

ID da operação:
GetLocationByPoint

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Latitude de ponto
 latitude True double

A coordenada de latitude para reverter o código geográfico. Exemplo: 47.64054
Longitude de ponto
 longitude True double

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

Retornos

Corpo
GetLocationByAddress_Response

Obter mapa estático (versão prévia)

ID da operação:
GetMap

Obtenha uma imagem de mapa estático centralizada em um ponto. Não há suporte para GIF; use JPEG ou PNG.

Parâmetros

Nome Chave Obrigatório Tipo Description
Latitude central
 latitude True double

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

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

O estilo de mapa a ser exibido.
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 de push
 pushpinLatitude double

Latitude de pino de push.
Longitude de pino de push
 pushpinLongitude double

Longitude por pushpin.
Rótulo de pushpin
 pushpinLabel string

Rótulo de pino (até 3 caracteres).

Retornos

response
GetMap_Response

Obter rota (versão prévia)

ID da operação:
GetRoute

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Waypoint 1
 wp.0 True string

Ponto de passagem inicial como latitude, longitude (por exemplo, 47.610,-122.107).
Waypoint 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.
Evitar rodovias
 avoid_highways boolean

Evita o uso de rodovias na rota.
Evitar pedágios
 avoid_tolls boolean

Evita o uso de estradas pedagiadas na rota.
Evitar balsas
 avoid_ferry boolean

Evita o uso de balsas na rota.
Evite cruzar fronteiras do país
 avoid_borderCrossing boolean

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

Especifica para que otimizar a rota.

Retornos

Corpo
GetRoute_Response

Definições

GetRoute_Response

Nome Caminho Tipo Description
Tipo
 type string

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

Matriz de recursos GeoJSON: Waypoint (início/término), ManeuverPoint (etapas turn-by-turn) e RoutePath (resumo da rota).
Tipo de Funcionalidade
 features.type string
Geometry
 features.geometry object
Tipo de recurso
 features.properties.type string

Tipo de recurso: Waypoint (pontos de início/término), ManeuverPoint (etapa turn-by-turn) ou RoutePath (resumo geral da rota).
Distância (medidores)
 features.properties.distanceInMeters float

Distância total da rota em medidores. Presentes nos recursos do RoutePath.
Duração (segundos)
 features.properties.durationInSeconds integer

Tempo estimado de viagem em segundos (sem tráfego). Presentes nos recursos do RoutePath.
Atraso no Tráfego (segundos)
 features.properties.trafficDelayInSeconds integer

Tempo extra em segundos devido ao tráfego. Presentes nos recursos do RoutePath.
Congestionamento
 features.properties.trafficCongestion string

Nível de congestionamento de tráfego (por exemplo, Baixo, Médio, Alto). Presentes nos recursos do RoutePath.
Dados de tráfego usados
 features.properties.trafficDataUsed string

Tipo de dados de tráfego usados (por exemplo, Nenhum, Flow). Presentes nos recursos do RoutePath.
Partida em
 features.properties.departureAt string

Hora de partida estimada (ISO 8601). Presentes nos recursos do RoutePath.
Chegada em
 features.properties.arrivalAt string

Hora de chegada estimada (ISO 8601). Presentes nos recursos do RoutePath.
Texto da instrução
 features.properties.instruction.text string

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

Código de tipo de manobra (por exemplo, TurnLeft, TurnRight, Straight, ArriveFinish).
Índice waypoint
 features.properties.order.inputIndex integer

Índice do ponto de passagem de entrada correspondente (0 = start, 1 = final).
Índice de pernas
 features.properties.order.legIndex integer

Índice da etapa de rota à qual este recurso pertence.

GetLocationByAddress_Response

Nome Caminho Tipo Description
Tipo
 type string

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

Matriz de recursos de localização geocodificada.
Tipo de Funcionalidade
 features.type string
Tipo de geometria
 features.geometry.type string
Coordenadas
 features.geometry.coordinates array of double

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

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

Nível de confiança da correspondência (Alto, Médio, Baixo).
Corresponder códigos
 features.properties.matchCodes array of string

Códigos de correspondência (Bom, Ambíguo, HierarquiaSuperior).
Linha do Endereço
 features.properties.address.addressLine string

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

Cidade ou localidade.
Distritos de administração
 features.properties.address.adminDistricts array of object

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

CeP ou CEP.
Região do País
 features.properties.address.countryRegion string

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

Concluir a cadeia de caracteres de endereço formatada.

GetMap_Response

Imagem do mapa
binary