Render - Get Map Static Image

Hizmet:

Maps

API Sürümü:

2024-04-01

Bu işleme API'si, kullanıcı tanımlı bir alanın statik, rasterleştirilmiş harita görünümlerini oluşturur. İstenen kullanıcı deneyimi etkileşimli harita denetimleri gerektirmediğinde veya bant genişliği sınırlı olduğunda basit web uygulamaları için uygundur. Bu API, haritaları tarayıcı dışındaki uygulamalara, arka uç hizmetlerine, rapor oluşturma veya masaüstü uygulamalarına eklemek için de kullanışlıdır.

Bu API, temel veri görselleştirme parametreleri içerir:

• Birden çok stilde etiketlenmiş raptler.
• Daire, yol ve çokgen geometri türlerini işleme.

Daha fazla bilgi ve ayrıntılı örnekler için bkz. Raster eşlemesinde özel verileri işleme.

Bbox parametresinin boyutları, yakınlaştırma düzeyine bağlı olarak kısıtlanır. Bu, sonuçta elde edilen görüntünün uygun bir ayrıntı düzeyine sahip olmasını sağlar.

Yakınlaştırma Düzeyi	Min Lon Aralığı	Maksimum Lon Aralığı	Min Lat Aralığı	Maksimum Lat Aralığı
0	56.25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

Not: API'ye merkezi veya bbox parametresi sağlanmalıdır.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

