Azure Maps (preview)

Azure Maps biedt georuimtelijke API's voor toewijzing, routering, geocodering en omgekeerde geocodering.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regio's
Copilot Studio Standaard Alle Power Automate regio's behalve:
     - China Cloud beheerd door 21Vianet
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Standaard Alle Power Apps regio's behalve:
     - China Cloud beheerd door 21Vianet
Power Automate Standaard Alle Power Automate regio's behalve:
     - China Cloud beheerd door 21Vianet
Contact
Naam Microsoft
URL https://www.microsoft.com/
Connectormetagegevens
Publisher Microsoft
Website https://azure.microsoft.com/products/azure-maps
Privacybeleid https://privacy.microsoft.com/privacystatement
Categorieën Gegevens; Productiviteit

Azure Maps-connector

Type: Codeloos | Tier: Standaard | Status: Voorbeeld

Biedt mogelijkheden voor toewijzing, routering, geocodering en omgekeerde geocodering via de Azure Maps REST API. Aanvragen worden volledig verwerkt door APIM-beleid. Er is geen connectorweb-app.

Authentication

VERIFICATIE van API-sleutel. Voor verbindingen is een Azure Maps-abonnementssleutel vereist.

Parameter Type Required Beschrijving
subscription_key beveiligde string Yes Azure Maps-abonnementssleutel

De sleutel wordt uit het verbindingstoken geëxtraheerd en doorgegeven aan Azure Maps als de subscription-key queryparameter door het beleid ( / CheckForTokenGetAuthHeaderValue).

Beschikbaarheid in de cloud

Wolk Available
Public Yes
Fairfax (GCC) Yes
GCC High Yes
Ministerie van Defensie (DoD) Yes

Acties

Route ophalen — GetRoute

Bereken een rij- of wandelroute tussen twee waypoints. Waypoints moeten coördinaatparen (latitude,longitude) zijn. Adressen worden niet ondersteund: geocodeer ze eerst met behulp van Locatie ophalen op adres.

Eindpunt (na beleid):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Met het beleid worden de GET-stijlqueryparameters geconverteerd naar een GeoJSON FeatureCollection POST-hoofdtekst, worden coördinaten in longitude,latitude volgorde gespiegeld en worden waarden vermeden/geoptimaliseerd voor Azure Maps equivalenten.

Parameter Required Type Beschrijving
Waypoint 1 (wp.0) Yes string Beginpunt als latitude,longitude (bijvoorbeeld 47.610,-122.107)
Waypoint 2 (wp.1) Yes string Eindpunt als latitude,longitude (bijvoorbeeld 47.612,-122.204)
Reismodus (travelMode) No string driving (standaard) of walking
Vermijd snelwegen No boolean Wordt toegewezen aan avoid=limitedAccessHighways
Vermijd tolgelden No boolean Wordt toegewezen aan avoid=tollRoads
Vermijd veerboten No boolean Wordt toegewezen aan avoid=ferries
Vermijd het overschrijden van landsgrenzen No boolean Wordt toegewezen aan avoid=borderCrossings
Optimize No string fastestWithoutTraffic, fastestWithTraffic of shortest

Antwoord: Routeoverzicht met reisafstand (meters), duur (seconden), duur met verkeer (seconden) en routebeengegevens.

Opmerking: Transitroutering wordt niet ondersteund. Azure Maps Routebeschrijving ondersteunt driving en walking.

Locatie ophalen op adres — GetLocationByAddress

Geocodeer een gestructureerd adres voor coördinaten en locatiegegevens.

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

Parameter Required Type Beschrijving
Adresregel (addressLine) No string Straatlijn (bijvoorbeeld 15595 NE 36th St)
Lokaliteit (locality) No string Plaats (bijvoorbeeld Redmond)
Beheerdistrict (adminDistrict) No string Afkorting van staat (bijvoorbeeld WA)
Postcode (postalCode) No string Postcode (bijvoorbeeld 98052)
Landregio (countryRegion) No string ISO 2-letter landcode (bijvoorbeeld US)
Maximum aantal resultaten (top) No integer 1-20, standaard 5

