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 ayrıca 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 için parametreler içerir:

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

Daha fazla bilgi ve ayrıntılı örnekler için bkz . Tarama haritasında ö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 orta 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 Haritalar API'sinin sürüm numarası. Geçerli sürüm: 2024-04-01.
bbox	query		number[]	Sınırlayıcı kutu, dünya üzerindeki 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şlik ile kullanılmamalıdır. Lat ve Lon için izin verilen maksimum ve en düşük aralıklar, bu sayfanın en üstündeki tabloda yer alan 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 ila 180. Enlem aralığı: -90 ila 90. Not: Orta veya bbox gerekli parametrelerdir. Bunlar birbirini dışlar.
height	query		integer int32	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. Büyük/küçük harfe duyarsız, desteklenen IETF dil etiketlerinden biri 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'e bakın.
path	query		string[]	Yol stili ve konumlar (çift). İsteğe bağlı olarak resme çizgiler, çokgenler veya daireler 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 yazdığınızdan emin olun.) Path parametresi, S1'den başlayarak Azure Haritalar hesabı SKU'sunda desteklenir. Path parametresinin birden çok örneği, stilleriyle birden çok geometri belirtmeye olanak tanır. İstek başına parametre sayısı 10 ile, konum sayısı ise yol başına 100 ile sınırlıdır. Varsayılan stili kullanarak yarıçapı 100 metre ve merkez 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 şuna benzer olacaktır: path=ra100%7C%7C-122+45 Buradaki tüm örnekler netlik için URL kodlaması olmadan yol parametresini gösterir. Bir çizgiyi işlemek için her konumu bir boru 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 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 'a FFFFFF Fc Dolgu rengi string 000000 'a FFFFFF La Alfa çizgi (opaklık) float 0 - 1 Fa Dolgu alfa (opaklık) float 0 - 1 Lw Çizgi genişliği int32 (0, 50] Ra Daire yarıçapı (metre) float 0'dan büyük
pins	query		string[]	Rapt stili ve örnekler. İ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 (çift) ve isteğe bağlı etiketlerin koordinatlarını belirtir. (Kanallar ve noktalama işaretleri gibi ayrılmış karakterler içereceğinden bu parametrenin URL kodlama değerlerini düzgün bir şekilde yazdığınızdan emin olun.) Azure Haritalar hesabı S0 SKU'su, pins parametresinin yalnızca tek bir örneğini destekler. Diğer SKU'lar, pinler parametresinin birden çok örneğinin birden çok pin stili belirtmesine izin verir. Varsayılan yerleşik raptiye stilini kullanarak 45°N enlem ve 122°W boylamında bir raptiye işlemek için querystring parametresini ekleyin pins=default||-122 45 Boylam enlemden önce gelir. URL kodlamadan sonra bu şuna benzer olacaktır: pins=default%7C%7C-122+45 Buradaki örneklerin tümü netlik için URL kodlaması olmadan pins parametresini gösterir. Raptiyeyi birden çok konumda işlemek için her konumu bir kanal karakteriyle ayırın. Örneğin, pins=default||-122 45|-119.5 43.2|-121.67 47.12 S0 Azure Haritalar hesabı SKU'su yalnızca beş rapteye 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. Pushpin 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 Rapt Etiketleri Raptiyelere etiket eklemek için, etiketi koordinatlardan hemen önce tek tırnak içine alın. veya || etiketinde gibi | özel bir karakter 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 'none' adlı yerleşik bir raptpin stili vardır ve bu stilde rapt görüntüsü görüntülenmez. 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 etiketlerinin rengini değiştirmek için 'lc' etiket renk 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' raptahında 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 bilgisinden sonra bir URL belirtin. Özelleştirilmiş etiket resmi için izin verilen boyut üst sınırı 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 şöyle görünü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, kullanarak tutturucuyu bu noktaya ayarlayabilirsiniz 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çek, Döndürme ve Opaklık 'sc' ölçek stili değiştiricisini kullanarak raptleri ve etiketlerini daha büyük veya daha küçük hale getirebilirsiniz. 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, raptleri normalden %50 daha büyük ç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, raptleri 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 donuk (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) float 0 - 1 a Sabitleyiciyi sabitle <int32, int32> * co Raptiye rengi string 000000 'a FFFFFF La Etiket tutturucu <int32, int32> * Lc Etiket rengi string 000000 'a FFFFFF ls Etiket boyutu float 0'dan büyük Ro Döndürme float -360 - 360 Sc Ölçek float 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ğinin 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 yer paylaşımlı olmadığını gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer yok, hiçbir trafik akışı döndürülmedi. 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 Görünüm 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' seçeneğini ayarlayabilirsiniz. Azure Haritalar'daki View parametresi haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar aracılığıyla erişim yetkisine sahip olduğunuz üçüncü taraf içeriklerin bulunduğu ülkenin/bölgenin haritalanmasıyla ilgili yasalar da dahil olmak üzere geçerli yasalara uygun olarak 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'e bakın.
width	query		integer int32	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	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. tilesetId değerinin microsoft.imagery olması 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 birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için rehberlik için aşağıdaki makalelere bakın.
Accept		MediaType	Kabul Et üst bilgisi alanı, yanıt medya türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen medya türleri: image/jpeg ve image/png. Kabul et üst bilgisi belirtilmezse resim/png içinde resim döndür.

