Azure Maps (Preview)

Azure Maps poskytuje geoprostorová rozhraní API pro mapování, směrování, geokódování a zpětné geokódování.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Oblasti
Copilot Studio Standard Všechny oblasti Power Automate kromě následujících:
     - China Cloud provozovaný společností 21Vianet
Logické aplikace Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure oblasti Čína
     - Ministerstvo obrany USA (DoD)
Power Apps Standard Všechny oblasti Power Apps s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Automatizace napájení Standard Všechny oblasti Power Automate kromě následujících:
     - China Cloud provozovaný společností 21Vianet
Contact
název Microsoft
URL https://www.microsoft.com/
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://azure.microsoft.com/products/azure-maps
Zásady ochrany osobních údajů https://privacy.microsoft.com/privacystatement
Kategorie Data; Produktivita

konektor Azure Maps

Typ: Bez kódu | Vrstvy: Standardní | Stav: Náhled

Poskytuje možnosti mapování, směrování, geografického kódování a zpětného kódování prostřednictvím rozhraní AZURE MAPS REST API. Požadavky se zpracovávají zcela pomocí zásad APIM – neexistuje žádná webová aplikace konektoru.

Authentication

Ověřování pomocí klíče rozhraní API Připojení vyžadují klíč předplatného Azure Maps.

Parameter Typ Required Description
subscription_key securestring Yes klíč předplatného Azure Maps

Klíč se extrahuje z tokenu připojení a předá Azure Maps jako subscription-key parametr dotazu zásadou ( / CheckForTokenGetAuthHeaderValue).

Dostupnost cloudu

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

Akce

Získání trasy – GetRoute

Vypočítejte trasu jízdy nebo chůze mezi dvěma směrovými body. Směrové body musí být souřadnicové páry (latitude,longitude). Adresy nejsou podporované – geokóduje je nejprve pomocí funkce Získat umístění podle adresy.

Koncový bod (za zásadou):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Zásada převede parametry dotazu ve stylu GET na tělo GeoJSON FeatureCollection POST, překlopí souřadnice na longitude,latitude pořadí a mapuje hodnoty, aby se vyhnuly nebo optimalizovaly hodnoty na Azure Maps ekvivalenty.

Parameter Required Typ Description
Směrový bod 1 (wp.0) Yes řetězec Výchozí bod jako latitude,longitude (např. 47.610,-122.107)
Směrový bod 2 (wp.1) Yes řetězec Koncový bod jako latitude,longitude (např. 47.612,-122.204)
Cestovní režim (travelMode) Ne řetězec driving (výchozí) nebo walking
Vyhněte se dálnicm Ne boolean Mapuje na avoid=limitedAccessHighways
Vyhněte se placeným poplatkům Ne boolean Mapuje na avoid=tollRoads
Vyhněte se trajektům Ne boolean Mapuje na avoid=ferries
Vyhněte se překročení hranic zemí Ne boolean Mapuje na avoid=borderCrossings
Optimize Ne řetězec fastestWithoutTraffic, fastestWithTraffic nebo shortest

Reakce: Shrnutí trasy s délkou cesty (měřiče), dobou trvání (sekundy), dobou trvání s provozem (sekundy) a podrobnostmi trasy.

Poznámka: Směrování přenosu se nepodporuje. Azure Maps směr trasy podporuje driving pouze a walking.

Získání polohy podle adresy – GetLocationByAddress

Geografické kódování strukturované adresy pro souřadnice a podrobnosti o poloze

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

Parameter Required Typ Description
Řádek adresy (addressLine) Ne řetězec Ulice (např. 15595 NE 36th St)
Lokalita (locality) Ne řetězec Město (např. Redmond)
Oblast pro správu (adminDistrict) Ne řetězec Zkratka státu (např. WA)
PSČ (postalCode) Ne řetězec PSČ (např. 98052)
Země (countryRegion) Ne řetězec Kód země ISO 2 písmen (např. US)
Maximální počet výsledků (top) Ne integer 1–20, výchozí 5

