Azure Maps (versión preliminar)

Azure Maps proporciona API geoespaciales para la asignación, el enrutamiento, la geocodificación y la geocodificación inversa.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Azure regiones de China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Estándar Todas las regiones Power Apps excepto las siguientes:
     - China Cloud operado por 21Vianet
Power Automate Estándar Todas las regiones Power Automate excepto las siguientes:
     - China Cloud operado por 21Vianet
Contact
Nombre Microsoft
URL https://www.microsoft.com/
Metadatos del conector
Publicador Microsoft
Sitio web https://azure.microsoft.com/products/azure-maps
Directiva de privacidad https://privacy.microsoft.com/privacystatement
Categorías Datos; Productividad

conector de Azure Maps

Tipo: Sin código | Nivel: Estándar | Estado: Vista previa

Proporciona funcionalidades de asignación, enrutamiento, geocodificación e geocodificación inversa a través de la API REST de Azure Maps. Las solicitudes se controlan completamente mediante la directiva de APIM: no hay ninguna aplicación web del conector.

Authentication

Autenticación de clave de API. Las conexiones requieren una clave de suscripción Azure Maps.

Parámetro Tipo Obligatorio Descripción
subscription_key securestring Sí Clave de suscripción de Azure Maps

La clave se extrae del token de conexión y se pasa a Azure Maps como parámetro subscription-key de consulta por la directiva ( / CheckForTokenGetAuthHeaderValue).

Disponibilidad en la nube

Nube Available
Público Sí
Fairfax (GCC) Sí
GCC High Sí
DoD Sí

Acciones

Obtener ruta: GetRoute

Calcule una ruta de conducción o caminar entre dos puntos de camino. Los puntos de referencia deben ser pares de coordenadas (latitude,longitude). Las direcciones no se admiten: primero se codifican geográficamente mediante Obtener ubicación por dirección.

Punto de conexión (después de la directiva):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

La directiva convierte los parámetros de consulta de estilo GET en un cuerpo POST de GeoJSONFeatureCollection, voltea las coordenadas al longitude,latitude orden y asigna valores para evitar o optimizar valores a Azure Maps equivalentes.

Parámetro Obligatorio Tipo Descripción
Punto de referencia 1 (wp.0) Sí string Punto de partida como latitude,longitude (por ejemplo, 47.610,-122.107)
Punto de referencia 2 (wp.1) Sí string Punto final como latitude,longitude (por ejemplo, 47.612,-122.204)
Modo de desplazamiento (travelMode) No string driving (valor predeterminado) o walking
Evitar autopistas No boolean Se asigna a avoid=limitedAccessHighways
Evitar peajes No boolean Se asigna a avoid=tollRoads
Evitar ferries No boolean Se asigna a avoid=ferries
Evitar cruzar las fronteras del país No boolean Se asigna a avoid=borderCrossings
Optimize No string fastestWithoutTraffic, fastestWithTraffic o shortest

Respuesta: Resumen de ruta con distancia de viaje (metros), duración (segundos), duración con tráfico (segundos) y detalles de las piernas de ruta.

Nota: No se admite el enrutamiento de tránsito. Azure Maps Route Directions solo admite driving y walking.

Obtención de la ubicación por dirección: GetLocationByAddress

Codifique geográficamente una dirección estructurada para coordenadas y detalles de ubicación.

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

Parámetro Obligatorio Tipo Descripción
Línea de direcciones (addressLine) No string Línea de calle (por ejemplo, 15595 NE 36th St)
Localidad (locality) No string Ciudad (por ejemplo, Redmond)
Distrito administrativo (adminDistrict) No string Abreviatura de estado (por ejemplo, WA)
Código postal (postalCode) No string Código postal o postal (por ejemplo, 98052)
Región del país (countryRegion) No string Código de país iso 2 letras (por ejemplo, US)
Resultados máximos (top) No integer 1–20, valor predeterminado 5

Respuesta: GeoJSON FeatureCollection. Cada característica tiene:

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

Nota: Azure Maps geocodificación no admite direcciones en China.

Obtener ubicación por punto: GetLocationByPoint

Coordenadas de latitud y longitud de código geográfico inverso a una dirección.

Punto de conexión (después de la directiva):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

La directiva combina los parámetros y longitude independientes latitude en el coordinates parámetro de consulta en longitude,latitude orden.

Parámetro Obligatorio Tipo Descripción
Latitud de punto (latitude) Sí double Por ejemplo, 47.64054
Longitud de punto (longitude) Sí double Por ejemplo, -122.12934

Respuesta: Mismo esquema que Obtener ubicación por dirección (GetLocationByAddress_Response).

Obtener mapa estático: GetMap

Obtiene una imagen de mapa estática centrada en un punto.

Punto de conexión (después de la directiva):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

La directiva combina latitud y longitud en el center parámetro (longitude,latitude), se asigna imagerySet al valor de Azure Maps style y pasa la chincheta opcional como parámetropins.

