Azure Maps (förhandsversion)

Azure Maps tillhandahåller geospatiala API:er för mappning, routning, geokodning och omvänd geokodning.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service Class Regions
Copilot Studio Standard Alla Power Automate regioner förutom följande:
     – China Cloud drivs av 21Vianet
Logiska appar Standard Alla Logic Apps-regioner utom följande:
     - Azure kinaregioner
     - US Department of Defense (DoD)
Power Apps Standard Alla Power Apps regioner förutom följande:
     – China Cloud drivs av 21Vianet
Power Automate Standard Alla Power Automate regioner förutom följande:
     – China Cloud drivs av 21Vianet
Contact
Namn Microsoft
URL https://www.microsoft.com/
Metadata för anslutningsprogram
Publisher Microsoft
Webbplats https://azure.microsoft.com/products/azure-maps
Sekretesspolicy https://privacy.microsoft.com/privacystatement
Kategorier Data; Produktivitet

Azure Maps-anslutningsprogram

Typ: Kodlös | Nivå: Standard | Status: Förhandsgranska

Tillhandahåller funktioner för mappning, routning, geokodning och omvänd geokodning via Azure Maps REST API. Begäranden hanteras helt av APIM-principen – det finns ingen anslutningswebbapp.

Authentication

API-nyckelautentisering. Anslutningar kräver en Azure Maps prenumerationsnyckel.

Parameter Type Obligatoriskt Beskrivning
subscription_key securestring Yes Azure Maps prenumerationsnyckel

Nyckeln extraheras från anslutningstoken och skickas till Azure Maps som subscription-key frågeparameter av principen ( / CheckForTokenGetAuthHeaderValue).

Molntillgänglighet

Moln Available
Public Yes
Fairfax (GCC) Yes
GCC High Yes
DoD Yes

Åtgärder

Hämta väg – GetRoute

Beräkna en kör- eller gångväg mellan två vägpunkter. Waypoints måste vara koordinatpar (latitude,longitude). Adresser stöds inte – geokoda dem först med Hämta plats efter adress.

Slutpunkt (efter princip):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Principen konverterar FRÅGEparametrarna i GET-stil till en GeoJSON FeatureCollection POST-brödtext, vänder koordinater till longitude,latitude ordning och mappar undvika/optimera värden till Azure Maps motsvarigheter.

Parameter Obligatoriskt Type Beskrivning
Waypoint 1 (wp.0) Yes string Startpunkt som latitude,longitude (t.ex. 47.610,-122.107)
Waypoint 2 (wp.1) Yes string Slutpunkt som latitude,longitude (t.ex. 47.612,-122.204)
Reseläge (travelMode) No string driving (standard) eller walking
Undvik motorvägar No boolean Mappar till avoid=limitedAccessHighways
Undvik vägtullar No boolean Mappar till avoid=tollRoads
Undvik färjor No boolean Mappar till avoid=ferries
Undvik att korsa landsgränser No boolean Mappar till avoid=borderCrossings
Optimize No string fastestWithoutTraffic, fastestWithTraffic eller shortest

Svar: Routningssammanfattning med reseavstånd (meter), varaktighet (sekunder), varaktighet med trafik (sekunder) och information om routningsben.

Observera: Överföringsroutning stöds inte. Azure Maps Vägbeskrivning stöder driving endast och walking.

Hämta plats efter adress – GetLocationByAddress

Geokoda en strukturerad adress för koordinater och platsinformation.

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

Parameter Obligatoriskt Type Beskrivning
Adressrad (addressLine) No string Gatulinje (t.ex. 15595 NE 36th St)
Ort (locality) No string Stad (t.ex. Redmond)
Administratörsdistrikt (adminDistrict) No string Tillståndsförkortning (t.ex. WA)
Postnummer (postalCode) No string POSTNUMMER eller postnummer (t.ex. 98052)
Landregion (countryRegion) No string ISO 2-bokstavs landskod (t.ex. US)
Maximalt antal resultat (top) No integer 1–20, standard 5

Svar: GeoJSON FeatureCollection. Varje funktion har:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Medium, eller Low
  • properties.address — addressLine, locality, adminDistricts, postalCode, ( countryRegion objekt med name och ISO), formattedAddress

Obs! Azure Maps geokodning inte stöder adresser i Kina.

Hämta plats efter punkt – GetLocationByPoint

Omvänd geokod latitud/longitud koordinater till en adress.

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

Principen kombinerar de separata latitude parametrarna och longitude parametrarna coordinates i frågeparametern i longitude,latitude ordning.

Parameter Obligatoriskt Type Beskrivning
Punkt latitud (latitude) Yes double t.ex. 47.64054
Punkt longitud (longitude) Yes double t.ex. -122.12934

Svar: Samma schema som Hämta plats efter adress (GetLocationByAddress_Response).

Hämta statisk karta – GetMap

Hämta en statisk kartbild centrerad på en punkt.

Slutpunkt (efter princip):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Principen kombinerar latitud/longitud i parametern center (longitude,latitude), mappar imagerySet till värdet Azure Maps style och skickar den valfria pushpinn som en pins parameter.