Antwoord: GeoJSON FeatureCollection. Elke functie heeft:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence— High, of MediumLow
  • properties.address — addressLine, locality, adminDistricts, , postalCode, countryRegion (object met name en ISO), formattedAddress

Opmerking: Azure Maps geocodering biedt geen ondersteuning voor adressen in China.

Locatie per punt ophalen — GetLocationByPoint

Geocodeer coördinaten voor breedtegraad/lengtegraad om naar een adres.

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

Het beleid combineert de afzonderlijke latitude parameters longitude in de coordinates queryparameter in longitude,latitude volgorde.

Parameter Required Type Beschrijving
Breedtegraad punt (latitude) Yes double bijvoorbeeld 47.64054
Lengtegraad punt (longitude) Yes double bijvoorbeeld -122.12934

Reactie: Hetzelfde schema als Locatie ophalen op adres (GetLocationByAddress_Response).

Statische kaart ophalen - GetMap

Haal een statische kaartafbeelding op die is gecentreerd op een punt.

Eindpunt (na beleid):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Het beleid combineert breedtegraad/lengtegraad in de center parameter (longitude,latitude), wijst toe imagerySet aan de Azure Maps style waarde en geeft de optionele punaise als parameter pins door.

Parameter Required Type Beschrijving
Middelste breedtegraad (latitude) Yes double bijvoorbeeld 47.64054
Lengtegraad centreren (longitude) Yes double bijvoorbeeld -122.12934
Kaartstijl (imagerySet) Yes string Zie de stijltoewijzing hieronder
Zoomniveau (zoomLevel) Yes string 0-20, standaard 10
Breedte (pixels) No integer Standaard 512
Hoogte (pixels) No integer Standaard 512
Afbeeldingsindeling No string jpeg of png (standaard png). GIF wordt niet ondersteund.
Breedtegraad van punaise No double Breedtegraad van punaiselocatie
Lengtegraad van punaise No double Lengtegraad van punaiselocatie
Punaiselabel No string Korte labeltekst

Toewijzing van afbeeldingenset:

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

Antwoord: Binaire afbeelding (image/jpeg of image/png). In Power Automate stromen wordt de hoofdtekst van het antwoord base64-gecodeerd. De afbeelding weergeven of opslaan:

  • Gebruik de base64ToBinary() expressie om te converteren voordat u opslaat in OneDrive/SharePoint.
  • Gebruik een HTML-tabel of een e-mailactie verzenden met een <img src="data:image/png;base64,{body/$content}"> tag om inline weer te geven.

