Azure Haritalar (Önizleme)

Azure Haritalar eşleme, yönlendirme, coğrafi kodlama ve ters coğrafi kodlama için jeo-uzamsal API'ler sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Service Class Bölgeler
Copilot Studio Standard Aşağıdakiler dışında tüm Power Automate bölgeleri:
     - 21Vianet tarafından işletilen Çin Bulutu
Logic Apps Standard Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Standard Aşağıdakiler dışında tüm Power Apps bölgeleri:
     - 21Vianet tarafından işletilen Çin Bulutu
Power Automate Standard Aşağıdakiler dışında tüm Power Automate bölgeleri:
     - 21Vianet tarafından işletilen Çin Bulutu
Contact
İsim Microsoft
URL https://www.microsoft.com/
Bağlayıcı Meta Verileri
Publisher Microsoft
Web Sitesi https://azure.microsoft.com/products/azure-maps
Gizlilik ilkesi https://privacy.microsoft.com/privacystatement
Kategoriler Veri; Verimli -lik

Azure Haritalar Bağlayıcısı

Türü: Kodsuz | Katmanı: Standart | Durum: Önizleme

Azure Haritalar REST API aracılığıyla eşleme, yönlendirme, coğrafi kodlama ve ters coğrafi kodlama özellikleri sağlar. İstekler tamamen APIM ilkesiyle işlenir; bağlayıcı web uygulaması yoktur.

Authentication

API anahtarı kimlik doğrulaması. Bağlantılar için bir Azure Haritalar abonelik anahtarı gerekir.

Parametre Türü Zorunlu Description
subscription_key securestring Evet abonelik anahtarını Azure Haritalar

Anahtar, bağlantı belirtecinden ayıklanır ve ilke (CheckForToken / GetAuthHeaderValue) tarafından sorgu parametresi olarak subscription-key Azure Haritalar geçirilir.

Bulut Kullanılabilirliği

Bulut Available
Public Evet
Fairfax (GCC) Evet
GCC High Evet
DoD Evet

Eylemler

Yol alma — GetRoute

İki yol noktası arasında bir sürüş veya yürüyüş rotası hesaplayın. Yol noktaları koordinat çiftleri (latitude,longitude) olmalıdır. Adresler desteklenmez; önce Adrese göre konum al'ı kullanarak bunları coğrafi olarak kodlar.

Uç nokta (ilkeden sonra):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

İlke GET stili sorgu parametrelerini GeoJSON FeatureCollection POST gövdesine dönüştürür, koordinatları sırasıyla longitude,latitude çevirir ve değerleri Azure Haritalar eşdeğerleriyle eşler.

Parametre Zorunlu Türü Description
Waypoint 1 (wp.0) Evet String Başlangıç noktası olarak latitude,longitude (örn. 47.610,-122.107)
Waypoint 2 (wp.1) Evet String Bitiş noktası olarak latitude,longitude (ör. 47.612,-122.204)
Seyahat modu (travelMode) Hayır String driving (varsayılan) veya walking
Otoyollardan kaçının Hayır boolean Haritalar: avoid=limitedAccessHighways
Geçiş ücretinden kaçının Hayır boolean Haritalar: avoid=tollRoads
Feribotlardan kaçının Hayır boolean Haritalar: avoid=ferries
Ülke sınırlarını geçmekten kaçının Hayır boolean Haritalar: avoid=borderCrossings
Optimize Hayır String fastestWithoutTraffic, fastestWithTraffic veya shortest

Yanıt: Seyahat mesafesi (metre), süre (saniye), trafik içeren süre (saniye) ve rota bacak ayrıntıları ile yol özeti.

Not: Aktarım yönlendirmesi desteklenmez. Azure Haritalar Yol Tarifleri yalnızca ve'i walkingdesteklerdriving.

Adrese göre konum alma — GetLocationByAddress

Koordinatlar ve konum ayrıntıları için yapılandırılmış bir adresi coğrafi olarak kodla.

Bitiş noktası:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

Parametre Zorunlu Türü Description
Adres satırı (addressLine) Hayır String Sokak çizgisi (örn. 15595 NE 36th St)
Yerellik (locality) Hayır String Şehir (örn. Redmond)
Yönetici bölgesi (adminDistrict) Hayır String Eyalet kısaltması (örn. WA)
Posta kodu (postalCode) Hayır String Posta kodu (örn. 98052)
Ülke bölgesi (countryRegion) Hayır String ISO 2 harfli ülke kodu (örn. US)
En fazla sonuç (top) Hayır integer 1–20, varsayılan 5