Parameter Obligatoriskt Type Beskrivning
Centrera latitud (latitude) Yes double t.ex. 47.64054
Centrera longitud (longitude) Yes double t.ex. -122.12934
Kartformat (imagerySet) Yes string Se formatmappning nedan
Zoomnivå (zoomLevel) Yes string 0–20, standard 10
Bredd (bildpunkter) No integer Standard 512
Höjd (bildpunkter) No integer Standard 512
Bildformat No string jpeg eller png (standard png). GIF stöds inte.
Latitud för pushpin No double Latitud för pushpin-plats
Pushpin longitud No double Longitud för pushpin-plats
Pushpin-etikett No string Kort etiketttext

Mappning av bilduppsättning:

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

Svar: Binär bild (image/jpeg eller image/png). I Power Automate flöden är svarstexten base64-kodad. Så här visar eller sparar du bilden:

  • Använd uttrycket base64ToBinary() för att konvertera innan du sparar till OneDrive/SharePoint.
  • Använd en HTML-tabell eller Skicka en e-poståtgärd med en <img src="data:image/png;base64,{body/$content}"> tagg för att återge infogad.

Principanteckningar

  • subscription-key matas in av en princip. den skickas aldrig igenom från anroparen.
  • Huvudena x-ms-apim-tokens och origin tas bort vid inkommande trafik.
  • Content-Type: application/json framtvingas på alla begäranden som inte är avbildningar. bildsvar återställer rätt image/* innehållstyp vid utgående trafik.
  • GetRoute konverterar en enkel frågeparameterbegäran till en POST med en GeoJSON-brödtext – anropare behöver inte skapa själva brödtexten.

Filer

File Purpose
apiDefinition.swagger.json OpenAPI-definition
Distribution/policies.xml APIM-princip
Distribution/PolicySourceCode.cs Princip-C#-logik
connector-config-internal.json Autentisering och miljökonfiguration
connector-config-cli.json Funktioner (actions)
connector-config-certification.json API-namn (azuremaps) och nivå (standard)
connector-config-metadata.json Ägarskapsmetadata

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:
Standardinställning Parametrar för att skapa anslutning. Alla regioner Shareable

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs

Namn Type Beskrivning Obligatoriskt
Prenumerationsnyckel securestring Azure Maps prenumerationsnyckel True

Åtgärder

Hämta plats efter adress (förhandsversion)

Geokoda en adress för att hämta dess koordinater och platsinformation.
Hämta plats efter punkt (förhandsversion)

Hämta platsinformationen som är associerad med latitud- och longitudkoordinater.
Hämta statisk karta (förhandsversion)

Hämta en statisk kartbild centrerad på en punkt. GIF stöds inte. använd JPEG eller PNG.
Hämta väg (förhandsversion)

Beräkna en kör- eller gångväg med hjälp av vägpunkter. Waypoints måste anges som latitud, longitudkoordinater.

Hämta plats efter adress (förhandsversion)

Åtgärds-ID:
GetLocationByAddress

Geokoda en adress för att hämta dess koordinater och platsinformation.

Parametrar

Name Nyckel Obligatorisk Typ Description
Adressrad
 addressLine string

Gaturaden för en adress (inklusive ort, delstat osv.).
Ort (ort)
 locality string

Orten, till exempel en amerikansk stad.
Administratörsdistrikt (delstat)
 adminDistrict string

En underindelning, till exempel en amerikansk statsförkortning (t.ex. WA).
Postnummer
 postalCode string

Postnummer eller postnummer.
Landregion
 countryRegion string

Landskoden ISO 2 bokstäver (t.ex. USA).
Maximalt resultat
 top integer

Maximalt antal resultat som ska returneras (1–20). Standard: 5.

Returer

Body
GetLocationByAddress_Response

Hämta plats efter punkt (förhandsversion)

Åtgärds-ID:
GetLocationByPoint

Hämta platsinformationen som är associerad med latitud- och longitudkoordinater.

Parametrar

Name Nyckel Obligatorisk Typ Description
Punkt latitud
 latitude True double

Latitudkoordinaten för omvänd geokodning. Exempel: 47.64054
Punkt longitud
 longitude True double

Longitudkoordinaten för omvänd geokod. Exempel: -122.12934

Returer

Body
GetLocationByAddress_Response

Hämta statisk karta (förhandsversion)

Åtgärds-ID:
GetMap

Hämta en statisk kartbild centrerad på en punkt. GIF stöds inte. använd JPEG eller PNG.

Parametrar

Name Nyckel Obligatorisk Typ Description
Centralt breddgrad
 latitude True double

Latitud för kartcentret. Exempel: 47.64054
Central longitud
 longitude True double

Kartcentrets longitud. Exempel: -122.12934
Kartformat
 imagerySet True string

Kartformatet som ska visas.
Zoomnivå
 zoomLevel True string

Zoomnivån mellan 0 och 20. Standard: 10
Bredd (bildpunkter)
 width integer

Bredden på utdatabilden i bildpunkter. Standard: 512
Höjd (bildpunkter)
 height integer

Höjden på utdatabilden i bildpunkter. Standard: 512
Bildformat
 format string

Bildformatet. Standard: png
Latitud för pushpin
 pushpinLatitude double

Latitud för pushpin.
Pushpin longitud
 pushpinLongitude double

Pushpin longitud.
Pushpin-etikett
 pushpinLabel string

Pushpin-etikett (upp till 3 tecken).

Returer

response
GetMap_Response

Hämta väg (förhandsversion)

Åtgärds-ID:
GetRoute

Beräkna en kör- eller gångväg med hjälp av vägpunkter. Waypoints måste anges som latitud, longitudkoordinater.

Parametrar

Name Nyckel Obligatorisk Typ Description
Waypoint 1
 wp.0 True string

Starta waypoint som latitud, longitud (t.ex. 47.610,-122.107).
Waypoint 2
 wp.1 True string

Slutpunkt som latitud, longitud (t.ex. 47.612,-122.204).
Reseläge
 travelMode string

Färdsättet för vägen.
Undvik motorvägar
 avoid_highways boolean

Undviker användning av motorvägar i vägen.
Undvik vägtullar
 avoid_tolls boolean

Undviker användning av avgiftsbelagda vägar i vägen.
Undvik färjor
 avoid_ferry boolean

Undviker användning av färjor i rutten.
Undvik att korsa landsgränser
 avoid_borderCrossing boolean

Undviker att korsa landsgränser i vägen.
Optimize
 optimize string

Anger vad vägen ska optimeras för.

Returer

Body
GetRoute_Response

Definitioner

GetRoute_Response

Name Sökväg Typ Description
Type
 type string

GeoJSON-typ (alltid FeatureCollection).
Funktioner
 features array of object

Matris med GeoJSON-funktioner: Waypoint (start/end), ManeuverPoint (steg för sväng) och RoutePath (routningssammanfattning).
Funktionstyp
 features.type string
Geometry
 features.geometry object
Typ av funktion
 features.properties.type string

Funktionstyp: Waypoint (start-/slutpunkter), ManeuverPoint (steg för tur) eller RoutePath (övergripande vägsammanfattning).
Avstånd (meter)
 features.properties.distanceInMeters float

Total ruttdistans i meter. Finns på RoutePath-funktioner.
Varaktighet (sekunder)
 features.properties.durationInSeconds integer

Uppskattad restid i sekunder (utan trafik). Finns på RoutePath-funktioner.
Trafikfördröjning (sekunder)
 features.properties.trafficDelayInSeconds integer

Extra tid i sekunder på grund av trafik. Finns på RoutePath-funktioner.
Trafikstockningar
 features.properties.trafficCongestion string

Trafikstockningsnivå (t.ex. låg, medel, hög). Finns på RoutePath-funktioner.
Trafikdata som används
 features.properties.trafficDataUsed string

Typ av trafikdata som används (t.ex. Ingen, Flöde). Finns på RoutePath-funktioner.
Avgång vid
 features.properties.departureAt string

Uppskattad avgångstid (ISO 8601). Finns på RoutePath-funktioner.
Ankomst till
 features.properties.arrivalAt string

Beräknad ankomsttid (ISO 8601). Finns på RoutePath-funktioner.
Instruktionstext
 features.properties.instruction.text string

Instruktionstext som kan läsas av människor (t.ex. "Sväng vänster till NE 8th St").
Manövreringstyp
 features.properties.instruction.maneuverType string

Manövrera typkod (t.ex. TurnLeft, TurnRight, Straight, ArriveFinish).
Waypoint Index
 features.properties.order.inputIndex integer

Index för motsvarande indatavägspunkt (0 = start, 1 = slut).
Benindex
 features.properties.order.legIndex integer

Index för routningsbenet som den här funktionen tillhör.

GetLocationByAddress_Response

Name Sökväg Typ Description
Type
 type string

GeoJSON-typ (alltid FeatureCollection).
Funktioner
 features array of object

Matris med geokodade platsfunktioner.
Funktionstyp
 features.type string
Geometrityp
 features.geometry.type string
Koordinater
 features.geometry.coordinates array of double

Koordinater som [longitud, latitud].
Typ av funktion
 features.properties.type string

Funktionstyp: Adress eller PopulatedPlace.
Förtroende
 features.properties.confidence string

Konfidensnivå för matchningen (hög, medel, låg).
Matchningskoder
 features.properties.matchCodes array of string

Matchningskoder (Bra, Tvetydigt, UpHierarchy).
Adressrad
 features.properties.address.addressLine string

Gatuadressrad.
Ort (ort)
 features.properties.address.locality string

Stad eller ort.
Administratörsdistrikt
 features.properties.address.adminDistricts array of object

Matris med administrativa distrikt (t.ex. delstat, län).
Kort namn
 features.properties.address.adminDistricts.shortName string
Namn
 features.properties.address.adminDistricts.name string
Postnummer
 features.properties.address.postalCode string

Postnummer eller postnummer.
Land
 features.properties.address.countryRegion string

Namn på land eller region.
Formaterad adress
 features.properties.address.formattedAddress string

Fullständig formaterad adresssträng.

GetMap_Response

Kartbild
binary