İsteğe bağlı parametrelerle:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	Azure Maps API-nin sürüm numarası. Geçerli sürüm 2024-04-01'dir.
bbox	query		number[]	Sınırlayıcı kutu, Dünya'da dikdörtgen bir alanın dört tarafını temsil eden iki enlem ve iki boylam ile tanımlanır. Biçim: 'minLon, minLat, maxLon, maxLat' (çift). Not: Bbox veya center gerekli parametrelerdir. Bunlar birbirini dışlar. bbox yükseklik veya genişlikle kullanılmamalıdır. Lat ve Lon için izin verilen en büyük ve en düşük aralıklar, bu sayfanın en üstündeki tablodaki her yakınlaştırma düzeyi için tanımlanır.
center	query		number[]	Merkez noktasının koordinatları çift. Biçim: 'lon,lat'. Boylam aralığı: 180'e -180. Enlem aralığı: 90'a -90. Not: Orta veya bbox gerekli parametrelerdir. Bunlar birbirini dışlar.
height	query		integer (int32) minimum: 80 maximum: 1500	Elde edilen görüntünün piksel cinsinden yüksekliği. 80 ile 1500 arasında değişir. Varsayılan değer 512'dir. Bbox ile kullanılmamalıdır.
language	query		string	Arama sonuçlarının döndürülmesi gereken dil. Desteklenen IETF dil etiketlerinden biri olmalıdır ve büyük/küçük harfe duyarsız olmalıdır. Belirtilen dildeki veriler belirli bir alan için kullanılabilir olmadığında, varsayılan dil kullanılır. Ayrıntılar için lütfen Desteklenen Diller bakın.
path	query		string[]	Yol stili ve konumları (çift olarak). İsteğe bağlı olarak resme çizgi, çokgen veya daire eklemek için bu parametreyi kullanın. Yol stili, çizginin ve dolgunun görünümünü açıklar. (Kanallar ve noktalama işaretleri gibi ayrılmış karakterler içereceğinden bu parametrenin URL kodlama değerlerini düzgün bir şekilde kodlamayı unutmayın.) Path parametresi, S1 ile başlayan Azure Maps account SKU'da desteklenmektedir. Path parametresinin birden çok örneği, stilleriyle birden çok geometri belirtmeye olanak tanır. İstek başına parametre sayısı 10, konum sayısı ise yol başına 100 ile sınırlıdır. Varsayılan stili kullanarak yarıçapı 100 metre ve orta noktası enlem 45°N ve boylam 122°W olan bir daireyi işlemek için querystring parametresini ekleyin path=ra100||-122 45 Boylam enlemden önce gelir. URL kodlamadan sonra bu, path=ra100%7C%7C-122+45 Buradaki örneklerin tümü netlik için URL kodlaması olmadan yol parametresini gösterir. Bir çizgiyi işlemek için her konumu bir kanal karakteriyle ayırın. Örneğin, path=||-122 45|-119.5 43.2|-121.67 47.12 İlk ve son noktaların eşit olduğu kapalı bir yol ile çokgen belirtilir. Örneğin, path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Çizgilerin ve çokgenlerin konumları için boylam değeri, -360 ile 360 arasında olabilir ve anti meridyenden geçen geometrilerin işlenmesine olanak tanıyabilir. Stil Değiştiriciler Stil değiştiricileri ekleyerek yolun görünümünü değiştirebilirsiniz. Bunlar konumlardan önce eklenir. Stil değiştiricilerin her biri iki harfli bir ada sahiptir. Bu kısaltılmış adlar, URL'nin uzunluğunu azaltmaya yardımcı olmak için kullanılır. Ana hattın rengini değiştirmek için 'lc' stili değiştiriciyi kullanın ve altı basamaklı onaltılık bir sayı olan HTML/CSS RGB renk biçimini kullanarak rengi belirtin (üç basamaklı form desteklenmez). Örneğin, CSS'de #FF1493 olarak belirteceğiniz koyu pembe bir renk kullanmak için path=lcFF1493||-122 45|-119.5 43.2 Daha karmaşık bir görsel stil oluşturmak için birden çok stil değiştirici birleştirilebilir. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Stil Değiştirici Özeti Değiştirici Açıklama Türü Aralık Lc Çizgi rengi String 000000-FFFFFF fc Dolgu rengi String 000000-FFFFFF la Alfa çizgisi (opaklık) yüzmek 0 - 1 fa Alfa doldurma (opaklık) yüzmek 0 - 1 Lw Çizgi genişliği int32 (0, 50] Ra Daire yarıçapı (metre) yüzmek 0'dan büyük
pins	query		string[]	Pushpin stili ve örnekleri. İsteğe bağlı olarak görüntüye raptler eklemek için bu parametreyi kullanın. Raptiye stili, raptiyelerin görünümünü açıklar ve örnekler her raptiye için raptiyelerin koordinatlarını (çift) ve isteğe bağlı etiketleri belirtir. (Kanallar ve noktalama işaretleri gibi ayrılmış karakterler içereceğinden bu parametrenin URL kodlama değerlerini düzgün bir şekilde kodlamayı unutmayın.) Azure Maps hesabı S0 SKU, pin parametresinin yalnızca tek bir örneğini destekler ve her pin başına 5 konum sayısı ile sınırlıdır. Diğer SKU'lar, pinler parametresinin 25 örneğine kadar birden çok pin stili belirtmesine olanak tanır ve konum sayısı pin başına 50 ile sınırlıdır. Varsayılan yerleşik raptiye stilini kullanarak 45°N enlem ve boylam 122°W'de bir raptiye işlemek için querystring parametresini ekleyin pins=default||-122 45 Boylam enlemden önce gelir. URL kodlamadan sonra bu, pins=default%7C%7C-122+45 Buradaki tüm örnekler netlik için URL kodlaması olmadan pins parametresini gösterir. Pini birden çok konumda işlemek için her konumu bir boru karakteriyle ayırın. Örneğin, pins=default||-122 45|-119.5 43.2|-121.67 47.12 S0 Azure Maps hesabı SKU'su sadece beş pushpin'e izin verir. Diğer hesap SKU'larında bu sınırlama yoktur. Stil Değiştiriciler Stil değiştiricileri ekleyerek raptiyelerin görünümünü değiştirebilirsiniz. Bunlar stilden sonra ancak konumlardan ve etiketlerden önce eklenir. Stil değiştiricilerin her biri iki harfli bir ada sahiptir. Bu kısaltılmış adlar, URL'nin uzunluğunu azaltmaya yardımcı olmak için kullanılır. Rapkenin rengini değiştirmek için 'co' stili değiştiriciyi kullanın ve altı basamaklı onaltılık bir sayı olan HTML/CSS RGB renk biçimini kullanarak rengi belirtin (üç basamaklı form desteklenmez). Örneğin, CSS'de #FF1493 olarak belirteceğiniz koyu pembe bir renk kullanmak için pins=default|coFF1493||-122 45 Rapte Etiketleri Raptiyelere etiket eklemek için, etiketi koordinatların hemen önüne tek tırnak içine koyun. Etikette | veya || gibi özel karakterler kullanmaktan kaçının. Örneğin, üç raptiyeyi '1', '2' ve '3' değerleriyle etiketlemek için pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Rapt görüntüsü görüntülemeyen 'none' adlı yerleşik bir pushpin stili vardır. Etiketleri herhangi bir raptiye görüntüsü olmadan görüntülemek istiyorsanız bunu kullanabilirsiniz. Örneğin pins=none||'A'-122 45|'B'-119.5 43.2 Raptçi etiketlerinin rengini değiştirmek için 'lc' etiket rengi stili değiştiricisini kullanın. Örneğin, siyah etiketlerle pembe raptler kullanmak için pins=default|coFF1493|lc000000||-122 45 Etiketlerin boyutunu değiştirmek için 'ls' etiket boyutu stil değiştiricisini kullanın. Etiket boyutu, etiket metninin piksel cinsinden yaklaşık yüksekliğini temsil eder. Örneğin, etiket boyutunu 12'ye yükseltmek için pins=default|ls12||'A'-122 45|'B'-119 43 Etiketler, 'etiket tutturucu' raptesinde ortalanır. Yer işareti konumu yerleşik raptler için önceden tanımlanmıştır ve özel raptlerin üst merkezindedir (aşağıya bakın). Etiket tutturucuyu geçersiz kılmak için ,'la' stili değiştiriciyi kullanarak yer işareti için X ve Y piksel koordinatları sağlayın. Bu koordinatlar, pushpin görüntüsünün sol üst köşesine göredir. Pozitif X değerleri tutturucuyu sağa, pozitif Y değerleri ise tutturucuyu aşağı taşır. Örneğin, etiket tutturucuyu 10 piksel sağa ve 4 pikseli pushpin görüntüsünün sol üst köşesine konumlandırmak için pins=default|la10 -4||'A'-122 45|'B'-119 43 Özel Raptler Özel bir raptiye görüntüsü kullanmak için raptiye stili adı olarak 'custom' sözcüğünü kullanın ve ardından konum ve etiket bilgilerinden sonra bir URL belirtin. Özelleştirilmiş etiket resmi için izin verilen en büyük boyut 65.536 pikseldir. Konum belirtme işlemini tamamladığınızı ve URL'yi başlatdığınızı belirtmek için iki kanal karakteri kullanın. Örneğin pins=custom||-122 45||http://contoso.com/pushpins/red.png URL kodlamadan sonra, bu şuna benzer olacaktır: pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Varsayılan olarak, özel raptiye görüntüleri raptiye koordinatlarında ortalanır. Vurgulamaya çalıştığınız konumu gizlediğinden bu genellikle ideal değildir. Pin görüntüsünün tutturucu konumunu geçersiz kılmak için 'an' stil değiştiricisini kullanın. Bu, 'la' etiket tutturucu stili değiştirici ile aynı biçimi kullanır. Örneğin, özel pin görüntünüzde görüntünün sol üst köşesinde raptiyenin ucu varsa, bağlantı noktasını bu noktaya ayarlamak için pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Not: 'co' renk değiştiricisini özel bir raptiye görüntüsüyle kullanırsanız, belirtilen renk görüntüdeki piksellerin RGB kanallarının yerini alır ancak alfa (opaklık) kanalını değiştirmeden bırakır. Bu genellikle yalnızca düz renkli bir özel görüntüyle yapılır. Ölçeklendirme, Döndürme ve Opaklık 'sc' ölçek stili değiştiricisini kullanarak raptleri ve bunların etiketlerini büyütebilir veya küçültebilirsiniz. Bu, sıfırdan büyük bir değerdir. 1 değeri standart ölçektir. 1'den büyük değerler raptiyeleri büyütür ve 1'den küçük değerler bunları küçültür. Örneğin, 50% normalden büyük raptleri çizmek için pins=default|sc1.5||-122 45 'ro' döndürme stili değiştiricisini kullanarak raptleri ve etiketlerini döndürebilirsiniz. Bu, saat yönünde döndürmenin bir dizi derecesidir. Saat yönünün tersine döndürmek için negatif bir sayı kullanın. Örneğin, rapteleri saat yönünde 90 derece döndürmek ve boyutlarını iki katına getirmek için pins=default|ro90|sc2||-122 45 'al' alfa stili değiştiriciyi belirterek raptleri ve etiketlerini kısmen saydam hale getirebilirsiniz. Bu, raptiyelerin opaklığını gösteren 0 ile 1 arasında bir sayıdır. Sıfır, bunları tamamen saydam (görünür değil) ve 1 ise tamamen opak (varsayılan değerdir) yapar. Örneğin, raptleri ve etiketlerini yalnızca 67% opak yapmak için pins=default|al.67||-122 45 Stil Değiştirici Özeti Değiştirici Açıklama Türü Aralık al Alfa (opaklık) yüzmek 0 - 1 an Sabit tutturucu <int32, int32> * "ko" Raptiye rengi String 000000-FFFFFF la Etiket tutturucu <int32, int32> * Lc Etiket rengi String 000000-FFFFFF Ls Etiket boyutu yüzmek 0'dan büyük ro Rotasyon yüzmek -360 - 360 sc Ölçek yüzmek 0'dan büyük X ve Y koordinatları raptiye görüntüsünün içinde herhangi bir yerde veya çevresinde bir kenar boşluğu olabilir. Kenar boşluğu boyutu, raptiye genişliği ve yüksekliğinin en küçük değeridir.
tilesetId	query		TilesetId	Döndürülecek eşleme stili. Olası değerler: microsoft.base.road, microsoft.base.darkgrey ve microsoft.imagery. Varsayılan değer microsoft.base.road olarak ayarlanır. Daha fazla bilgi için bkz. TilesetId İşleme.
trafficLayer	query		TrafficTilesetId	İsteğe Bağlı Değer, görüntü sonucunda hiçbir trafik akışının üzerine geçmediğini gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer hiçbiridir ve hiçbir trafik akışının döndürülmediğini gösterir. Trafikle ilgili tilesetId sağlanırsa ilgili trafik katmanına sahip harita görüntüsü döndürülecektir. Daha fazla bilgi için bkz. TilesetId İşleme.
view	query		LocalizedMapView	View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve View parametresi uygulamanızın uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uymasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Maps'teki View parametresi, haritalar, görseller ve diğer verilerin ve Azure Maps üzerinden erişime yetkilendirildiğiniz üçüncü taraf içeriklerin sunulduğu ülke/bölge dahil olmak üzere geçerli yasalara uygun şekilde kullanılmalıdır. Örnek: view=IN. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler bakın.
width	query		integer (int32) minimum: 80 maximum: 2000	Elde edilen görüntünün piksel cinsinden genişliği. 80 ile 2000 arasında bir aralık. Varsayılan değer 512'dir. Bbox ile kullanılmamalıdır.
zoom	query		integer (int32) minimum: 0 maximum: 20	Haritanın istenen yakınlaştırma düzeyi. microsoft.base.road veya microsoft.base.darkgrey olan tilesetId için 0-20 (dahil) arasında yakınlaştırma değeri aralığını destekler. microsoft.imagery olan tilesetId için 0-19 (dahil) arasında yakınlaştırma değeri aralığını destekler. Varsayılan değer 12'dir. Daha fazla bilgi için bkz. Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Microsoft Entra ID güvenlik modeliyle kullanılmak üzere tasarlanmış hesabı gösterir. Azure Maps hesabı için bu benzersiz ID, Azure Maps yönetim düzlemi Hesap API'dan alınabilir. Azure Maps'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Maps içinde yönetin.
Accept		MediaType	Accept header (Kabul Et başlığı) alanı, yanıt ortamı türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen ortam türleri arasında image/jpeg ve image/png bulunur. Accept header (Başlığı kabul et) belirtilmemişse resmi image/png biçiminde döndürün.