Odpověď: GeoJSON FeatureCollection. Každá funkce má:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Mediumnebo Low
  • properties.address— addressLine, locality, adminDistricts, , , postalCodecountryRegion (objekt s name a ISO),formattedAddress

Poznámka: Azure Maps geokódování nepodporuje adresy v Číně.

Získání umístění podle bodu – GetLocationByPoint

Zpětné souřadnice zeměpisné šířky a délky zeměpisné šířky a délky na adresu

Koncový bod (za zásadou):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

Zásada kombinuje samostatné latitude parametry a longitude parametry do parametru coordinates dotazu v longitude,latitude pořadí.

Parameter Required Typ Description
Šířka bodu (latitude) Yes double Například 47.64054
Zeměpisná délka bodu (longitude) Yes double Například -122.12934

Reakce: Stejné schéma jako Získat umístění podle adresy (GetLocationByAddress_Response).

Získání statické mapy – GetMap

Získejte obrázek statické mapy na střed bodu.

Koncový bod (za zásadou):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Zásada kombinuje zeměpisnou šířku a délku do parametru center (longitude,latitude), mapuje imagerySet se na hodnotu Azure Maps style a předá volitelnou pins připínáč jako parametr.

Parameter Required Typ Description
Zeměpisná šířka středu (latitude) Yes double Například 47.64054
Střední zeměpisná délka (longitude) Yes double Například -122.12934
Styl mapy (imagerySet) Yes řetězec Podívejte se na mapování stylů níže.
Úroveň přiblížení (zoomLevel) Yes řetězec 0–20, výchozí 10
Šířka (pixely) Ne integer Výchozí 512
Výška (pixely) Ne integer Výchozí 512
Formát obrázku Ne řetězec jpeg nebo png (výchozí png). Gif není podporován.
Zeměpisná šířka připínáku Ne double Zeměpisná šířka umístění připínáku
Zeměpisná délka připínáku Ne double Zeměpisná délka umístění připnutí
Popisek připínáku Ne řetězec Krátký text popisku

Mapování sady obrázků:

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

Reakce: Binární obrázek (image/jpeg nebo image/png). V Power Automate toky tělo odpovědi je kódováno base64. Zobrazení nebo uložení obrázku:

  • base64ToBinary() Před uložením na OneDrive/SharePoint použijte výraz.
  • K vykreslení vložené použijte tabulku HTML nebo akci Odeslat e-mail se značkou <img src="data:image/png;base64,{body/$content}"> .

