Azure Maps (wersja zapoznawcza)
Azure Maps udostępnia geoprzestrzenne interfejsy API do mapowania, routingu, geokodowania i odwrotnego geokodowania.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regiony |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: - Azure regionach Chin - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony Power Apps z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Power Automate - narzędzie do automatyzacji procesów | Standard | Wszystkie regiony Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Kontakt biznesowy | |
|---|---|
| Nazwa | Microsoft |
| adres URL | https://www.microsoft.com/ |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://azure.microsoft.com/products/azure-maps |
| Zasady ochrony prywatności | https://privacy.microsoft.com/privacystatement |
| Kategorie | Dane; Produktywność |
łącznik Azure Maps
Typu: Bez kodu | Warstwy: Standardowa | Stan: Podgląd
Zapewnia możliwości mapowania, routingu, geokodowania i odwrotnego geokodowania za pośrednictwem interfejsu API REST Azure Maps. Żądania są obsługiwane w całości przez zasady usługi APIM — nie ma aplikacji internetowej łącznika.
Authentication
Uwierzytelnianie klucza interfejsu API. Połączenia wymagają klucza subskrypcji Azure Maps.
| Parameter | Typ | Required | Description |
|---|---|---|---|
subscription_key |
securestring | Yes | klucz subskrypcji Azure Maps |
Klucz jest wyodrębniany z tokenu połączenia i przekazywany do Azure Maps jako subscription-key parametr zapytania przez zasady ( / CheckForTokenGetAuthHeaderValue).
Dostępność chmury
| Cloud | Available |
|---|---|
| Public | Yes |
| Fairfax (GCC) | Yes |
| GCC High | Yes |
| DoD | Yes |
Czynności
Pobieranie trasy — GetRoute
Obliczanie trasy jazdy lub chodzenia między dwoma punktami drogi. Punkty drogi muszą być parami współrzędnych (latitude,longitude). Adresy nie są obsługiwane — najpierw zakoduj je za pomocą polecenia Pobierz lokalizację według adresu.
Punkt końcowy (po zasadach):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01
Zasady konwertują parametry zapytania w stylu GET na treść POST w formacie GeoJSONFeatureCollection, przerzuca współrzędne na longitude,latitude kolejność i mapuje wartości unikać/optymalizować w celu Azure Maps odpowiedników.
| Parameter | Required | Typ | Description |
|---|---|---|---|
Punkt drogi 1 (wp.0) |
Yes | ciąg | Punkt początkowy ( latitude,longitude np. 47.610,-122.107) |
Punkt drogowy 2 (wp.1) |
Yes | ciąg | Punkt końcowy ( latitude,longitude np. 47.612,-122.204) |
Tryb podróży (travelMode) |
No | ciąg |
driving (wartość domyślna) lub walking |
| Unikaj autostrad | No | boolean | Mapuje na avoid=limitedAccessHighways |
| Unikanie opłat | No | boolean | Mapuje na avoid=tollRoads |
| Unikaj promów | No | boolean | Mapuje na avoid=ferries |
| Unikanie przekraczania granic kraju | No | boolean | Mapuje na avoid=borderCrossings |
| Optimize | No | ciąg |
fastestWithoutTraffic, fastestWithTraffic lub shortest |
Odpowiedzi: Podsumowanie trasy z odległością podróży (mierniki), czas trwania (sekundy), czas trwania ruchu (sekundy) i szczegóły trasy.
Uwaga: Routing tranzytowy nie jest obsługiwany. usługa Azure Maps Route Directions obsługuje tylko polecenia
drivingiwalking.
Pobieranie lokalizacji według adresu — GetLocationByAddress
Geokoduj ustrukturyzowany adres do współrzędnych i szczegółów lokalizacji.
Punkt końcowy:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01
| Parameter | Required | Typ | Description |
|---|---|---|---|
Wiersz adresu (addressLine) |
No | ciąg | Linia ulicna (np. 15595 NE 36th St) |
Lokalność (locality) |
No | ciąg | Miasto (np. Redmond) |
Dystrykt administracyjny (adminDistrict) |
No | ciąg | Skrót stanu (np. WA) |
Kod pocztowy (postalCode) |
No | ciąg | Kod pocztowy lub kod pocztowy (np. 98052) |
Region kraju (countryRegion) |
No | ciąg | Kod kraju ISO 2-literowy (np. US) |
Maksymalna liczba wyników (top) |
No | liczba całkowita | 1–20, wartość domyślna 5 |
Odpowiedzi: GeoJSON FeatureCollection. Każda funkcja ma następujące funkcje:
-
geometry.coordinates—[longitude, latitude] -
properties.confidence—High,MediumlubLow -
properties.address—addressLine, ,adminDistrictslocality, ,countryRegionpostalCode(obiekt z elementaminameiISO)formattedAddress
Uwaga: Azure Maps geokodowanie nie obsługuje adresów w Chinach.
Pobieranie lokalizacji według punktu — GetLocationByPoint
Odwracanie współrzędnych szerokości/długości geograficznej kodu geograficznego na adres.
Punkt końcowy (po zasadach):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}
Zasady łączą oddzielne latitude parametry i longitude w coordinates parametr zapytania w longitude,latitude kolejności.
| Parameter | Required | Typ | Description |
|---|---|---|---|
Szerokość geograficzna punktu (latitude) |
Yes | double | Na przykład: 47.64054 |
Długość geograficzna punktu (longitude) |
Yes | double | Na przykład: -122.12934 |
Odpowiedź: Taki sam schemat jak Pobierz lokalizację według adresu (GetLocationByAddress_Response).
Pobieranie mapy statycznej — GetMap
Pobierz obraz mapy statycznej wyśrodkowany w punkcie.
Punkt końcowy (po zasadach):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
Zasady łączą szerokość geograficzną/długość geograficzną w center parametr (longitude,latitude), mapuje imagerySet wartość Azure Maps style i przekazuje opcjonalny pushpin jako pins parametr.
| Parameter | Required | Typ | Description |
|---|---|---|---|
Szerokość geograficzna środkowa (latitude) |
Yes | double | Na przykład: 47.64054 |
Długość geograficzna środkowa (longitude) |
Yes | double | Na przykład: -122.12934 |
Styl mapy (imagerySet) |
Yes | ciąg | Zobacz mapowanie stylów poniżej |
Poziom powiększenia (zoomLevel) |
Yes | ciąg | 0–20, wartość domyślna 10 |
| Szerokość (piksele) | No | liczba całkowita | Wartość domyślna 512 |
| Wysokość (piksele) | No | liczba całkowita | Wartość domyślna 512 |
| Format obrazu | No | ciąg |
jpeg lub png (wartość domyślna png). Plik GIF nie jest obsługiwany. |
| Szerokość geograficzna wypychania | No | double | Szerokość geograficzna lokalizacji wypychania |
| Długość geograficzna wypychania | No | double | Długość geograficzna lokalizacji wypychania |
| Etykieta wypychania | No | ciąg | Krótki tekst etykiety |
Mapowanie zestawu obrazów:
imagerySet wkład |
Azure Maps style |
|---|---|
Road |
main |
Aerial |
satellite |
AerialWithLabels |
satellite_road_labels |
CanvasDark |
dark |
CanvasLight |
road_shaded_relief |
CanvasGray |
grayscale_light |
Odpowiedź: Obraz binarny (image/jpeg lub image/png). W Power Automate przepływa treść odpowiedzi jest zakodowana w formacie base64. Aby wyświetlić lub zapisać obraz:
-
base64ToBinary()Użyj wyrażenia , aby przekonwertować przed zapisaniem na OneDrive/SharePoint. - Użyj tabeli HTML lub akcji Wyślij wiadomość e-mail z tagiem
<img src="data:image/png;base64,{body/$content}">w celu renderowania w tekście.
Uwagi dotyczące zasad
-
subscription-keyjest wstrzykiwany przez zasady; nigdy nie jest przekazywany z obiektu wywołującego. - Nagłówki
x-ms-apim-tokensioriginsą rozłożone na ruch przychodzący. -
Content-Type: application/jsonjest wymuszana na wszystkich żądaniach innych niż obrazy; odpowiedzi obrazu przywracają prawidłowyimage/*typ zawartości dla ruchu wychodzącego. -
GetRouteKonwertuje proste żądanie parametru zapytania na obiekt POST z treścią GeoJSON — obiekty wywołujące nie muszą samodzielnie konstruować treści.
Files
| File | Purpose |
|---|---|
| apiDefinition.swagger.json | Definicja interfejsu OpenAPI |
| Wdrażanie/policies.xml | Zasady usługi APIM |
| Wdrażanie/PolicySourceCode.cs | Logika języka C# zasad |
| connector-config-internal.json | Konfiguracja uwierzytelniania i środowiska |
| connector-config-cli.json | Możliwości (actions) |
| connector-config-certification.json | Nazwa interfejsu API (azuremaps) i warstwa (Standardowa) |
| connector-config-metadata.json | Metadane własności |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Udostępnialne |
Domyślny
Dotyczy: Wszystkie regiony
Parametry tworzenia połączenia.
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Nazwa | Typ | Description | Required |
|---|---|---|---|
| Klucz subskrypcji | securestring | klucz subskrypcji Azure Maps | True |
Akcje
| Pobieranie lokalizacji według adresu (wersja zapoznawcza) |
Geokoduj adres, aby uzyskać jego współrzędne i szczegóły lokalizacji. |
| Pobieranie mapy statycznej (wersja zapoznawcza) |
Pobierz obraz mapy statycznej wyśrodkowany w punkcie. Plik GIF nie jest obsługiwany; użyj formatu JPEG lub PNG. |
| Pobieranie trasy (wersja zapoznawcza) |
Obliczanie trasy jazdy lub chodzenia przy użyciu punktów drogi. Punkty drogi muszą być podane jako współrzędne szerokości geograficznej, długości geograficznej. |
| Uzyskiwanie lokalizacji według punktu (wersja zapoznawcza) |
Uzyskaj informacje o lokalizacji skojarzone ze współrzędnymi szerokości i długości geograficznej. |
Pobieranie lokalizacji według adresu (wersja zapoznawcza)
Geokoduj adres, aby uzyskać jego współrzędne i szczegóły lokalizacji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wiersz adresu
|
addressLine | string |
Linia ulicy adresu (w tym miasto, stan itp.). |
|
|
Lokalizacja (miasto)
|
locality | string |
Lokalizacja, taka jak miasto USA. |
|
|
Dystrykt administracyjny (stan)
|
adminDistrict | string |
Poddział, taki jak skrót stanu USA (np. WA). |
|
|
Kod pocztowy
|
postalCode | string |
Kod pocztowy lub pocztowy. |
|
|
Region kraju
|
countryRegion | string |
Kod kraju ISO 2-literowy (np. USA). |
|
|
Maksymalna liczba wyników
|
top | integer |
Maksymalna liczba wyników do zwrócenia (1–20). Wartość domyślna: 5. |
Zwraca
Pobieranie mapy statycznej (wersja zapoznawcza)
Pobierz obraz mapy statycznej wyśrodkowany w punkcie. Plik GIF nie jest obsługiwany; użyj formatu JPEG lub PNG.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Szerokość geograficzna środkowa
|
latitude | True | double |
Szerokość geograficzna środka mapy. Przykład: 47.64054 |
|
Długość geograficzna środkowa
|
longitude | True | double |
Długość geograficzna środka mapy. Przykład: -122.12934 |
|
Styl mapy
|
imagerySet | True | string |
Styl mapy do wyświetlenia. |
|
Poziom powiększenia
|
zoomLevel | True | string |
Poziom powiększenia z zakresu od 0 do 20. Domyślne: 10 |
|
Szerokość (piksele)
|
width | integer |
Szerokość obrazu wyjściowego w pikselach. Ustawienie domyślne: 512 |
|
|
Wysokość (piksele)
|
height | integer |
Wysokość obrazu wyjściowego w pikselach. Ustawienie domyślne: 512 |
|
|
Format obrazu
|
format | string |
Format obrazu. Ustawienie domyślne: png |
|
|
Szerokość geograficzna wypychania
|
pushpinLatitude | double |
Szerokość geograficzna wypychania. |
|
|
Długość geograficzna wypychania
|
pushpinLongitude | double |
Długość geograficzna wypychania. |
|
|
Etykieta wypychania
|
pushpinLabel | string |
Etykieta pushpin (maksymalnie 3 znaki). |
Zwraca
- response
- GetMap_Response
Pobieranie trasy (wersja zapoznawcza)
Obliczanie trasy jazdy lub chodzenia przy użyciu punktów drogi. Punkty drogi muszą być podane jako współrzędne szerokości geograficznej, długości geograficznej.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Punkt drogowy 1
|
wp.0 | True | string |
Początkowy punkt wyjścia jako szerokość geograficzna,długość geograficzna (np. 47.610,-122.107). |
|
Punkt drogowy 2
|
wp.1 | True | string |
Kończąc punkt drogi jako szerokość geograficzną,długość geograficzną (np. 47.612,-122.204). |
|
Tryb podróży
|
travelMode | string |
Tryb podróży dla trasy. |
|
|
Unikaj autostrad
|
avoid_highways | boolean |
Unika korzystania z autostrad w trasie. |
|
|
Unikanie opłat
|
avoid_tolls | boolean |
Unika korzystania z dróg płatnych na trasie. |
|
|
Unikaj promów
|
avoid_ferry | boolean |
Unika korzystania z promów na trasie. |
|
|
Unikanie przekraczania granic kraju
|
avoid_borderCrossing | boolean |
Unika przekraczania granic państwowych na trasie. |
|
|
Optimize
|
optimize | string |
Określa, co należy zoptymalizować trasę. |
Zwraca
- Body
- GetRoute_Response
Uzyskiwanie lokalizacji według punktu (wersja zapoznawcza)
Uzyskaj informacje o lokalizacji skojarzone ze współrzędnymi szerokości i długości geograficznej.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Szerokość geograficzna punktu
|
latitude | True | double |
Współrzędna szerokości geograficznej w celu odwrócenia kodu geograficznego. Przykład: 47.64054 |
|
Długość geograficzna punktu
|
longitude | True | double |
Współrzędna długości geograficznej w celu odwrócenia kodu geograficznego. Przykład: -122.12934 |
Zwraca
Definicje
GetRoute_Response
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Typ
|
type | string |
Typ GeoJSON (zawsze FeatureCollection). |
|
Features
|
features | array of object |
Tablica funkcji GeoJSON: Punkt drogi (początek/koniec), ManewrPoint (kroki turn-by-turn) i RoutePath (podsumowanie trasy). |
|
Typ funkcji
|
features.type | string | |
|
Geometry
|
features.geometry | object | |
|
Rodzaj funkcji
|
features.properties.type | string |
Rodzaj funkcji: Punkt drogi (punkty początkowe/końcowe), ManewrPoint (krok po kolei) lub RoutePath (podsumowanie ogólnej trasy). |
|
Odległość (mierniki)
|
features.properties.distanceInMeters | float |
Łączna odległość trasy w metrach. Funkcja RoutePath. |
|
Czas trwania (w sekundach)
|
features.properties.durationInSeconds | integer |
Szacowany czas podróży w sekundach (bez ruchu). Funkcja RoutePath. |
|
Opóźnienie ruchu (w sekundach)
|
features.properties.trafficDelayInSeconds | integer |
Dodatkowy czas w sekundach z powodu ruchu. Funkcja RoutePath. |
|
Korków
|
features.properties.trafficCongestion | string |
Poziom przeciążenia ruchu (np. niski, średni, wysoki). Funkcja RoutePath. |
|
Używane dane ruchu
|
features.properties.trafficDataUsed | string |
Typ używanych danych ruchu (np. Brak, Przepływ). Funkcja RoutePath. |
|
Odejście do
|
features.properties.departureAt | string |
Szacowany czas odlotu (ISO 8601). Funkcja RoutePath. |
|
Przyjazd do
|
features.properties.arrivalAt | string |
Szacowany czas przyjazdu (ISO 8601). Funkcja RoutePath. |
|
Tekst instrukcji
|
features.properties.instruction.text | string |
Czytelny dla człowieka tekst instrukcji (np. "Skręć w lewo na NE 8th St"). |
|
Typ manewru
|
features.properties.instruction.maneuverType | string |
Kod typu manewru (np. TurnLeft, TurnRight, Straight, ArriveFinish). |
|
Indeks punktu wyjścia
|
features.properties.order.inputIndex | integer |
Indeks odpowiedniego wejściowego punktu drogi (0 = początek, 1 = koniec). |
|
Indeks nogi
|
features.properties.order.legIndex | integer |
Indeks nogi trasy, do której należy ta funkcja. |
GetLocationByAddress_Response
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Typ
|
type | string |
Typ GeoJSON (zawsze FeatureCollection). |
|
Features
|
features | array of object |
Tablica funkcji lokalizacji z kodem geograficznym. |
|
Typ funkcji
|
features.type | string | |
|
Typ geometrii
|
features.geometry.type | string | |
|
Współrzędne
|
features.geometry.coordinates | array of double |
Współrzędne jako [długość geograficzna, szerokość geograficzna]. |
|
Rodzaj funkcji
|
features.properties.type | string |
Rodzaj funkcji: Adres lub Zapełnione Miejsce. |
|
Pewność
|
features.properties.confidence | string |
Poziom ufności dopasowania (Wysoki, Średni, Niski). |
|
Dopasowywanie kodów
|
features.properties.matchCodes | array of string |
Dopasuj kody (Dobre, Niejednoznaczne, Wyżej w Hierarchii). |
|
Linia adresu
|
features.properties.address.addressLine | string |
Linia adresowa ulicy. |
|
Lokalizacja (miasto)
|
features.properties.address.locality | string |
Miasto lub lokalizacja. |
|
Okręgi administracyjne
|
features.properties.address.adminDistricts | array of object |
Tablica okręgów administracyjnych (np. stan, powiat). |
|
Krótka nazwa
|
features.properties.address.adminDistricts.shortName | string | |
|
Nazwa
|
features.properties.address.adminDistricts.name | string | |
|
Kod pocztowy
|
features.properties.address.postalCode | string |
Kod pocztowy lub pocztowy. |
|
Region kraju
|
features.properties.address.countryRegion | string |
Nazwa kraju lub regionu. |
|
Sformatowany adres
|
features.properties.address.formattedAddress | string |
Ukończ sformatowany ciąg adresu. |
GetMap_Response
- Obraz mapy
- binary