Yanıtlar

Name	Tür	Description
200 OK	object	Bu görüntü, başarılı bir Harita Statik Görüntüsünü Al çağrısından döndürülür. Media Types: "image/jpeg", "image/png" Üst Bilgiler Content-Type: string
Other Status Codes	ErrorResponse	Beklenmeyen bir hata oluştu. Media Types: "image/jpeg", "image/png"

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Maps REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Maps kaynak hesabına veya alt kaynağa erişim belirlemek için kullanılır. Herhangi bir kullanıcı, grup veya hizmet prensibi, Azure Maps REST API'lerine bir veya daha fazla izinten oluşan yerleşik bir rol veya özel bir rol aracılığıyla erişim sağlanabilir.

Senaryoları uygulamak içinkimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.

Notes

• Bu güvenlik tanımı c0 uygulamanın hangi Azure Maps kaynağa erişim talep ettiğini belirtmek için x-ms-client-id başlığının kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.

Authorization URL Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir. * Azure rol tabanlı erişim kontrolü, Azure yönetim düzleminden Azure portal, PowerShell, CLI, Azure SDKs veya REST API'leri aracılığıyla yapılandırılır. * Azure Maps Web SDK birden fazla kullanım durumu için bir uygulamanın yapılandırma tabanlı kurulumuna olanak tanır.

• Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portal, PowerShell, CLI, Azure SDKs veya REST API'leri aracılığıyla Azure yönetim düzlemi üzerinden Azure Maps kaynağı oluşturulduğunda sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lerine erişim yetkisine sahip olur. Başka bir deyişle, bunlar şu anda verildikleri hesabın ana anahtarları olarak değerlendirilebilir.

Halka açık uygulamalar için, Azure Maps REST API'lerinin sunucudan sunucuya erişimini kullanmamız ve bu anahtarın güvenli şekilde saklanabilmesini öneriyoruz.

Tür: apiKey
İçinde: header

SAS Token

Bu, Azure Maps kaynak üzerindeki List SAS işleminden Azure portal, PowerShell, CLI, Azure SDKs veya REST API'leri aracılığıyla Azure yönetim düzlemi üzerinden oluşturulan paylaşılan erişim imza belirtechosudur.

Bu token ile, herhangi bir uygulama, belirli belirtetör için son kullanma süresi, oranı ve kullanım bölgesi(ler)ine Azure rol tabanlı erişim kontrolleri ve ince taneli kontrol ile erişim yetkilendirilir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

Successful Static Image Request

Örnek isteği

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Örnek yanıt

Durum kodu:

200

Content-Type: image/png

"{file}"

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
LocalizedMapView	View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve View parametresi uygulamanızın uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uymasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Maps'teki View parametresi, haritalar, görseller ve diğer verilerin ve Azure Maps üzerinden erişime yetkilendirildiğiniz üçüncü taraf içeriklerin sunulduğu ülke/bölge dahil olmak üzere geçerli yasalara uygun şekilde kullanılmalıdır. Örnek: view=IN. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler bakın.
MediaType	Accept header (Kabul Et başlığı) alanı, yanıt ortamı türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen ortam türleri arasında image/jpeg ve image/png bulunur. Accept header (Başlığı kabul et) belirtilmemişse resmi image/png biçiminde döndürün.
TilesetId	Döndürülecek eşleme stili. Olası değerler: microsoft.base.road, microsoft.base.darkgrey ve microsoft.imagery. Varsayılan değer microsoft.base.road olarak ayarlanır. Daha fazla bilgi için bkz. TilesetId İşleme.
TrafficTilesetId	İsteğe Bağlı Değer, görüntü sonucunda hiçbir trafik akışının üzerine geçmediğini gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer hiçbiridir ve hiçbir trafik akışının döndürülmediğini gösterir. Trafikle ilgili tilesetId sağlanırsa ilgili trafik katmanına sahip harita görüntüsü döndürülecektir. Daha fazla bilgi için bkz. TilesetId İşleme.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