Poznámky k zásadám

  • subscription-key je vložena zásadami; nikdy neprochází od volajícího.
  • Záhlaví x-ms-apim-tokens a origin záhlaví jsou provázena u příchozích dat.
  • Content-Type: application/json vynucuje všechny požadavky, které nejsou image; odpovědi na obrázky obnoví správný image/* typ obsahu u odchozích přenosů.
  • GetRoute převede jednoduchý požadavek parametru dotazu na POST s tělem GeoJSON – volající nemusí vytvářet samotné tělo.

Files

File Purpose
apiDefinition.swagger.json Definice OpenAPI
Nasazení/policies.xml Zásady APIM
Nasazení/PolicySourceCode.cs Logika jazyka C# zásad
connector-config-internal.json Konfigurace ověřování a prostředí
connector-config-cli.json Možnosti (actions)
connector-config-certification.json Název rozhraní API (azuremaps) a úroveň (Standard)
connector-config-metadata.json Metadata vlastnictví

Vytvoření připojení

Konektor podporuje následující typy ověřování:
Default Parametry pro vytvoření připojení Všechny oblasti Sdíletelný

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

název Typ Description Required
Klíč předplatného securestring klíč předplatného Azure Maps Pravdivé

Akce

Získání statické mapy (Preview)

Získejte obrázek statické mapy na střed bodu. GIF není podporován; použijte formát JPEG nebo PNG.
Získání trasy (Preview)

Vypočítejte trasu pro jízdu nebo procházku pomocí waypointů. Směrové body musí být zadané jako souřadnice zeměpisné šířky, délky.
Získání umístění podle adresy (Preview)

Geokódování adresy pro získání souřadnic a podrobností o poloze
Získání umístění podle bodu (Preview)

Získejte informace o poloze přidružené ke souřadnicům zeměpisné šířky a délky.

Získání statické mapy (Preview)

ID operace:
GetMap

Získejte obrázek statické mapy na střed bodu. GIF není podporován; použijte formát JPEG nebo PNG.

Parametry

Name Klíč Vyžadováno Typ Description
Středová zeměpisná šířka
 latitude True double

Zeměpisná šířka středu mapy. Příklad: 47.64054
Střední délka
 longitude True double

Zeměpisná délka středu mapy. Příklad: -122.12934
Styl mapy
 imagerySet True string

Styl mapy, který se má zobrazit.
Úroveň přiblížení
 zoomLevel True string

Úroveň přiblížení mezi 0 a 20. Výchozí: 10
Šířka (pixely)
 width integer

Šířka výstupního obrázku v pixelech. Výchozí hodnota: 512
Výška (pixely)
 height integer

Výška výstupního obrázku v pixelech Výchozí hodnota: 512
Formát obrázku
 format string

Formát obrázku. Výchozí: png
Zeměpisná šířka připínáku
 pushpinLatitude double

Zeměpisná šířka připínáku.
Zeměpisná délka připínáku
 pushpinLongitude double

Zeměpisná délka připínáku.
Popisek připínáku
 pushpinLabel string

Popisek připínáku (až 3 znaky).

Návraty

response
GetMap_Response

Získání trasy (Preview)

ID operace:
GetRoute

Vypočítejte trasu pro jízdu nebo procházku pomocí waypointů. Směrové body musí být zadané jako souřadnice zeměpisné šířky, délky.

Parametry

Name Klíč Vyžadováno Typ Description
Směrový bod 1
 wp.0 True string

Počáteční směrová bod jako zeměpisná šířka,zeměpisná délka (např. 47,610,-122,107).
Směrový bod 2
 wp.1 True string

Koncová směrová bod jako zeměpisná šířka,zeměpisná délka (např. 47,612,-122,204).
Cestovní režim
 travelMode string

Režim cesty pro trasu.
Vyhněte se dálnicm
 avoid_highways boolean

Vyhne se používání dálnic v trase.
Vyhněte se placeným poplatkům
 avoid_tolls boolean

Vyhne se používání zpoplatněných silnic v trase.
Vyhněte se trajektům
 avoid_ferry boolean

Vyhněte se používání trajektů v trase.
Vyhněte se překročení hranic zemí
 avoid_borderCrossing boolean

Vyhněte se překračování hranic zemí v trase.
Optimize
 optimize string

Určuje, pro co se má trasa optimalizovat.

Návraty

Body
GetRoute_Response

Získání umístění podle adresy (Preview)

ID operace:
GetLocationByAddress

Geokódování adresy pro získání souřadnic a podrobností o poloze

Parametry

Name Klíč Vyžadováno Typ Description
Řádek adresy
 addressLine string

Řádek ulice adresy (mimo město, stát atd.).
Lokalita (Město)
 locality string

Lokalita, například město USA.
Oblast pro správu (stát)
 adminDistrict string

Dílčí rozdělení, jako je zkratka státu USA (např. WA).
PSČ
 postalCode string

PSČ nebo PSČ.
Oblast země
 countryRegion string

Kód země ISO 2 písmen (např. USA).
Maximální počet výsledků
 top integer

Maximální počet vrácených výsledků (1–20) Výchozí hodnota: 5.

Návraty

Body
GetLocationByAddress_Response

Získání umístění podle bodu (Preview)

ID operace:
GetLocationByPoint

Získejte informace o poloze přidružené ke souřadnicům zeměpisné šířky a délky.

Parametry

Name Klíč Vyžadováno Typ Description
Šířka bodu
 latitude True double

Souřadnice zeměpisné šířky pro zpětnou geokódu. Příklad: 47.64054
Zeměpisná délka bodu
 longitude True double

Souřadnice zeměpisné délky pro zpětnou geokódu. Příklad: -122.12934

Návraty

Body
GetLocationByAddress_Response

Definice

GetRoute_Response

Name Cesta Typ Description
Typ
 type string

Typ GeoJSON (vždy FeatureCollection).
Funkce
 features array of object

Array of GeoJSON features: Waypoint (start/end), Chytácký bod (turn-by-turn steps) a RoutePath (souhrn tras).
Typ funkce
 features.type string
Geometry
 features.geometry object
Druh funkce
 features.properties.type string

Druh funkce: Směrový bod (počáteční/koncové body), Manévrovací bod (krok po turn-by-turn) nebo RoutePath (celkový souhrn trasy).
Vzdálenost (metry)
 features.properties.distanceInMeters float

Celková vzdálenost trasy v metrech. Prezentovat v funkcích RoutePath
Doba trvání (sekundy)
 features.properties.durationInSeconds integer

Odhadovaná doba trvání cesty v sekundách (bez provozu). Prezentovat v funkcích RoutePath
Zpoždění provozu (sekundy)
 features.properties.trafficDelayInSeconds integer

Doba navíc v sekundách kvůli provozu. Prezentovat v funkcích RoutePath
Dopravní zácpa
 features.properties.trafficCongestion string

Úroveň dopravního zahlcení (např. Nízká, Střední, Vysoká). Prezentovat v funkcích RoutePath
Použitá data provozu
 features.properties.trafficDataUsed string

Typ použitých provozních dat (např. Žádné, Tok). Prezentovat v funkcích RoutePath
Odjezd na adrese
 features.properties.departureAt string

Odhadovaný čas odletu (ISO 8601). Prezentovat v funkcích RoutePath
Příjezd do ubytování
 features.properties.arrivalAt string

Odhadovaný čas příjezdu (ISO 8601). Prezentovat v funkcích RoutePath
Text instrukce
 features.properties.instruction.text string

Čitelný instrukční text (např. 'Turn left on NE 8th St').
Typ manévru
 features.properties.instruction.maneuverType string

Kód typu manévru (např. TurnLeft, TurnRight, Straight, ArriveFinish).
Index směrového bodu
 features.properties.order.inputIndex integer

Index odpovídajícího vstupního směrného bodu (0 = začátek, 1 = konec).
Index noha
 features.properties.order.legIndex integer

Index trasy, do které tato funkce patří.

GetLocationByAddress_Response

Name Cesta Typ Description
Typ
 type string

Typ GeoJSON (vždy FeatureCollection).
Funkce
 features array of object

Pole funkcí geograficky zakódovaného umístění
Typ funkce
 features.type string
Typ geometrie
 features.geometry.type string
Souřadnice
 features.geometry.coordinates array of double

Souřadnice jako [zeměpisná délka, zeměpisná šířka].
Druh funkce
 features.properties.type string

Druh funkce: Adresa nebo PopulatedPlace.
Spolehlivost
 features.properties.confidence string

Úroveň spolehlivosti shody (Vysoká, Střední, Nízká).
Kódy shody
 features.properties.matchCodes array of string

Kódy shody (Dobré, Nejednoznačné, Nadřazenost).
Řádek adresy
 features.properties.address.addressLine string

Řádek adresy na ulici.
Lokalita (Město)
 features.properties.address.locality string

Město nebo lokalita.
Admin Districts
 features.properties.address.adminDistricts array of object

Pole správních obvodů (např. stát, okres).
Krátký název
 features.properties.address.adminDistricts.shortName string
název
 features.properties.address.adminDistricts.name string
PSČ
 features.properties.address.postalCode string

PSČ nebo PSČ.
Země – oblast
 features.properties.address.countryRegion string

Název země nebo oblasti
Formátovaná adresa
 features.properties.address.formattedAddress string

Dokončete formátovaný řetězec adresy.

GetMap_Response

Obrázek mapy
binary