Azure Maps (Vorschau)

Azure Maps stellt Geospatial-APIs für Zuordnung, Routing, Geocodierung und umgekehrte Geocodierung bereit.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Standard Alle Power Automate Regionen mit Ausnahme der folgenden:
     - China Cloud betrieben von 21Vianet
Logik-Apps Standard Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Standard Alle Power Apps Regionen mit Ausnahme der folgenden:
     - China Cloud betrieben von 21Vianet
Power Automate Standard Alle Power Automate Regionen mit Ausnahme der folgenden:
     - China Cloud betrieben von 21Vianet
Kontakt
Name Microsoft
URL https://www.microsoft.com/
Connectormetadaten
Herausgeber Microsoft
Website https://azure.microsoft.com/products/azure-maps
Datenschutzrichtlinie https://privacy.microsoft.com/privacystatement
Kategorien Daten; Produktivität

Azure Maps Connector

Typ: Ohne Code | Rang: Standard | Status: Vorschau

Stellt Zuordnungs-, Routing-, Geocodierungs- und Reverse-Geocodierungsfunktionen über die Azure Maps REST-API bereit. Anforderungen werden vollständig durch APIM-Richtlinie behandelt – es gibt keine Connector-Webapp.

Authentifizierung

API-Schlüsselauthentifizierung. Für Verbindungen ist ein Azure Maps Abonnementschlüssel erforderlich.

Parameter Typ Erforderlich Description
subscription_key securestring Ja Azure Maps-Abonnementschlüssel

Der Schlüssel wird aus dem Verbindungstoken extrahiert und an Azure Maps als Abfrageparameter durch die subscription-key Richtlinie (CheckForToken / GetAuthHeaderValue) übergeben.

Cloudverfügbarkeit

Wolke Available
Öffentlichkeit Ja
Fairfax (GCC) Ja
GCC High Ja
Verteidigungsministerium Ja

Aktionen

Route abrufen – GetRoute

Berechnen Sie eine Fahr- oder Wanderroute zwischen zwei Wegpunkten. Wegpunkte müssen Koordinatenpaare (latitude,longitude) sein. Adressen werden nicht unterstützt – geocodieren Sie sie zuerst mithilfe von "Standort nach Adresse abrufen".

Endpunkt (nach Richtlinie):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Die Richtlinie konvertiert die ABFRAGEparameter im GET-Stil in einen GeoJSON FeatureCollection POST-Textkörper, kippt Koordinaten in longitude,latitude die Reihenfolge und ordnet Werte zu Azure Maps Entsprechungen zu vermeiden/zu optimieren.

Parameter Erforderlich Typ Description
Wegpunkt 1 (wp.0) Ja string Ausgangspunkt als latitude,longitude (z. B. 47.610,-122.107)
Wegpunkt 2 (wp.1) Ja string Endpunkt als latitude,longitude (z. B. 47.612,-122.204)
Reisemodus (travelMode) No string driving (Standard) oder walking
Vermeiden von Autobahnen No boolean Karten zu avoid=limitedAccessHighways
Vermeiden von Gebühren No boolean Karten zu avoid=tollRoads
Vermeiden von Fähren No boolean Karten zu avoid=ferries
Grenzüberquerung von Landesgrenzen vermeiden No boolean Karten zu avoid=borderCrossings
Optimieren No string fastestWithoutTraffic, fastestWithTraffic oder shortest

Antwort: Route summary with travel distance (meter), duration (seconds), duration with traffic (seconds) and route leg details.

Hinweis: Transitrouting wird nicht unterstützt. Azure Maps Routenbeschreibungen werden nur unterstützt driving und unterstützt und walking.

Standort nach Adresse abrufen — GetLocationByAddress

Geocodieren Sie eine strukturierte Adresse für Koordinaten und Standortdetails.

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

Parameter Erforderlich Typ Description
Adresszeile (addressLine) No string Straßenlinie (z.B. 15595 NE 36th St)
Lokalität (locality) No string Ort (z.B. Redmond)
Verwaltungsbezirk (adminDistrict) No string Abkürzung des Staates (z. B. WA)
Postleitzahl (postalCode) No string PLZ (z. B. 98052)
Landregion (countryRegion) No string ISO 2-Buchstaben Ländercode (z. B. US)
Max. Ergebnisse (top) No integer 1–20, Standard 5