LocalizedMapView

Numaralandırma

View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve View parametresi uygulamanızın uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uymasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Maps'teki View parametresi, haritalar, görseller ve diğer verilerin ve Azure Maps üzerinden erişime yetkilendirildiğiniz üçüncü taraf içeriklerin sunulduğu ülke/bölge dahil olmak üzere geçerli yasalara uygun şekilde kullanılmalıdır. Örnek: view=IN.

Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler bakın.

Değer	Description
AE	Birleşik Arap Emirlikleri (Arap Görünümü)
AR	Arjantin (Arjantin Görünümü)
BH	Bahreyn (Arapça Görünümü)
IN	Hindistan (Hindistan Görünümü)
IQ	Irak (Arapça Görünümü)
JO	Ürdün (Arapça Görünümü)
KW	Kuveyt (Arapça Görünümü)
LB	Lübnan (Arapça Görünümü)
MA	Fas (Fas Görünümü)
OM	Umman (Arapça Görünümü)
PK	Pakistan (Pakistan Görünümü)
PS	Filistin Yönetimi (Arap Görüşü)
QA	Katar (Arapça Görünümü)
SA	Suudi Arabistan (Arapça Görünümü)
SY	Suriye (Arapça Görünümü)
US	United States of America
YE	Yemen (Arapça Görünümü)
Auto	harita verilerini isteğin IP adresine göre döndürür.
Unified	Birleşik Görünüm (Diğerleri)