Yanıt: GeoJSON FeatureCollection. Her özelliğin şunları vardır:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Mediumveya Low
  • properties.address— addressLine, locality, adminDistricts, postalCode, countryRegion (ve ISOile name nesne ),formattedAddress

Not: Azure Haritalar coğrafi kodlama Çin'deki adresleri desteklemez.

Konuma göre konum alma — GetLocationByPoint

Coğrafi kod enlem/boylam koordinatlarını bir adrese ters çevirin.

Uç nokta (ilkeden sonra):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

İlke, ayrı latitude ve longitude parametreleri sırasıyla sorgu parametresinde coordinateslongitude,latitude birleştirir.

Parametre Zorunlu Türü Description
Nokta enlemi (latitude) Evet double örneğin 47.64054
Nokta boylamı (longitude) Evet double örneğin -122.12934

Yanıt:Adrese göre konum al ()GetLocationByAddress_Response ile aynı şema.

Statik harita alma — GetMap

Bir noktaya ortalanmış statik bir harita görüntüsü alın.

Uç nokta (ilkeden sonra):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

İlke, enlem/boylamı () parametresiylelongitude,latitudecenter birleştirir, Azure Haritalar style değeriyle eşler imagerySet ve isteğe bağlı pushpin'i parametre pins olarak geçirir.

Parametre Zorunlu Türü Description
Orta enlem (latitude) Evet double örneğin 47.64054
Orta boylam (longitude) Evet double örneğin -122.12934
Harita stili (imagerySet) Evet String Aşağıda stil eşlemeye bakın
Yakınlaştırma düzeyi (zoomLevel) Evet String 0-20, varsayılan 10
Genişlik (piksel) Hayır integer Varsayılan 512
Yükseklik (piksel) Hayır integer Varsayılan 512
Resim biçimi Hayır String jpeg veya png (varsayılan png). GIF desteklenmez.
Rapt enlemi Hayır double Rapt konumu enlemi
Raptiye boylamı Hayır double Raptiye konum boylamı
Rapt etiketi Hayır String Kısa etiket metni

Görüntü kümesi eşlemesi:

imagerySet girdi Azure Haritalar style
Road main
Aerial satellite
AerialWithLabels satellite_road_labels
CanvasDark dark
CanvasLight road_shaded_relief
CanvasGray grayscale_light

Yanıt: İkili görüntü (image/jpeg veya image/png). Power Automate akışlarında yanıt gövdesi base64 kodludur. Görüntüyü görüntülemek veya kaydetmek için:

  • OneDrive/SharePoint kaydetmeden önce dönüştürmek için ifadeyi base64ToBinary() kullanın.
  • Satır içinde işlemek için BIR HTML tablosu veya Etiketle <img src="data:image/png;base64,{body/$content}">e-posta gönder eylemi kullanın.