Yanıtlar

Name	Tür	Description
200 OK	object	Bu görüntü başarılı bir Harita Al Statik Görüntü ç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 denetimi ile eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişim belirtmek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak için kimlik 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.

Notlar

• Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağını belirtmek için üst bilgi kullanımını x-ms-client-idgerektirir. Bu, Haritalar yönetim API'sinden alınabilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır. * Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır. * Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için 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 SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı oluştururken 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.

Herkese açık uygulamalar için önerimiz, bu anahtarın güvenli bir şekilde depolanabileceği Azure Haritalar REST API'lerinin sunucudan sunucuya erişiminin kullanılmasıdır.

Tür: apiKey
İçinde: header

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgeler için ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların paylaşılan anahtardan daha güvenli bir şekilde erişimi denetlemesine izin vermek için kullanılabilir.

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

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), coğrafi olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkelerin/bölgelerin bu tür bölgelerin farklı görünümleri vardır ve View parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünümle uyumlu olması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 Haritalar'da View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar aracılığıyla erişme yetkiniz olan üçüncü taraf içeriğin kullanıma sunulduğu ülkenin/bölgenin haritalanmasıyla ilgili olanlar da dahil olmak üzere geçerli yasalara uygun olarak 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'e bakın.
MediaType	Kabul Et üst bilgisi alanı, yanıt medya türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen medya türleri: image/jpeg ve image/png. Kabul et üst bilgisi belirtilmezse resim/png içinde resim döndür.
TilesetId	Döndürülecek harita 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 yer paylaşımlı trafik akışı olmadığını gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer hiçbiridir ve hiçbir trafik akışı döndürülmedi. 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

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

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

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

LocalizedMapView

View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), coğrafi olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkelerin/bölgelerin bu tür bölgelerin farklı görünümleri vardır ve View parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünümle uyumlu olması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 Haritalar'da View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar aracılığıyla erişme yetkiniz olan üçüncü taraf içeriğin kullanıma sunulduğu ülkenin/bölgenin haritalanmasıyla ilgili olanlar da dahil olmak üzere geçerli yasalara uygun olarak 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'e bakın.

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

MediaType

Kabul Et üst bilgisi alanı, yanıt medya türleriyle ilgili tercihleri belirtmek için kullanılabilir. İzin verilen medya türleri: image/jpeg ve image/png. Kabul et üst bilgisi belirtilmezse resim/png içinde resim döndür.

Name	Tür	Description
image/jpeg	string	Resmi jpeg biçiminde döndür.
image/png	string	Resmi png biçiminde döndür.

TilesetId

Döndürülecek harita 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.

Name	Tür	Description
microsoft.base.darkgrey	string	TilesetId, koyu gri stilimizle tüm katmanları içerir.
microsoft.base.road	string	TilesetId, işleme ana stiline sahip tüm katmanları içerir.
microsoft.imagery	string	TilesetId, uydu ve havadan görüntülerin bir bileşimini içerir.

TrafficTilesetId

İsteğe Bağlı Değer, görüntü sonucunda yer paylaşımlı trafik akışı olmadığını gösterir. Olası değerler microsoft.traffic.relative.main ve hiçbiridir. Varsayılan değer hiçbiridir ve hiçbir trafik akışı döndürülmedi. 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.

Name	Tür	Description
microsoft.traffic.relative.main	string	Trafikle ilgili desteklenen tilesetId.
none	string	Varsayılan değer, trafik akışı katmanı yok.