MediaType

Numaralandırma

Accept header (Kabul Et başlığı) alanı, yanıt ortamı türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen ortam türleri arasında image/jpeg ve image/png bulunur. Accept header (Başlığı kabul et) belirtilmemişse resmi image/png biçiminde döndürün.

Değer	Description
image/png	Görüntüyü png formatında döndürün.
image/jpeg	Görüntüyü jpeg formatında döndürün.

TilesetId

Numaralandırma

Döndürülecek eşleme stili. Olası değerler: microsoft.base.road, microsoft.base.darkgrey ve microsoft.imagery. Varsayılan değer microsoft.base.road olarak ayarlanır. Daha fazla bilgi için bkz. TilesetId İşleme.

Değer	Description
microsoft.base.road	TilesetId, oluşturma ana stiline sahip tüm katmanları içerir.
microsoft.base.darkgrey	TilesetId, koyu gri stilimiz ile tüm katmanları içerir.
microsoft.imagery	TilesetId, uydu ve hava görüntülerinin bir birleşimini içerir.

TrafficTilesetId

Numaralandırma

İsteğe Bağlı Değer, görüntü sonucunda hiçbir trafik akışının üzerine geçmediğini gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer hiçbiridir ve hiçbir trafik akışının döndürülmediğini gösterir. Trafikle ilgili tilesetId sağlanırsa ilgili trafik katmanına sahip harita görüntüsü döndürülecektir. Daha fazla bilgi için bkz. TilesetId İşleme.

Değer	Description
microsoft.traffic.relative.main	Desteklenen trafikle ilgili tilesetId.
none	Varsayılan değer, trafik akışı katmanı yok.