Parámetro Obligatorio Tipo Descripción
Latitud central (latitude) Sí double Por ejemplo, 47.64054
Longitud central (longitude) Sí double Por ejemplo, -122.12934
Estilo de mapa (imagerySet) Sí string Consulte la asignación de estilos siguiente.
Nivel de zoom (zoomLevel) Sí string 0–20, valor predeterminado 10
Ancho (píxeles) No integer Valor predeterminado 512
Alto (píxeles) No integer Valor predeterminado 512
Formato de imagen No string jpeg o png (valor predeterminado png). No se admite GIF.
Latitud de marcadores No double Latitud de ubicación de marcadores
Longitud de marcadores No double Longitud de la ubicación del marcadores
Etiqueta de marcadores No string Texto de etiqueta corta

Asignación de conjuntos de imágenes:

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

Respuesta: Imagen binaria (image/jpeg o image/png). En Power Automate fluye el cuerpo de la respuesta está codificado en base64. Para mostrar o guardar la imagen:

  • Use la base64ToBinary() expresión para convertir antes de guardar en OneDrive/SharePoint.
  • Use una tabla HTML o enviar una acción de correo electrónico con una <img src="data:image/png;base64,{body/$content}"> etiqueta para representar en línea.

Notas de la directiva

  • subscription-key se inserta mediante la directiva; nunca se pasa desde el autor de la llamada.
  • Los x-ms-apim-tokens encabezados y origin se quitan de entrada.
  • Content-Type: application/json se fuerza en todas las solicitudes que no son de imagen; Las respuestas de imagen restauran el tipo de contenido correcto image/* en la salida.
  • GetRoute convierte una solicitud de parámetro de consulta simple en un POST con un cuerpo GeoJSON: los autores de llamadas no necesitan construir el cuerpo en sí mismos.

Archivos

File propósito
apiDefinition.swagger.json Definición de OpenAPI
Implementación/policies.xml Directiva de APIM
Implementación/PolicySourceCode.cs Lógica de C# de directiva
connector-config-internal.json Configuración de autenticación y entorno
connector-config-cli.json Funcionalidades (actions)
connector-config-certification.json Nombre de API (azuremaps) y nivel (estándar)
connector-config-metadata.json Metadatos de propiedad

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones Compartible

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre Tipo Descripción Obligatorio
Clave de suscripción securestring Clave de suscripción de Azure Maps True

Acciones

Obtener mapa estático (versión preliminar)

Obtiene una imagen de mapa estática centrada en un punto. No se admite GIF; use JPEG o PNG.
Obtener ruta (versión preliminar)

Calcule una ruta de conducción o caminar mediante puntos de acceso. Los puntos de referencia deben proporcionarse como coordenadas de latitud y longitud.
Obtener ubicación por dirección (versión preliminar)

Geocodifique una dirección para obtener sus coordenadas y detalles de ubicación.
Obtener ubicación por punto (versión preliminar)

Obtenga la información de ubicación asociada a las coordenadas de latitud y longitud.

Obtener mapa estático (versión preliminar)

Id. de la operación:
GetMap

Obtiene una imagen de mapa estática centrada en un punto. No se admite GIF; use JPEG o PNG.

Parámetros

Nombre Clave Requerido Tipo Description
Latitud del centro
 latitude True double

Latitud del centro del mapa. Ejemplo: 47.64054
Longitud del centro
 longitude True double

Longitud del centro del mapa. Ejemplo: -122.12934
Estilo de mapa
 imagerySet True string

Estilo de mapa que se va a mostrar.
Nivel de zoom
 zoomLevel True string

Nivel de zoom entre 0 y 20. Valor predeterminado: 10
Ancho (píxeles)
 width integer

Ancho de la imagen de salida en píxeles. Valor predeterminado: 512
Alto (píxeles)
 height integer

Alto de la imagen de salida en píxeles. Valor predeterminado: 512
Formato de imagen
 format string

Formato de imagen. Valor predeterminado: png
Latitud de marcadores
 pushpinLatitude double

Latitud de marcadores.
Longitud de marcadores
 pushpinLongitude double

Longitud de marcadores.
Etiqueta de marcadores
 pushpinLabel string

Etiqueta de marcadores (hasta 3 caracteres).

Devoluciones

response
GetMap_Response

Obtener ruta (versión preliminar)

Id. de la operación:
GetRoute

Calcule una ruta de conducción o caminar mediante puntos de acceso. Los puntos de referencia deben proporcionarse como coordenadas de latitud y longitud.

Parámetros

Nombre Clave Requerido Tipo Description
Punto de referencia 1
 wp.0 True string

Punto de acceso inicial como latitud,longitud (por ejemplo, 47.610,-122.107).
Waypoint 2
 wp.1 True string

Punto de acceso final como latitud,longitud (por ejemplo, 47.612,-122.204).
Modo de desplazamiento
 travelMode string

Modo de viaje para la ruta.
Evitar autopistas
 avoid_highways boolean

Evita el uso de autopistas en la ruta.
Evitar peajes
 avoid_tolls boolean

Evita el uso de carreteras de peaje en la ruta.
Evitar ferries
 avoid_ferry boolean

Evita el uso de ferris en la ruta.
Evitar cruzar las fronteras del país
 avoid_borderCrossing boolean

Evita cruzar las fronteras del país en la ruta.
Optimize
 optimize string

Especifica para qué optimizar la ruta.

Devoluciones

Body
GetRoute_Response

Obtener ubicación por dirección (versión preliminar)

Id. de la operación:
GetLocationByAddress

Geocodifique una dirección para obtener sus coordenadas y detalles de ubicación.

Parámetros

Nombre Clave Requerido Tipo Description
Línea de direcciones
 addressLine string

Línea de calle de una dirección (sin incluir ciudad, estado, etc.).
Localidad (ciudad)
 locality string

La localidad, como una ciudad estadounidense.
Distrito administrativo (estado)
 adminDistrict string

Una subdivisión como una abreviatura de estado de EE. UU. (por ejemplo, WA).
Código postal
 postalCode string

El código postal o postal.
Región del país
 countryRegion string

Código de país iso 2 letra (por ejemplo, EE. UU.).
Número máximo de resultados
 top integer

Número máximo de resultados que se van a devolver (1-20). Valor predeterminado: 5.

Devoluciones

Body
GetLocationByAddress_Response

Obtener ubicación por punto (versión preliminar)

Id. de la operación:
GetLocationByPoint

Obtenga la información de ubicación asociada a las coordenadas de latitud y longitud.

Parámetros

Nombre Clave Requerido Tipo Description
Latitud de punto
 latitude True double

Coordenada de latitud para invertir el código geográfico. Ejemplo: 47.64054
Longitud de punto
 longitude True double

Coordenada de longitud para invertir el código geográfico. Ejemplo: -122.12934

Devoluciones

Body
GetLocationByAddress_Response

Definiciones

GetRoute_Response

Nombre Ruta de acceso Tipo Description
Tipo
 type string

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

Matriz de características de GeoJSON: Waypoint (start/end), ManeuverPoint (pasos turn-by-turn) y RoutePath (resumen de ruta).
Tipo de característica
 features.type string
Geometry
 features.geometry object
Tipo de característica
 features.properties.type string

Tipo de característica: Waypoint (puntos de inicio/fin), Punto de maniobra (paso de giro a turno) o RoutePath (resumen general de ruta).
Distancia (metros)
 features.properties.distanceInMeters float

Distancia total de ruta en metros. Presente en las características de RoutePath.
Duración (segundos)
 features.properties.durationInSeconds integer

Tiempo estimado de viaje en segundos (sin tráfico). Presente en las características de RoutePath.
Retraso del tráfico (segundos)
 features.properties.trafficDelayInSeconds integer

Tiempo adicional en segundos debido al tráfico. Presente en las características de RoutePath.
Congestión del tráfico
 features.properties.trafficCongestion string

Nivel de congestión del tráfico (por ejemplo, Bajo, Medio, Alto). Presente en las características de RoutePath.
Datos de tráfico usados
 features.properties.trafficDataUsed string

Tipo de datos de tráfico usados (por ejemplo, Ninguno, Flow). Presente en las características de RoutePath.
Salida a
 features.properties.departureAt string

Hora estimada de salida (ISO 8601). Presente en las características de RoutePath.
Llegada a
 features.properties.arrivalAt string

Hora estimada de llegada (ISO 8601). Presente en las características de RoutePath.
Texto de instrucción
 features.properties.instruction.text string

Texto de instrucciones legibles (por ejemplo, "Gire a la izquierda a NE 8th St").
Tipo de maniobra
 features.properties.instruction.maneuverType string

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

Índice del punto de acceso de entrada correspondiente (0 = inicio, 1 = fin).
Índice de piernas
 features.properties.order.legIndex integer

Índice del tramo de ruta al que pertenece esta característica.

GetLocationByAddress_Response

Nombre Ruta de acceso Tipo Description
Tipo
 type string

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

Matriz de características de ubicación geocodificada.
Tipo de característica
 features.type string
Tipo de geometría
 features.geometry.type string
Coordenadas
 features.geometry.coordinates array of double

Coordenadas como [longitud, latitud].
Tipo de característica
 features.properties.type string

Tipo de característica: Address o PopulatedPlace.
Confianza
 features.properties.confidence string

Nivel de confianza de la coincidencia (Alto, Medio, Bajo).
Códigos de coincidencia
 features.properties.matchCodes array of string

Códigos de coincidencia (Bueno, Ambiguo, UpHierarchy).
Línea de dirección
 features.properties.address.addressLine string

Línea de direcciones postales.
Localidad (ciudad)
 features.properties.address.locality string

Ciudad o localidad.
Distritos administrativos
 features.properties.address.adminDistricts array of object

Matriz de distritos administrativos (por ejemplo, estado, condado).
Nombre corto
 features.properties.address.adminDistricts.shortName string
Nombre
 features.properties.address.adminDistricts.name string
Código postal
 features.properties.address.postalCode string

Código postal o postal.
Región del país
 features.properties.address.countryRegion string

Nombre de país o región.
Dirección con formato
 features.properties.address.formattedAddress string

Cadena de dirección con formato completo.

GetMap_Response

Imagen de mapa
binary