Antwort: GeoJSON FeatureCollection. Jedes Feature verfügt über:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, , Mediumoder Low
  • properties.address— addressLine, , locality, postalCodeadminDistricts, countryRegion (Objekt mit name und ISO),formattedAddress

Hinweis: Azure Maps Geocodierung unterstützt keine Adressen in China.

Ort nach Punkt abrufen — GetLocationByPoint

Umgekehrte Geocode-Breiten-/Längengradkoordinaten zu einer Adresse.

Endpunkt (nach Richtlinie):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

Die Richtlinie kombiniert die Separaten latitude und longitude Parameter in der Reihenfolge des coordinates Abfrageparameters longitude,latitude .

Parameter Erforderlich Typ Description
Punktbreite (latitude) Ja double Beispiel: 47.64054
Länge des Punkts (longitude) Ja double Beispiel: -122.12934

Antwort: Das gleiche Schema wie "Ort nach Adresse abrufen " (GetLocationByAddress_Response).

Statische Karte abrufen – GetMap

Abrufen eines statischen Kartenbilds, das auf einem Punkt zentriert ist.

Endpunkt (nach Richtlinie):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Die Richtlinie kombiniert breiten-/längengrad in den center Parameter (longitude,latitude), ordnet imagerySet den Azure Maps style Wert zu und übergibt die optionale Heftmarke als pins Parameter.

Parameter Erforderlich Typ Description
Breitengrad mitte (latitude) Ja double Beispiel: 47.64054
Längengrad (longitudeMitte) Ja double Beispiel: -122.12934
Kartenformat (imagerySet) Ja string Siehe Formatvorlagenzuordnung unten
Zoomfaktor (zoomLevel) Ja string 0–20, Standard 10
Breite (in Pixel) No integer Standard 512
Höhe (in Pixel) No integer Standard 512
Bildformat No string jpeg oder png (Standard png). GIF wird nicht unterstützt.
Breitengrad der Stecknadel No double Breitengrad der Ortsposition
Länge der Stecknadel No double Länge der Ortsposition
Stecknadeletikett No string Kurzer Beschriftungstext

Imagery set mapping:

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

Antwort: Binäres Bild (image/jpeg oder image/png). In Power Automate Flüssen ist der Antworttext base64-codiert. So zeigen Sie das Bild an, oder speichern Sie es:

  • Verwenden Sie den base64ToBinary() Ausdruck, um vor dem Speichern in OneDrive/SharePoint zu konvertieren.
  • Verwenden Sie eine HTML-Tabelle oder eine E-Mail-Aktion mit einem <img src="data:image/png;base64,{body/$content}"> Tag zum Rendern inline.

