Azure Maps (előzetes verzió)
Azure Maps térinformatikai API-kat biztosít a leképezéshez, az útválasztáshoz, a geokódoláshoz és a fordított geokódoláshoz.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | Standard | Az összes Power Automate régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure Kína régiói - Amerikai Védelmi Minisztérium (DoD) |
| Power Apps | Standard | Az összes Power Apps régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Power Automate | Standard | Az összes Power Automate régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Contact | |
|---|---|
| Név | Microsoft |
| URL | https://www.microsoft.com/ |
| Összekötő metaadatai | |
|---|---|
| Publisher | Microsoft |
| Webhely | https://azure.microsoft.com/products/azure-maps |
| Adatvédelmi irányelvek | https://privacy.microsoft.com/privacystatement |
| Categories | Adat; Termelékenység |
Azure Maps-összekötő
Típus: Kód nélküli | Réteg: Standard | Állapot: Előzetes verzió
Leképezési, útválasztási, geokódolási és fordított geokódolási képességeket biztosít a Azure Maps REST API-val. A kéréseket teljes egészében APIM-szabályzat kezeli – nincs összekötő webalkalmazás.
Authentication
API-kulcs hitelesítése. A kapcsolatokhoz Azure Maps előfizetési kulcs szükséges.
| Paraméter | Típus | Required | Description |
|---|---|---|---|
subscription_key |
securestring | Yes | Azure Maps előfizetési kulcs |
A rendszer kinyeri a kulcsot a kapcsolati jogkivonatból, és átadja Azure Maps a szabályzat (CheckForToken / GetAuthHeaderValue) lekérdezési subscription-key paramétereként.
Felhőbeli rendelkezésre állás
| Felhő | Available |
|---|---|
| Public | Yes |
| Fairfax (GCC) | Yes |
| GCC High | Yes |
| Az Egyesült Államok Védelmi Minisztériuma (DoD) | Yes |
Műveletek
Útvonal lekérése – GetRoute
Két útpont közötti vezetési vagy gyalogos útvonal kiszámítása. Az útpontoknak koordináta-pároknak (latitude,longitude) kell lenniük. A címek nem támogatottak – először geokódolja őket a Hely lekérése cím szerint használatával.
Végpont (szabályzat után):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01
A szabályzat geojSON FeatureCollection POST törzsgé alakítja a GET típusú lekérdezési paramétereket, rendezi a longitude,latitude koordinátákat, és az értékeket Azure Maps megfelelőkké alakítja.
| Paraméter | Required | Típus | Description |
|---|---|---|---|
Waypoint 1 (wp.0) |
Yes | karakterlánc | Kiindulási pont ( latitude,longitude pl. 47.610,-122.107) |
Waypoint 2 (wp.1) |
Yes | karakterlánc | Végpont( latitude,longitude pl. 47.612,-122.204) |
Utazási mód (travelMode) |
No | karakterlánc |
driving (alapértelmezett) vagy walking |
| Elkerülheti az autópályákat | No | boolean | Térképek a avoid=limitedAccessHighways |
| Az útdíjak elkerülése | No | boolean | Térképek a avoid=tollRoads |
| A kompok elkerülése | No | boolean | Térképek a avoid=ferries |
| Kerülje az országhatárok átlépését | No | boolean | Térképek a avoid=borderCrossings |
| Optimize | No | karakterlánc |
fastestWithoutTraffic, fastestWithTraffic vagy shortest |
Válasz: Útvonal összegzése utazási távolsággal (méter), időtartam (másodperc), forgalommal (másodperc) és útvonalszakasz részleteivel.
Megjegyzés: Az átviteles útválasztás nem támogatott. Azure Maps Útvonaltervek csak támogatják
drivingéswalking.
Hely lekérése cím szerint – GetLocationByAddress
Strukturált cím geokódolása koordinátákhoz és helyadatokhoz.
Végpont:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01
| Paraméter | Required | Típus | Description |
|---|---|---|---|
Címsor (addressLine) |
No | karakterlánc | Utcavonal (pl. 15595 NE 36th St) |
Helység (locality) |
No | karakterlánc | Város (pl. Redmond) |
Felügyeleti körzet (adminDistrict) |
No | karakterlánc | Állam rövidítése (pl. WA) |
Irányítószám (postalCode) |
No | karakterlánc | IRÁNYÍTÓSZÁM vagy irányítószám (pl. 98052) |
Országrégió (countryRegion) |
No | karakterlánc | ISO 2 betűs országkód (pl. US) |
Maximális eredmények (top) |
No | egész szám | 1–20, alapértelmezett 5 |
Válasz: GeoJSON FeatureCollection. Minden funkció a következőket tartalmazza:
-
geometry.coordinates—[longitude, latitude] -
properties.confidence—High,MediumvagyLow -
properties.address—addressLine,locality,adminDistricts,postalCodecountryRegion(objektum ésnameISO),formattedAddress
Megjegyzés: Azure Maps geokódolás kínában nem támogatja a címeket.
Hely lekérése pont szerint – GetLocationByPoint
A geokód földrajzi szélességi/hosszúsági koordinátáinak megfordítása egy címre.
Végpont (szabályzat után):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}
A szabályzat sorrendben egyesíti a külön latitude és longitude a paramétereket a coordinates lekérdezési paraméterrel longitude,latitude .
| Paraméter | Required | Típus | Description |
|---|---|---|---|
Pont szélessége (latitude) |
Yes | double | például: 47.64054 |
Ponthossz (longitude) |
Yes | double | például: -122.12934 |
Válasz: Ugyanaz a séma, mint a hely lekérése cím szerint (GetLocationByAddress_Response).
Statikus térkép lekérése – GetMap
Statikus térkép képének lekérése pont alapján.
Végpont (szabályzat után):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
A szabályzat egyesíti a szélességet/hosszúságot a center paraméterrel (longitude,latitude), leképezi imagerySet a Azure Maps style értéket, és paraméterként átadja az opcionális leküldéses jelölőtpins.
| Paraméter | Required | Típus | Description |
|---|---|---|---|
Középső szélesség (latitude) |
Yes | double | például: 47.64054 |
Középső hosszúság (longitude) |
Yes | double | például: -122.12934 |
Térképstílus (imagerySet) |
Yes | karakterlánc | Lásd alább a stílusleképezést |
Nagyítási szint (zoomLevel) |
Yes | karakterlánc | 0–20, alapértelmezett 10 |
| Szélesség (képpont) | No | egész szám | Alapértelmezett 512 |
| Magasság (képpont) | No | egész szám | Alapértelmezett 512 |
| Képformátum | No | karakterlánc |
jpeg vagy png (alapértelmezett png). A GIF nem támogatott. |
| Leküldéses szélesség | No | double | Leküldéses hely szélessége |
| Leküldéses hosszúság | No | double | Leküldéses hely hosszúsága |
| Leküldéses címke | No | karakterlánc | Rövid címkeszöveg |
Képkészlet-leképezés:
imagerySet Bemenet |
Azure Maps style |
|---|---|
Road |
main |
Aerial |
satellite |
AerialWithLabels |
satellite_road_labels |
CanvasDark |
dark |
CanvasLight |
road_shaded_relief |
CanvasGray |
grayscale_light |
Válasz: Bináris kép (image/jpeg vagy image/png). A Power Automate folyamatokban a válasz törzse base64 kódolású. A kép megjelenítése vagy mentése:
- A kifejezést a
base64ToBinary()OneDrive/SharePoint való mentés előtt konvertálhatja. -
Használjon HTML-táblázatot, vagy küldjön egy e-mail-műveletet egy
<img src="data:image/png;base64,{body/$content}">címkével a beágyazott megjelenítéshez.
Szabályzati megjegyzések
-
subscription-keya szabályzat beszúrja; soha nem adja át a hívótól. - Az
x-ms-apim-tokensélőfejek ésoriginaz élőfejek le vannak vetve a bejövő forgalomról. -
Content-Type: application/jsonminden nem képküldő kérésre kényszerítve van; a rendszerkép-válaszok visszaállítják a megfelelőimage/*tartalomtípust kimenő forgalom esetén. -
GetRouteegy egyszerű lekérdezés-paraméteres kérést geojSON-törzstel rendelkező POST-fájllá konvertál – a hívóknak nem kell maguknak a törzset felépíteniük.
Files
| Fájl | Alkalmazás célja |
|---|---|
| apiDefinition.swagger.json | OpenAPI-definíció |
| Üzembe helyezés/policies.xml | APIM-szabályzat |
| Üzembe helyezés/PolicySourceCode.cs | Szabályzat C# logikája |
| connector-config-internal.json | Hitelesítési és környezeti konfiguráció |
| connector-config-cli.json | Képességek (actions) |
| connector-config-certification.json | API-név (azuremaps) és réteg (Standard) |
| connector-config-metadata.json | Tulajdonosi metaadatok |
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Alapértelmezett | A kapcsolat létrehozásának paraméterei. | Minden régió | Megosztható |
Alapértelmezett
Alkalmazható: Minden régió
A kapcsolat létrehozásának paraméterei.
Ez megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a kapcsolat is meg van osztva. További információkért tekintse meg a vászonalapú alkalmazások összekötőinek áttekintését – Power Apps | Microsoft Docs
| Név | Típus | Description | Required |
|---|---|---|---|
| Előfizetési kulcs | securestring | Azure Maps előfizetési kulcs | True |
Műveletek
| Hely lekérése cím alapján (előzetes verzió) |
Egy cím geokódolása a koordináták és a hely részleteinek lekéréséhez. |
| Hely lekérése pont szerint (előzetes verzió) |
Szerezze be a földrajzi szélességi és hosszúsági koordinátákkal társított helyadatokat. |
| Statikus térkép lekérése (előzetes verzió) |
Statikus térkép képének lekérése pont alapján. A GIF nem támogatott; JPEG vagy PNG használatával. |
| Útvonal lekérése (előzetes verzió) |
Autós vagy gyalogos útvonal kiszámítása útpontok használatával. Az útpontokat szélességi és hosszúsági koordinátákként kell megadni. |
Hely lekérése cím alapján (előzetes verzió)
Egy cím geokódolása a koordináták és a hely részleteinek lekéréséhez.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Címsor
|
addressLine | string |
A cím utcavonala (a város, az állam stb. ki nem foglalja). |
|
|
Település (település)
|
locality | string |
A település, például egy amerikai város. |
|
|
Felügyeleti körzet (állam)
|
adminDistrict | string |
Egy alosztály, például egy AMERIKAI állam rövidítése (pl. WA). |
|
|
Irányítószám
|
postalCode | string |
Postai vagy irányítószám. |
|
|
Országrégió
|
countryRegion | string |
Az ISO 2 betűs országkód (pl. USA). |
|
|
Maximális eredmények
|
top | integer |
A visszaadandó eredmények maximális száma (1–20). Alapértelmezett: 5. |
Válaszok
Hely lekérése pont szerint (előzetes verzió)
Szerezze be a földrajzi szélességi és hosszúsági koordinátákkal társított helyadatokat.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Pont szélessége
|
latitude | True | double |
A geokód megfordításához használandó szélességi koordináták. Példa: 47.64054 |
|
Pont hosszúsága
|
longitude | True | double |
A geokód fordított hosszúsági koordinátája. Példa: -122.12934 |
Válaszok
Statikus térkép lekérése (előzetes verzió)
Statikus térkép képének lekérése pont alapján. A GIF nem támogatott; JPEG vagy PNG használatával.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Középső szélességi fok
|
latitude | True | double |
A térképközpont szélessége. Példa: 47.64054 |
|
Középső hosszúsági kör
|
longitude | True | double |
A térképközpont hosszúsága. Példa: -122.12934 |
|
Térképstílus
|
imagerySet | True | string |
A megjelenítendő térképstílus. |
|
Nagyítási szint
|
zoomLevel | True | string |
A 0 és 20 közötti nagyítási szint. Alapértelmezés: 10 |
|
Szélesség (képpont)
|
width | integer |
A kimeneti kép szélessége képpontban. Alapértelmezett: 512 |
|
|
Magasság (képpont)
|
height | integer |
A kimeneti kép magassága képpontban. Alapértelmezett: 512 |
|
|
Képformátum
|
format | string |
A kép formátuma. Alapértelmezett: png |
|
|
Leküldéses szélesség
|
pushpinLatitude | double |
Leküldéses szélesség. |
|
|
Leküldéses hosszúság
|
pushpinLongitude | double |
Tolópin hosszúság. |
|
|
Leküldéses címke
|
pushpinLabel | string |
Leküldéses címke (legfeljebb 3 karakter). |
Válaszok
- response
- GetMap_Response
Útvonal lekérése (előzetes verzió)
Autós vagy gyalogos útvonal kiszámítása útpontok használatával. Az útpontokat szélességi és hosszúsági koordinátákként kell megadni.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Waypoint 1
|
wp.0 | True | string |
Kiindulópont szélességként, hosszúság (pl. 47.610,-122.107). |
|
Waypoint 2
|
wp.1 | True | string |
A végpont szélessége és hosszúsága (pl. 47.612,-122.204). |
|
Utazási mód
|
travelMode | string |
Az útvonal utazási módja. |
|
|
Elkerülheti az autópályákat
|
avoid_highways | boolean |
Elkerüli az autópályák használatát az útvonalon. |
|
|
Az útdíjak elkerülése
|
avoid_tolls | boolean |
Elkerüli az útdíjköteles utak használatát az útvonalon. |
|
|
A kompok elkerülése
|
avoid_ferry | boolean |
Elkerüli a kompok használatát az útvonalon. |
|
|
Kerülje az országhatárok átlépését
|
avoid_borderCrossing | boolean |
Elkerüli az országhatárok átlépését az útvonalon. |
|
|
Optimize
|
optimize | string |
Megadja, hogy mire optimalizálja az útvonalat. |
Válaszok
- Törzs
- GetRoute_Response
Definíciók
GetRoute_Response
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Típus
|
type | string |
GeoJSON-típus (mindig FeatureCollection). |
|
Features
|
features | array of object |
GeoJSON-funkciók tömbje: Waypoint (start/end), ManeuverPoint (turn-by-turn steps) és RoutePath (útvonal-összefoglalás). |
|
Szolgáltatás típusa
|
features.type | string | |
|
Geometry
|
features.geometry | object | |
|
Funkció típusa
|
features.properties.type | string |
Szolgáltatás típusa: Waypoint (kezdő/végpontok), a Manőverpont (turn-by-turn step) vagy a RoutePath (az útvonal összesített összegzése). |
|
Távolság (méter)
|
features.properties.distanceInMeters | float |
Az útvonal teljes távolsága méterben. Bemutatjuk a RoutePath funkcióit. |
|
Időtartam (másodperc)
|
features.properties.durationInSeconds | integer |
Becsült utazási idő másodpercben (forgalom nélkül). Bemutatjuk a RoutePath funkcióit. |
|
Forgalom késleltetése (másodperc)
|
features.properties.trafficDelayInSeconds | integer |
Hosszabb idő másodpercben a forgalom miatt. Bemutatjuk a RoutePath funkcióit. |
|
Forgalmi torlódás
|
features.properties.trafficCongestion | string |
Forgalmi torlódás szintje (pl. Alacsony, Közepes, Magas). Bemutatjuk a RoutePath funkcióit. |
|
Használt forgalmi adatok
|
features.properties.trafficDataUsed | string |
A használt forgalmi adatok típusa (pl. Nincs, Flow). Bemutatjuk a RoutePath funkcióit. |
|
Indulás:
|
features.properties.departureAt | string |
Becsült indulási idő (ISO 8601). Bemutatjuk a RoutePath funkcióit. |
|
Érkezés a
|
features.properties.arrivalAt | string |
Becsült érkezési idő (ISO 8601). Bemutatjuk a RoutePath funkcióit. |
|
Utasítás szövege
|
features.properties.instruction.text | string |
Emberi olvasásra alkalmas utasításszöveg (pl. "Balra fordulás a NE 8. szt. felé"). |
|
Manőver típusa
|
features.properties.instruction.maneuverType | string |
A manőver típuskódja (pl. TurnLeft, TurnRight, Straight, ArriveFinish). |
|
Waypoint-index
|
features.properties.order.inputIndex | integer |
A megfelelő bemeneti útpont indexe (0 = kezdet, 1 = vége). |
|
Lábindex
|
features.properties.order.legIndex | integer |
Annak az útvonallábnak az indexe, amelyhez ez a funkció tartozik. |
GetLocationByAddress_Response
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Típus
|
type | string |
GeoJSON-típus (mindig FeatureCollection). |
|
Features
|
features | array of object |
Geokódolt helyfunkciók tömbje. |
|
Szolgáltatás típusa
|
features.type | string | |
|
Geometria típusa
|
features.geometry.type | string | |
|
Koordináták
|
features.geometry.coordinates | array of double |
[hosszúság, szélesség] koordináták. |
|
Funkció típusa
|
features.properties.type | string |
Szolgáltatás típusa: Cím vagy Lakott hely. |
|
Megbízhatóság
|
features.properties.confidence | string |
Az egyezés megbízhatósági szintje (Magas, Közepes, Alacsony). |
|
Kódok egyeztetése
|
features.properties.matchCodes | array of string |
Egyező kódok (Jó, Nem egyértelmű, UpHierarchy). |
|
Címsor
|
features.properties.address.addressLine | string |
Utcacímsor. |
|
Település (település)
|
features.properties.address.locality | string |
Település vagy város. |
|
Felügyeleti körzetek
|
features.properties.address.adminDistricts | array of object |
Közigazgatási körzetek tömbje (pl. állam, megye). |
|
Rövid név
|
features.properties.address.adminDistricts.shortName | string | |
|
Név
|
features.properties.address.adminDistricts.name | string | |
|
Irányítószám
|
features.properties.address.postalCode | string |
Postai vagy irányítószám. |
|
Országrégió
|
features.properties.address.countryRegion | string |
Ország vagy régió neve. |
|
Formázott cím
|
features.properties.address.formattedAddress | string |
Teljes formázott címsztring. |
GetMap_Response
- Kép leképezése
- binary