Azure Maps (préversion)
Azure Maps fournit des API géospatiales pour le mappage, le routage, le géocodage et le géocodage inverse.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Régions |
|---|---|---|
| Copilot Studio | Standard | Toutes les régions Power Automate à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - régions de chine Azure - Us Department of Defense (DoD) |
| Power Apps | Standard | Toutes les régions Power Apps à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Power Automate | Standard | Toutes les régions Power Automate à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL | https://www.microsoft.com/ |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Website | https://azure.microsoft.com/products/azure-maps |
| Politique de confidentialité | https://privacy.microsoft.com/privacystatement |
| Catégories | Données; Productivité |
connecteur Azure Maps
Type: Sans code | Niveau: Standard | Statut: Aperçu
Fournit des fonctionnalités de mappage, de routage, de géocodage et de géocodage inverse via l’API REST Azure Maps. Les requêtes sont gérées entièrement par la stratégie APIM : il n’existe aucune application web de connecteur.
Authentication
Authentification par clé API. Les connexions nécessitent une clé d’abonnement Azure Maps.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
subscription_key |
securestring | Oui | clé d’abonnement Azure Maps |
La clé est extraite du jeton de connexion et transmise à Azure Maps en tant que subscription-key paramètre de requête par la stratégie ( / CheckForTokenGetAuthHeaderValue).
Disponibilité cloud
| Cloud | Available |
|---|---|
| Publique | Oui |
| Fairfax (GCC) | Oui |
| GCC High | Oui |
| DoD | Oui |
Actions
Obtenir l’itinéraire : GetRoute
Calculez une route de conduite ou de marche entre deux points de route. Les points de route doivent être des paires de coordonnées (latitude,longitude). Les adresses ne sont pas prises en charge : les géocodez-les d’abord à l’aide de l’emplacement d’obtention par adresse.
Point de terminaison (après la stratégie) :POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01
La stratégie convertit les paramètres de requête de style GET en corps GeoJSON FeatureCollection POST, retourne les coordonnées dans longitude,latitude l’ordre et mappe les valeurs d’évitement/d’optimisation en Azure Maps équivalents.
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Waypoint 1 (wp.0) |
Oui | string | Point de départ comme latitude,longitude (par exemple 47.610,-122.107) |
Waypoint 2 (wp.1) |
Oui | string | Point de fin comme latitude,longitude (par exemple 47.612,-122.204) |
Mode voyage (travelMode) |
Non | string |
driving (par défaut) ou walking |
| Éviter les autoroutes | Non | booléen | Mappe à avoid=limitedAccessHighways |
| Éviter les péages | Non | booléen | Mappe à avoid=tollRoads |
| Éviter les ferrys | Non | booléen | Mappe à avoid=ferries |
| Éviter de traverser les frontières du pays | Non | booléen | Mappe à avoid=borderCrossings |
| Optimize | Non | string |
fastestWithoutTraffic, fastestWithTraffic ou shortest |
Réponse : Résumé de l’itinéraire avec distance de trajet (mètres), durée (secondes), durée avec le trafic (secondes) et détails de la jambe d’itinéraire.
Note: Le routage du transit n’est pas pris en charge. Azure Maps Route Directions prend uniquement en charge
drivingetwalking.
Obtenir l’emplacement par adresse : GetLocationByAddress
Géocodez une adresse structurée pour les coordonnées et les détails de l’emplacement.
Point de terminaison :GET https://atlas.microsoft.com/geocode?api-version=2023-06-01
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Ligne d’adresse (addressLine) |
Non | string | Ligne de rue (par exemple 15595 NE 36th St) |
Localité (locality) |
Non | string | Ville (par exemple Redmond) |
District d’administration (adminDistrict) |
Non | string | Abréviation d’état (par exemple WA) |
Code postal (postalCode) |
Non | string | Code postal ou postal (par exemple 98052) |
Région pays (countryRegion) |
Non | string | Code pays iso 2 lettres (par exemple US) |
Nombre maximal de résultats (top) |
Non | entier | 1 à 20, valeur par défaut 5 |
Réponse: GeoJSON FeatureCollection. Chaque fonctionnalité a :
-
geometry.coordinates—[longitude, latitude] -
properties.confidence—High, ouMediumLow -
properties.address—addressLine, ,adminDistrictslocality, ,postalCode,countryRegion(objet avecnameetISO)formattedAddress
Remarque : Azure Maps géocodage ne prend pas en charge les adresses en Chine.
Obtenir l’emplacement par point — GetLocationByPoint
Inversez les coordonnées de latitude/longitude du géocode à une adresse.
Point de terminaison (après la stratégie) :GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}
La stratégie combine les paramètres distincts latitude et longitude les paramètres dans le paramètre de requête dans longitude,latitude l’ordrecoordinates.
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Latitude de point (latitude) |
Oui | double | Exemple : 47.64054 |
Longitude de point (longitude) |
Oui | double | Exemple : -122.12934 |
Réponse : Même schéma que Get location by address (GetLocationByAddress_Response).
Obtenir une carte statique — GetMap
Obtenir une image de carte statique centrée sur un point.
Point de terminaison (après la stratégie) :GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
La stratégie combine la latitude/longitude dans le center paramètre (longitude,latitude), est mappée imagerySet à la valeur Azure Maps style et transmet la punaise facultative en tant que pins paramètre.
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Latitude centrale (latitude) |
Oui | double | Exemple : 47.64054 |
Longitude centrale (longitude) |
Oui | double | Exemple : -122.12934 |
Style de carte (imagerySet) |
Oui | string | Voir le mappage de style ci-dessous |
Niveau de zoom (zoomLevel) |
Oui | string | 0 à 20, valeur par défaut 10 |
| Largeur (pixels) | Non | entier | Valeur par défaut 512 |
| Hauteur (pixels) | Non | entier | Valeur par défaut 512 |
| Format d’image | Non | string |
jpeg ou png (valeur par défaut png). Gif n’est pas pris en charge. |
| Latitude pushpin | Non | double | Latitude de l’emplacement de l’épingle |
| Longitude de l’épingle | Non | double | Longitude de l’emplacement de l’épingle |
| Étiquette pushpin | Non | string | Texte d’étiquette courte |
Mappage de jeu d’images :
Entrée imagerySet |
Azure Maps style |
|---|---|
Road |
main |
Aerial |
satellite |
AerialWithLabels |
satellite_road_labels |
CanvasDark |
dark |
CanvasLight |
road_shaded_relief |
CanvasGray |
grayscale_light |
Réponse : Image binaire (image/jpeg ou image/png). Dans Power Automate flux, le corps de la réponse est encodé en base64. Pour afficher ou enregistrer l’image :
- Utilisez l’expression pour effectuer la
base64ToBinary()conversion avant d’enregistrer en OneDrive/SharePoint. - Utilisez une table HTML ou envoyez une action d’e-mail avec une
<img src="data:image/png;base64,{body/$content}">balise pour afficher inline.
Notes de stratégie
-
subscription-keyest injecté par la stratégie ; il n’est jamais passé par l’appelant. - Les
x-ms-apim-tokensen-têtes etoriginles en-têtes sont supprimés sur le trafic entrant. -
Content-Type: application/jsonest forcé sur toutes les demandes non-image ; Les réponses d’image restaurent le type de contenu correctimage/*sur le trafic sortant. -
GetRouteconvertit une requête simple de paramètre de requête en une requête POST avec un corps GeoJSON : les appelants n’ont pas besoin de construire le corps eux-mêmes.
Fichiers
| File | Purpose |
|---|---|
| apiDefinition.swagger.json | Définition OpenAPI |
| Déploiement/policies.xml | Stratégie APIM |
| Déploiement/PolicySourceCode.cs | Logique C# de stratégie |
| connector-config-internal.json | Configuration de l’authentification et de l’environnement |
| connector-config-cli.json | Fonctionnalités (actions) |
| connector-config-certification.json | Nom de l’API (azuremaps) et niveau (Standard) |
| connector-config-metadata.json | Métadonnées de propriété |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs
| Nom | Type | Description | Obligatoire |
|---|---|---|---|
| Clé d’abonnement | securestring | clé d’abonnement Azure Maps | True |
Actions
| Obtenir l’emplacement par adresse (préversion) |
Géocodez une adresse pour obtenir ses coordonnées et ses détails d’emplacement. |
| Obtenir l’emplacement par point (préversion) |
Obtenez les informations d’emplacement associées aux coordonnées de latitude et de longitude. |
| Obtenir l’itinéraire (préversion) |
Calculez une route de conduite ou de marche à l’aide de points de route. Les points de route doivent être fournis sous forme de coordonnées latitude,longitude. |
| Obtenir une carte statique (préversion) |
Obtenir une image de carte statique centrée sur un point. GIF n’est pas pris en charge ; utilisez JPEG ou PNG. |
Obtenir l’emplacement par adresse (préversion)
Géocodez une adresse pour obtenir ses coordonnées et ses détails d’emplacement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ligne d’adresse
|
addressLine | string |
Ligne de rue d’une adresse (sans inclure la ville, l’état, etc.). |
|
|
Localité (Ville)
|
locality | string |
La localité, telle qu’une ville américaine. |
|
|
District d’administration (État)
|
adminDistrict | string |
Une sous-division telle qu’une abréviation de l’état américain (par exemple, WA). |
|
|
Code postal
|
postalCode | string |
Code postal ou postal. |
|
|
Région du pays
|
countryRegion | string |
Code pays à 2 lettres ISO (par exemple, ÉTATS-Unis). |
|
|
Résultats max.
|
top | integer |
Nombre maximal de résultats à retourner (1 à 20). Valeur par défaut : 5. |
Retours
Obtenir l’emplacement par point (préversion)
Obtenez les informations d’emplacement associées aux coordonnées de latitude et de longitude.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Latitude de point
|
latitude | True | double |
Coordonnée de latitude pour inverser le géocode. Exemple : 47.64054 |
|
Longitude de point
|
longitude | True | double |
Coordonnée de longitude pour inverser le géocode. Exemple : -122.12934 |
Retours
Obtenir l’itinéraire (préversion)
Calculez une route de conduite ou de marche à l’aide de points de route. Les points de route doivent être fournis sous forme de coordonnées latitude,longitude.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Waypoint 1
|
wp.0 | True | string |
Point de départ comme latitude,longitude (par exemple, 47,610,-122.107). |
|
Waypoint 2
|
wp.1 | True | string |
Fin waypoint en tant que latitude,longitude (par exemple, 47.612,-122.204). |
|
Mode voyage
|
travelMode | string |
Mode de voyage pour l’itinéraire. |
|
|
Éviter les autoroutes
|
avoid_highways | boolean |
Évite l’utilisation d’autoroutes dans l’itinéraire. |
|
|
Éviter les péages
|
avoid_tolls | boolean |
Évite l’utilisation des routes de péage dans l’itinéraire. |
|
|
Éviter les ferrys
|
avoid_ferry | boolean |
Évite l’utilisation de ferrys en route. |
|
|
Éviter de traverser les frontières du pays
|
avoid_borderCrossing | boolean |
Évite de traverser les frontières du pays en route. |
|
|
Optimize
|
optimize | string |
Spécifie ce qui permet d’optimiser l’itinéraire. |
Retours
- Corps
- GetRoute_Response
Obtenir une carte statique (préversion)
Obtenir une image de carte statique centrée sur un point. GIF n’est pas pris en charge ; utilisez JPEG ou PNG.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Latitude du centre
|
latitude | True | double |
Latitude du centre de carte. Exemple : 47.64054 |
|
Longitude du centre
|
longitude | True | double |
Longitude du centre de carte. Exemple : -122.12934 |
|
Style de carte
|
imagerySet | True | string |
Style de carte à afficher. |
|
Niveau de zoom
|
zoomLevel | True | string |
Niveau de zoom compris entre 0 et 20. Valeur par défaut : 10 |
|
Largeur (pixels)
|
width | integer |
Largeur de l’image de sortie en pixels. Valeur par défaut : 512 |
|
|
Hauteur (pixels)
|
height | integer |
Hauteur de l’image de sortie en pixels. Valeur par défaut : 512 |
|
|
Format d’image
|
format | string |
Format de l’image. Valeur par défaut : png |
|
|
Latitude pushpin
|
pushpinLatitude | double |
Latitude pushpin. |
|
|
Longitude de l’épingle
|
pushpinLongitude | double |
Longitude de la punaise. |
|
|
Étiquette pushpin
|
pushpinLabel | string |
Étiquette de punaise (jusqu’à 3 caractères). |
Retours
- response
- GetMap_Response
Définitions
GetRoute_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Type
|
type | string |
Type GeoJSON (toujours FeatureCollection). |
|
Features
|
features | array of object |
Tableau de fonctionnalités GeoJSON : Waypoint (début/fin), ManoeuvrePoint (étapes de tour par tour) et RoutePath (résumé de l’itinéraire). |
|
Type de fonctionnalité
|
features.type | string | |
|
Geometry
|
features.geometry | object | |
|
Type de fonctionnalité
|
features.properties.type | string |
Type de fonctionnalité : Waypoint (points de début/fin), ManoeuvrePoint (étape de tour par tour) ou RoutePath (résumé global de l’itinéraire). |
|
Distance (mètres)
|
features.properties.distanceInMeters | float |
Distance totale des itinéraires en mètres. Présente sur les fonctionnalités de RoutePath. |
|
Durée (secondes)
|
features.properties.durationInSeconds | integer |
Durée de trajet estimée en secondes (sans trafic). Présente sur les fonctionnalités de RoutePath. |
|
Délai de trafic (secondes)
|
features.properties.trafficDelayInSeconds | integer |
Temps supplémentaire en secondes en raison du trafic. Présente sur les fonctionnalités de RoutePath. |
|
Encombrement
|
features.properties.trafficCongestion | string |
Niveau de congestion du trafic (p. ex. Faible, Moyen, Élevé). Présente sur les fonctionnalités de RoutePath. |
|
Données de trafic utilisées
|
features.properties.trafficDataUsed | string |
Type de données de trafic utilisées (par exemple Aucun, Flux). Présente sur les fonctionnalités de RoutePath. |
|
Départ à
|
features.properties.departureAt | string |
Heure de départ estimée (ISO 8601). Présente sur les fonctionnalités de RoutePath. |
|
Arrivée à
|
features.properties.arrivalAt | string |
Heure d’arrivée estimée (ISO 8601). Présente sur les fonctionnalités de RoutePath. |
|
Texte de l’instruction
|
features.properties.instruction.text | string |
Texte d’instruction lisible par l’homme (par exemple, « Tourner à gauche sur NE 8th St »). |
|
Type de manœuvre
|
features.properties.instruction.maneuverType | string |
Code de type de manœuvre (par exemple TurnLeft, TurnRight, Straight, ArriveFinish). |
|
Waypoint Index
|
features.properties.order.inputIndex | integer |
Index du point de route d’entrée correspondant (0 = début, 1 = fin). |
|
Index de jambe
|
features.properties.order.legIndex | integer |
Index de la jambe de routage auquel appartient cette fonctionnalité. |
GetLocationByAddress_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Type
|
type | string |
Type GeoJSON (toujours FeatureCollection). |
|
Features
|
features | array of object |
Tableau de fonctionnalités d’emplacement géocodées. |
|
Type de fonctionnalité
|
features.type | string | |
|
Geometry Type
|
features.geometry.type | string | |
|
Coordonnées
|
features.geometry.coordinates | array of double |
Coordonnées en tant que [longitude, latitude]. |
|
Type de fonctionnalité
|
features.properties.type | string |
Type de fonctionnalité : Adresse ou RemplissagePlace. |
|
Confiance
|
features.properties.confidence | string |
Niveau de confiance de la correspondance (Haut, Moyen, Bas). |
|
Codes de correspondance
|
features.properties.matchCodes | array of string |
Codes de correspondance (Bon, Ambigu, Dans la hiérarchie). |
|
Ligne d’adresse
|
features.properties.address.addressLine | string |
Ligne d’adresse de rue. |
|
Localité (Ville)
|
features.properties.address.locality | string |
Ville ou localité. |
|
Districts d’administration
|
features.properties.address.adminDistricts | array of object |
Tableau de districts administratifs (par exemple, état, comté). |
|
Nom court
|
features.properties.address.adminDistricts.shortName | string | |
|
Nom
|
features.properties.address.adminDistricts.name | string | |
|
Code postal
|
features.properties.address.postalCode | string |
Code postal ou postal. |
|
Région du pays
|
features.properties.address.countryRegion | string |
Nom du pays ou de la région. |
|
Adresse mise en forme
|
features.properties.address.formattedAddress | string |
Chaîne d’adresse au format complet. |
GetMap_Response
- Image de carte
- binary