Richtlinienhinweise

  • subscription-key wird von der Richtlinie eingefügt; sie wird nie vom Anrufer durchgestrichen.
  • Die x-ms-apim-tokens Kopfzeilen und origin Die Kopfzeilen werden bei eingehenden Daten gestreift.
  • Content-Type: application/json wird für alle Nicht-Image-Anforderungen erzwungen; Bildantworten stellen den richtigen image/* Inhaltstyp für ausgehende Daten wieder her.
  • GetRoute konvertiert eine einfache Abfrageparameteranforderung in einen POST mit einem GeoJSON-Textkörper – Aufrufer müssen den Text nicht selbst erstellen.

Dateien

Datei Purpose
apiDefinition.swagger.json OpenAPI-Definition
Bereitstellung/policies.xml APIM-Richtlinie
Bereitstellung/PolicySourceCode.cs Richtlinien-C#-Logik
connector-config-internal.json Authentifizierungs- und Umgebungskonfiguration
connector-config-cli.json Funktionen (actions)
connector-config-certification.json API-Name (azuremaps) und Ebene (Standard)
connector-config-metadata.json Besitzmetadaten

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Freigabefähig

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name Typ Description Erforderlich
Abonnementschlüssel securestring Azure Maps-Abonnementschlüssel True

Aktionen

Ort nach Punkt abrufen (Vorschau)

Rufen Sie die Standortinformationen ab, die breiten- und längengradkoordinaten zugeordnet sind.
Route abrufen (Vorschau)

Berechnen Sie eine Fahrt- oder Wanderroute mithilfe von Wegpunkten. Wegpunkte müssen als Breiten-,Längengradkoordinaten bereitgestellt werden.
Standort nach Adresse abrufen (Vorschau)

Geocodieren Sie eine Adresse, um die Koordinaten und Standortdetails abzurufen.
Statische Karte abrufen (Vorschau)

Abrufen eines statischen Kartenbilds, das auf einem Punkt zentriert ist. GIF wird nicht unterstützt; verwenden Sie JPEG oder PNG.

Ort nach Punkt abrufen (Vorschau)

Vorgangs-ID:
GetLocationByPoint

Rufen Sie die Standortinformationen ab, die breiten- und längengradkoordinaten zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Breitengrad des Punkts
 latitude True double

Die Breitenkoordinate zum Umkehren der Geocodierung. Beispiel: 47.64054
Länge des Punkts
 longitude True double

Die Längengradkoordinate zum Umkehren der Geocodierung. Beispiel: -122.12934

Gibt zurück

Body
GetLocationByAddress_Response

Route abrufen (Vorschau)

Vorgangs-ID:
GetRoute

Berechnen Sie eine Fahrt- oder Wanderroute mithilfe von Wegpunkten. Wegpunkte müssen als Breiten-,Längengradkoordinaten bereitgestellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Wegpunkt 1
 wp.0 True string

Ausgangspunkt als Breitengrad,Längengrad (z. B. 47.610,-122.107).
Wegpunkt 2
 wp.1 True string

Endwegpunkt als Breitengrad,Längengrad (z. B. 47.612,-122.204).
Reisemodus
 travelMode string

Der Reisemodus für die Route.
Vermeiden von Autobahnen
 avoid_highways boolean

Vermeidet die Verwendung von Autobahnen in der Route.
Vermeiden von Gebühren
 avoid_tolls boolean

Vermeidet die Nutzung der mautpflichtigen Straßen auf der Route.
Vermeiden von Fähren
 avoid_ferry boolean

Vermeidet die Verwendung von Fähren auf der Route.
Grenzüberquerung von Landesgrenzen vermeiden
 avoid_borderCrossing boolean

Verhindert die Grenzüberquerung der Länder in der Route.
Optimieren
 optimize string

Gibt an, wofür die Route optimiert werden soll.

Gibt zurück

Body
GetRoute_Response

Standort nach Adresse abrufen (Vorschau)

Vorgangs-ID:
GetLocationByAddress

Geocodieren Sie eine Adresse, um die Koordinaten und Standortdetails abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Adressleitung
 addressLine string

Die Straße einer Adresse (nicht einschließlich Stadt, Bundesland usw.).
Ort (Stadt)
 locality string

Die Lokalität, z. B. eine US-Stadt.
Verwaltungsbezirk (Bundesland)
 adminDistrict string

Eine Unterteilung, z. B. eine US-Bundesstaatskürzel (z. B. WA).
Postleitzahl
 postalCode string

Postleitzahl oder PLZ.
Land/Region
 countryRegion string

Der ISO 2-Buchstaben-Ländercode (z. B. US).
Max. Ergebnisse
 top integer

Maximale Anzahl der zurückzugebenden Ergebnisse (1-20). Standard: 5.

Gibt zurück

Body
GetLocationByAddress_Response

Statische Karte abrufen (Vorschau)

Vorgangs-ID:
GetMap

Abrufen eines statischen Kartenbilds, das auf einem Punkt zentriert ist. GIF wird nicht unterstützt; verwenden Sie JPEG oder PNG.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Breitengrad Mitte
 latitude True double

Der Breitengrad des Kartenmittelpunkts. Beispiel: 47.64054
Längengrad Mitte
 longitude True double

Der Längengrad des Kartenmittelpunkts. Beispiel: -122.12934
Kartenformat
 imagerySet True string

Das anzuzeigende Kartenformat.
Zoomstufe
 zoomLevel True string

Der Zoomfaktor zwischen 0 und 20. Standardwert: 10
Breite (in Pixel)
 width integer

Die Breite des Ausgabebilds in Pixeln. Standard: 512
Höhe (in Pixel)
 height integer

Die Höhe des Ausgabebilds in Pixeln. Standard: 512
Bildformat
 format string

Das Bildformat. Standard: png
Breitengrad der Stecknadel
 pushpinLatitude double

Breitengrad der Stecknadel.
Länge der Stecknadel
 pushpinLongitude double

Längengrad der Stecknadel.
Stecknadeletikett
 pushpinLabel string

Pushpin-Bezeichnung (bis zu 3 Zeichen).

Gibt zurück

response
GetMap_Response

Definitionen

GetRoute_Response

Name Pfad Typ Beschreibung
Typ
 type string

GeoJSON-Typ (immer FeatureCollection).
Features
 features array of object

Array von GeoJSON-Features: Waypoint (Start/Ende), ManöverPoint (Turn-by-Turn-Schritte) und RoutePath (Routenzusammenfassung).
Featuretyp
 features.type string
Geometry
 features.geometry object
Featureart
 features.properties.type string

Featureart: Wegpunkt (Start-/Endpunkte), ManöverPoint (Turn-by-Turn-Schritt) oder RoutePath (Gesamtroutenzusammenfassung).
Entfernung (Meter)
 features.properties.distanceInMeters float

Gesamtwegstrecke in Metern. In RoutePath-Features vorhanden.
Dauer (Sekunden)
 features.properties.durationInSeconds integer

Geschätzte Fahrzeit in Sekunden (ohne Datenverkehr). In RoutePath-Features vorhanden.
Datenverkehrsverzögerung (Sekunden)
 features.properties.trafficDelayInSeconds integer

Zusätzliche Zeit in Sekunden aufgrund des Datenverkehrs. In RoutePath-Features vorhanden.
Verkehrsstau
 features.properties.trafficCongestion string

Verkehrsüberlastungsgrad (z. B. Niedrig, Mittel, Hoch). In RoutePath-Features vorhanden.
Verwendete Datenverkehrsdaten
 features.properties.trafficDataUsed string

Typ der verwendeten Datenverkehrsdaten (z. B. None, Flow). In RoutePath-Features vorhanden.
Abfahrt bei
 features.properties.departureAt string

Geschätzte Abfahrtszeit (ISO 8601). In RoutePath-Features vorhanden.
Ankunft bei
 features.properties.arrivalAt string

Geschätzte Ankunftszeit (ISO 8601). In RoutePath-Features vorhanden.
Anweisungstext
 features.properties.instruction.text string

Lesbarer Anweisungstext (z. B. "Links auf NE 8. St").
Manövertyp
 features.properties.instruction.maneuverType string

Manövertypcode (z. B. TurnLeft, TurnRight, Straight, ArriveFinish).
Waypoint-Index
 features.properties.order.inputIndex integer

Index des entsprechenden Eingabewegpunkts (0 = Start, 1 = Ende).
Beinindex
 features.properties.order.legIndex integer

Index des Streckenabschnitts, zu dem dieses Feature gehört.

GetLocationByAddress_Response

Name Pfad Typ Beschreibung
Typ
 type string

GeoJSON-Typ (immer FeatureCollection).
Features
 features array of object

Array von geocodierten Standortfunktionen.
Featuretyp
 features.type string
Geometrietyp
 features.geometry.type string
Koordinaten
 features.geometry.coordinates array of double

Koordinaten als [Längengrad, Breitengrad].
Featureart
 features.properties.type string

Featureart: Adresse oder Ausgefüllter Ort.
Zuverlässigkeit
 features.properties.confidence string

Konfidenzniveau der Übereinstimmung (Hoch, Mittel, Niedrig).
Übereinstimmungscodes
 features.properties.matchCodes array of string

Übereinstimmungscodes (Gut, mehrdeutig, UpHierarchy).
Adresszeile
 features.properties.address.addressLine string

Straßenanschrift.
Ort (Stadt)
 features.properties.address.locality string

Stadt oder Ort.
Verwaltungsbezirke
 features.properties.address.adminDistricts array of object

Array von Verwaltungsbezirken (z. B. Bundesland, Kreis).
Kurzname
 features.properties.address.adminDistricts.shortName string
Name
 features.properties.address.adminDistricts.name string
PLZ
 features.properties.address.postalCode string

Postleitzahl oder PLZ.
Landregion
 features.properties.address.countryRegion string

Name des Landes oder der Region.
Formatierte Adresse
 features.properties.address.formattedAddress string

Vollständige formatierte Adresszeichenfolge.

GetMap_Response

Kartenbild
binary