İlke Notları

  • subscription-key ilke tarafından eklenir; arayandan hiçbir zaman geçirilmedi.
  • gelen x-ms-apim-tokens ve origin üst bilgileri çıkarılır.
  • Content-Type: application/json tüm görüntü olmayan isteklerde zorlanır; görüntü yanıtları gidende doğru image/* içerik türünü geri yükler.
  • GetRoute Basit bir sorgu parametresi isteğini GeoJSON gövdesine sahip bir POST'a dönüştürür; çağıranların gövdeyi kendilerinin oluşturması gerekmez.

Dosyalar

File Purpose
apiDefinition.swagger.json OpenAPI tanımı
Dağıtım/policies.xml APIM ilkesi
Dağıtım/PolicySourceCode.cs İlke C# mantığı
connector-config-internal.json Kimlik doğrulaması ve ortam yapılandırması
connector-config-cli.json Özellikler (actions)
connector-config-certification.json API adı (azuremaps) ve katmanı (Standart)
connector-config-metadata.json Sahiplik meta verileri

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılabilir

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim Türü Description Zorunlu
Abonelik Anahtarı securestring abonelik anahtarını Azure Haritalar True

Eylemler

Adrese göre konum alma (Önizleme)

Koordinatlarını ve konum ayrıntılarını almak için adresi coğrafi olarak kodla.
Konuma göre konum alma (Önizleme)

Enlem ve boylam koordinatlarıyla ilişkili konum bilgilerini alın.
Statik harita alma (Önizleme)

Bir noktaya ortalanmış statik bir harita görüntüsü alın. GIF desteklenmez; JPEG veya PNG kullanın.
Yol alma (Önizleme)

Yol noktalarını kullanarak bir sürüş veya yürüyüş yolu hesaplayın. Yol noktaları enlem, boylam koordinatları olarak sağlanmalıdır.

Adrese göre konum alma (Önizleme)

İşlem Kimliği:
GetLocationByAddress

Koordinatlarını ve konum ayrıntılarını almak için adresi coğrafi olarak kodla.

Parametreler

Name Anahtar Gerekli Tür Description
Adres satırı
 addressLine string

Adresin sokak satırı (şehir, eyalet vb. dahil değildir).
Yerellik (Şehir)
 locality string

Abd şehri gibi yerellik.
Yönetim bölgesi (Eyalet)
 adminDistrict string

ABD eyalet kısaltması (örn. WA) gibi bir alt bölüm.
Posta kodu
 postalCode string

Posta veya posta kodu.
Ülke bölgesi
 countryRegion string

ISO 2 harfli ülke kodu (örn. ABD).
En fazla sonuç
 top integer

Döndürülecek en fazla sonuç sayısı (1-20). Varsayılan: 5.

Döndürülenler

Body
GetLocationByAddress_Response

Konuma göre konum alma (Önizleme)

İşlem Kimliği:
GetLocationByPoint

Enlem ve boylam koordinatlarıyla ilişkili konum bilgilerini alın.

Parametreler

Name Anahtar Gerekli Tür Description
Nokta enlemi
 latitude True double

Coğrafi kodu ters çevirmek için enlem koordinatı. Örnek: 47.64054
Nokta boylamı
 longitude True double

Coğrafi kodu tersine çevirmek için boylam koordinatı. Örnek: -122.12934

Döndürülenler

Body
GetLocationByAddress_Response

Statik harita alma (Önizleme)

İşlem Kimliği:
GetMap

Bir noktaya ortalanmış statik bir harita görüntüsü alın. GIF desteklenmez; JPEG veya PNG kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
Orta enlem
 latitude True double

Harita merkezinin enlemi. Örnek: 47.64054
Orta boylam
 longitude True double

Harita merkezinin boylamı. Örnek: -122.12934
Harita stili
 imagerySet True string

Görüntülenecek harita stili.
Yakınlaştırma düzeyi
 zoomLevel True string

0 ile 20 arasındaki yakınlaştırma düzeyi. Varsayılan: 10
Genişlik (piksel)
 width integer

Çıktı görüntüsünün piksel cinsinden genişliği. Varsayılan: 512
Yükseklik (piksel)
 height integer

Çıktı görüntüsünün piksel cinsinden yüksekliği. Varsayılan: 512
Resim biçimi
 format string

Görüntü biçimi. Varsayılan: png
Rapt enlemi
 pushpinLatitude double

Rapt enlemi.
Raptiye boylamı
 pushpinLongitude double

Raptiye boylamı.
Rapt etiketi
 pushpinLabel string

Rapt etiketi (en fazla 3 karakter).

Döndürülenler

response
GetMap_Response

Yol alma (Önizleme)

İşlem Kimliği:
GetRoute

Yol noktalarını kullanarak bir sürüş veya yürüyüş yolu hesaplayın. Yol noktaları enlem, boylam koordinatları olarak sağlanmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Waypoint 1
 wp.0 True string

Enlem,boylam olarak başlangıç noktası (ör. 47.610,-122.107).
Waypoint 2
 wp.1 True string

Enlem,boylam olarak bitiş noktası (ör. 47.612,-122.204).
Seyahat modu
 travelMode string

Rota için seyahat modu.
Otoyollardan kaçının
 avoid_highways boolean

Otoyolların rotada kullanılmasını önler.
Geçiş ücretinden kaçının
 avoid_tolls boolean

Rotada ücretli yolların kullanılmasını önler.
Feribotlardan kaçının
 avoid_ferry boolean

Rotada feribot kullanımını önler.
Ülke sınırlarını geçmekten kaçının
 avoid_borderCrossing boolean

Rotada ülke sınırlarının aşılmasını önler.
Optimize
 optimize string

Rotanın ne için en iyi duruma getirilmiş olduğunu belirtir.

Döndürülenler

Body
GetRoute_Response

Tanımlar

GetRoute_Response

Name Yol Tür Description
Türü
 type string

GeoJSON türü (her zaman FeatureCollection).
Özellikler
 features array of object

GeoJSON özellikleri dizisi: Waypoint (başlangıç/bitiş), ManeuverPoint (adım adım adım) ve RoutePath (yol özeti).
Özellik Türü
 features.type string
Geometry
 features.geometry object
Özellik Türü
 features.properties.type string

Özellik türü: Waypoint (başlangıç/bitiş noktaları), Manevra Noktası (adım adım) veya RoutePath (genel yol özeti).
Mesafe (metre)
 features.properties.distanceInMeters float

Metre olarak toplam rota uzaklığı. RoutePath özelliklerinde mevcut.
Süre (saniye)
 features.properties.durationInSeconds integer

Saniye cinsinden tahmini seyahat süresi (trafik olmadan). RoutePath özelliklerinde mevcut.
Trafik Gecikmesi (saniye)
 features.properties.trafficDelayInSeconds integer

Trafik nedeniyle saniyeler içinde ek süre. RoutePath özelliklerinde mevcut.
Trafik Tıkanıklığı
 features.properties.trafficCongestion string

Trafik tıkanıklığı düzeyi (örneğin, Düşük, Orta, Yüksek). RoutePath özelliklerinde mevcut.
Kullanılan Trafik Verileri
 features.properties.trafficDataUsed string

Kullanılan trafik verilerinin türü (ör. Yok, Akış). RoutePath özelliklerinde mevcut.
Kalkış Saati
 features.properties.departureAt string

Tahmini kalkış saati (ISO 8601). RoutePath özelliklerinde mevcut.
Varış:
 features.properties.arrivalAt string

Tahmini varış zamanı (ISO 8601). RoutePath özelliklerinde mevcut.
Yönerge Metni
 features.properties.instruction.text string

İnsan tarafından okunabilen yönerge metni (ör. 'NE 8. St'a sola dön').
Manevra Türü
 features.properties.instruction.maneuverType string

Manevra türü kodu (örn. TurnLeft, TurnRight, Straight, ArriveFinish).
Waypoint Dizini
 features.properties.order.inputIndex integer

İlgili giriş yol noktasının dizini (0 = başlangıç, 1 = bitiş).
Bacak Dizini
 features.properties.order.legIndex integer

Bu özelliğin ait olduğu rota bacağının dizini.

GetLocationByAddress_Response

Name Yol Tür Description
Türü
 type string

GeoJSON türü (her zaman FeatureCollection).
Özellikler
 features array of object

Coğrafi olarak kodlanmış konum özellikleri dizisi.
Özellik Türü
 features.type string
Geometri Türü
 features.geometry.type string
Koordinatlar
 features.geometry.coordinates array of double

[boylam, enlem] olarak koordinatlar.
Özellik Türü
 features.properties.type string

Özellik türü: Adres veya PopulatedPlace.
Güven
 features.properties.confidence string

Eşleşmenin güvenilirlik düzeyi (Yüksek, Orta, Düşük).
Eşleştirme Kodları
 features.properties.matchCodes array of string

Eşleştirme kodları (Good, Ambiguous, UpHierarchy).
Adres Satırı
 features.properties.address.addressLine string

Sokak adresi satırı.
Yerellik (Şehir)
 features.properties.address.locality string

Şehir veya bölge.
Yönetici Bölgeleri
 features.properties.address.adminDistricts array of object

Yönetim bölgelerinin dizisi (örn. eyalet, ilçe).
Kısa Ad
 features.properties.address.adminDistricts.shortName string
İsim
 features.properties.address.adminDistricts.name string
Posta Kodu
 features.properties.address.postalCode string

Posta veya posta kodu.
Ülke Bölgesi
 features.properties.address.countryRegion string

Ülke veya bölge adı.
Biçimlendirilmiş Adres
 features.properties.address.formattedAddress string

Biçimlendirilmiş adres dizesini tamamlayın.

GetMap_Response

Harita Resmi
binary