Beleidsnotities

  • subscription-key wordt geïnjecteerd door beleid; het wordt nooit doorgegeven door de beller.
  • De x-ms-apim-tokens en origin headers worden verwijderd voor inkomend verkeer.
  • Content-Type: application/json wordt geforceerd op alle aanvragen zonder installatiekopieën; reacties op afbeeldingen herstellen het juiste inhoudstype image/* voor uitgaand verkeer.
  • GetRoute converteert een eenvoudige queryparameteraanvraag naar een POST met een GeoJSON-hoofdtekst. Bellers hoeven de hoofdtekst niet zelf te maken.

Bestanden

File Purpose
apiDefinition.swagger.json OpenAPI-definitie
Implementatie/policies.xml APIM-beleid
Implementatie/PolicySourceCode.cs C#-logica voor beleid
connector-config-internal.json Verificatie- en omgevingsconfiguratie
connector-config-cli.json Mogelijkheden (actions)
connector-config-certification.json API-naam (azuremaps) en laag (Standard)
connector-config-metadata.json Eigendomsmetagegevens

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs

Naam Type Beschrijving Required
Abonnementssleutel beveiligde string Azure Maps-abonnementssleutel True

Acties

Locatie ophalen op adres (preview)

Geocodeer een adres om de coördinaten en locatiegegevens op te halen.
Locatie per punt ophalen (preview)

Haal de locatiegegevens op die zijn gekoppeld aan breedte- en lengtegraadcoördinaten.
Route ophalen (preview)

Bereken een rij- of wandelroute met behulp van waypoints. Waypoints moeten worden opgegeven als breedtegraad, lengtegraadcoördinaten.
Statische kaart ophalen (preview)

Haal een statische kaartafbeelding op die is gecentreerd op een punt. GIF wordt niet ondersteund; JPEG of PNG gebruiken.

Locatie ophalen op adres (preview)

Bewerkings-id:
GetLocationByAddress

Geocodeer een adres om de coördinaten en locatiegegevens op te halen.

Parameters

Name Sleutel Vereist Type Description
Adresregel
 addressLine string

De straatregel van een adres (niet inclusief plaats, staat, enzovoort).
Plaats (plaats)
 locality string

De plaats, zoals een Amerikaanse stad.
Beheerdistrict (staat)
 adminDistrict string

Een onderverdeling zoals een afkorting van een Amerikaanse staat (bijvoorbeeld WA).
Postcode
 postalCode string

De postcode.
Landregio
 countryRegion string

De ISO-landcode van 2 letters (bijvoorbeeld VS).
Maximum aantal resultaten
 top integer

Maximum aantal resultaten dat moet worden geretourneerd (1-20). Standaard: 5.

Retouren

Body
GetLocationByAddress_Response

Locatie per punt ophalen (preview)

Bewerkings-id:
GetLocationByPoint

Haal de locatiegegevens op die zijn gekoppeld aan breedte- en lengtegraadcoördinaten.

Parameters

Name Sleutel Vereist Type Description
Breedtegraad van punt
 latitude True double

De breedtegraadcoördinaat om geocode om te keren. Voorbeeld: 47.64054
Lengtegraad van punt
 longitude True double

De lengtegraadcoördinaat om geocode om te keren. Voorbeeld: -122.12934

Retouren

Body
GetLocationByAddress_Response

Route ophalen (preview)

Bewerkings-id:
GetRoute

Bereken een rij- of wandelroute met behulp van waypoints. Waypoints moeten worden opgegeven als breedtegraad, lengtegraadcoördinaten.

Parameters

Name Sleutel Vereist Type Description
Waypoint 1
 wp.0 True string

Beginpunt als breedtegraad, lengtegraad (bijvoorbeeld 47,610,-122,107).
Waypoint 2
 wp.1 True string

Eindpunt als breedtegraad, lengtegraad (bijvoorbeeld 47,612,-122.204).
Reismodus
 travelMode string

De manier van reizen voor de route.
Vermijd snelwegen
 avoid_highways boolean

Vermijdt het gebruik van snelwegen in de route.
Vermijd tolgelden
 avoid_tolls boolean

Vermijdt het gebruik van tolwegen in de route.
Vermijd veerboten
 avoid_ferry boolean

Vermijd het gebruik van veerboten in de route.
Vermijd het overschrijden van landsgrenzen
 avoid_borderCrossing boolean

Vermijd het overschrijden van landgrenzen in de route.
Optimize
 optimize string

Hiermee geeft u op waarvoor de route moet worden geoptimaliseerd.

Retouren

Body
GetRoute_Response

Statische kaart ophalen (preview)

Bewerkings-id:
GetMap

Haal een statische kaartafbeelding op die is gecentreerd op een punt. GIF wordt niet ondersteund; JPEG of PNG gebruiken.

Parameters

Name Sleutel Vereist Type Description
Middenbreedtegraad
 latitude True double

De breedtegraad van het kaartcentrum. Voorbeeld: 47.64054
Midden-lengtegraad
 longitude True double

De lengtegraad van het kaartcentrum. Voorbeeld: -122.12934
Kaartstijl
 imagerySet True string

De kaartstijl die moet worden weergegeven.
Zoomniveau
 zoomLevel True string

Het zoomniveau tussen 0 en 20. Standaard: 10
Breedte (pixels)
 width integer

De breedte van de uitvoerafbeelding in pixels. Standaardwaarde: 512
Hoogte (pixels)
 height integer

De hoogte van de uitvoerafbeelding in pixels. Standaardwaarde: 512
Afbeeldingsindeling
 format string

De afbeeldingsindeling. Standaard: png
Breedtegraad van punaise
 pushpinLatitude double

Breedtegraad van punaise.
Lengtegraad van punaise
 pushpinLongitude double

Lengtegraad van punaise.
Punaiselabel
 pushpinLabel string

Punaiselabel (maximaal 3 tekens).

Retouren

response
GetMap_Response

Definities

GetRoute_Response

Name Pad Type Description
Type
 type string

GeoJSON-type (altijd FeatureCollection).
Features
 features array of object

Matrix van GeoJSON-functies: Waypoint (begin/einde), ManeuverPoint (turn-by-turn steps) en RoutePath (routeoverzicht).
Functietype
 features.type string
Geometry
 features.geometry object
Soort functie
 features.properties.type string

Functietype: Waypoint (begin-/eindpunten), ManeuverPoint (stap voor stap) of RoutePath (algemene routesamenvatting).
Afstand (meters)
 features.properties.distanceInMeters float

Totale routeafstand in meters. Aanwezig op RoutePath-functies.
Duur (seconden)
 features.properties.durationInSeconds integer

Geschatte reistijd in seconden (zonder verkeer). Aanwezig op RoutePath-functies.
Verkeersvertraging (seconden)
 features.properties.trafficDelayInSeconds integer

Extra tijd in seconden vanwege verkeer. Aanwezig op RoutePath-functies.
Verkeersopstopping
 features.properties.trafficCongestion string

Verkeersopstoppingsniveau (bijvoorbeeld Laag, Gemiddeld, Hoog). Aanwezig op RoutePath-functies.
Gebruikte verkeersgegevens
 features.properties.trafficDataUsed string

Type verkeersgegevens dat wordt gebruikt (bijvoorbeeld Geen, Flow). Aanwezig op RoutePath-functies.
Vertrek bij
 features.properties.departureAt string

Geschatte vertrektijd (ISO 8601). Aanwezig op RoutePath-functies.
Aankomst bij
 features.properties.arrivalAt string

Geschatte aankomsttijd (ISO 8601). Aanwezig op RoutePath-functies.
Instructietekst
 features.properties.instruction.text string

Leesbare instructietekst (bijvoorbeeld 'Links naar NE 8e St').
Manoeuvreertype
 features.properties.instruction.maneuverType string

Manoeuvreercode (bijvoorbeeld TurnLeft, TurnRight, Straight, ArriveFinish).
Waypoint-index
 features.properties.order.inputIndex integer

Index van het bijbehorende invoer-waypoint (0 = begin, 1 = einde).
Beenindex
 features.properties.order.legIndex integer

Index van het routebeen waartoe deze functie behoort.

GetLocationByAddress_Response

Name Pad Type Description
Type
 type string

GeoJSON-type (altijd FeatureCollection).
Features
 features array of object

Matrix van geocodeerde locatiefuncties.
Functietype
 features.type string
Geometrietype
 features.geometry.type string
Coördinaten
 features.geometry.coordinates array of double

Coördinaten als [lengtegraad, breedtegraad].
Soort functie
 features.properties.type string

Functietype: Adres of PopulatedPlace.
Vertrouwen
 features.properties.confidence string

Betrouwbaarheidsniveau van de overeenkomst (hoog, gemiddeld, laag).
Overeenkomende codes
 features.properties.matchCodes array of string

Overeenkomende codes (Goed, Dubbelzinnig, OpHiërarchie).
Adresregel
 features.properties.address.addressLine string

Adresregel.
Plaats (plaats)
 features.properties.address.locality string

Stad of plaats.
Beheerdistricten
 features.properties.address.adminDistricts array of object

Matrix van administratieve districten (bijvoorbeeld staat, provincie).
Korte naam
 features.properties.address.adminDistricts.shortName string
Naam
 features.properties.address.adminDistricts.name string
Postcode
 features.properties.address.postalCode string

Postcode.
Landregio
 features.properties.address.countryRegion string

Land- of regionaam.
Opgemaakt adres
 features.properties.address.formattedAddress string

Volledige opgemaakte adrestekenreeks.

GetMap_Response

Kaartafbeelding
binary