Render - Get Map Static Image

0 ile 20 arasında bir yakınlaştırma düzeyi kullanarak harita bölümü içeren kullanıcı tanımlı dikdörtgen bir görüntüyü işlemek için kullanın.

Harita görüntüsü için desteklenen çözünürlük aralığı 1x1 ile 8192x8192 arasındadır. Harita kutucuğu hizmeti üzerinde statik görüntü hizmetini ne zaman kullanacağınıza karar verirseniz, işlenen haritayla nasıl etkileşime geçmek istediğinizi düşünebilirsiniz. Harita içeriği görece değişmeden olacaksa, statik bir harita iyi bir seçimdir. Harita içeriğini çok fazla yakınlaştırmayı, kaydırmayı ve değiştirmeyi desteklemek istiyorsanız harita kutucuğu hizmeti daha iyi bir seçim olacaktır.

Hizmet ayrıca ek verilerle statik bir görüntüyü geri almak için Görüntü Oluşturma işlevi de sağlar; aşağıdaki özelliklere sahip raptler ve geometri yer paylaşımları.

  • Birden çok rapt stili belirtme
  • Daire, çok çizgili ve çokgen geometri türlerini işleme.

Ayrıntılı örnekler için bkz. Nasıl Yapılır Kılavuzu .

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

bbox parametresi kullanılırken desteklenen Lat ve Lon aralıkları aşağıdaki gibidir:

Yakınlaştırma Düzeyi Maksimum Lon Aralığı Maksimum Lat Aralığı
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22.5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941
GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01
GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&layer={layer}&style={style}&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
format
path True

RasterTileFormat

Yanıtın istenen biçimi. Olası değer: png.

api-version
query True

string

Azure Haritalar API'sinin sürüm numarası. Geçerli sürüm: 2022-08-01

bbox
query

number[]

Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Biçim: 'minLon, minLat, maxLon, maxLat'.

Not: Bbox veya center gerekli parametrelerdir. Bunlar birbirini dışlar. Yükseklik veya genişlik ile kullanılmamalıdır.

Lat ve Lon için izin verilen maksimum 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ı. Biçim: 'lon,lat'. Kullanılan projeksiyon

  • EPSG:3857. Boylam aralığı: -180 - 180. Enlem aralığı: -85 - 85.

Not: Ortala veya bbox gerekli parametrelerdir. Bunlar birbirini dışlar.

height
query

integer

int32

Sonuçta elde edilen görüntünün piksel cinsinden yüksekliği. Aralık 1 ile 8192 arasındadır. 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.

layer
query

StaticMapLayer

Harita katmanı istendi. Katman etiketler veya karma olarak ayarlandıysa, biçim png olmalıdır.

path
query

string[]

Yol stili ve konumlar. İ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 yazdığınızdan emin olun.)

Path parametresi, S1 ile başlayan Azure Haritalar hesap 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ı 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 örneklerin tümü netlik için URL kodlaması olmadan path 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

Çokgen işlemek için son konumun başlangıç konumuna eşit olması gerekir. Örneğin,

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

Çizgilerin ve çokgenlerin konumları için boylam ve enlem değerleri-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 Description Aralık
Lc Çizgi rengi 000000 -FFFFFF
Fc Dolgu rengi 000000 -FFFFFF
La Alfa çizgisi (opaklık) 0 -1
Fa Dolgu alfa (opaklık) 0 -1
Lw Çizgi genişliği 0'dan büyük
Ra Daire yarıçapı (metre) 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 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. Ö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

Pushpin görüntüsünü 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 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. 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. Raptiye görüntüsünün tutturucu konumunu geçersiz kılmak için 'an' stili değiştiriciyi 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 işlem 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ştiriciyi kullanarak raptleri ve 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, 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, raptlerin opaklığını gösteren 0 ile 1 arasında bir sayıdır. Sıfır, bunları tamamen saydam yapar (görünür değil) ve 1 onları tamamen opak yapar (varsayılan değerdir). Ö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 Description Aralık
al Alfa (opaklık) 0 -1
a Tutturucu sabitleme *
co Raptiye rengi 000000 -FFFFFF
La Etiket tutturucu *
Lc Etiket rengi 000000 -FFFFFF
ls Etiket boyutu 0'dan büyük
Ro Döndürme -360 - 360
Sc Ölçek 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.
style
query

MapImageStyle

Döndürülecek harita stili. Olası değerler ana ve koyu değerlerdir.

view
query

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'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğ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.

width
query

integer

int32

Elde edilen görüntünün piksel cinsinden genişliği. Aralık 1 ile 8192 arasındadır. 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. Yakınlaştırma değeri şu aralıkta olmalıdır: 0-20 (dahil). Varsayılan değer 12'dir.

Ayrıntılar 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

Hangi hesabın Microsoft Entra ID güvenlik modeliyle birlikte 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'de Microsoft Entra ID güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın.

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: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Headers

Content-Type: string

Other Status Codes

ErrorResponse

Beklenmeyen bir hata oluştu.

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle 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ğa erişim tanımlamak 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ğı 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 yönetim düzleminden Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla 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.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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.

Type: apiKey
In: 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.

Type: apiKey
In: header

Örnekler

Successful Static Image Request

Sample Request

GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

Sample Response

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'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğ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.

MapImageStyle

Döndürülecek harita stili. Olası değerler ana ve koyu değerlerdir.

RasterTileFormat

Yanıtın istenen biçimi. Olası değer: png.

StaticMapLayer

Harita katmanı istendi. Katman etiketler veya karma olarak ayarlandıysa, biçim png olmalıdır.

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'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğ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ü)

MapImageStyle

Döndürülecek harita stili. Olası değerler ana ve koyu değerlerdir.

Name Tür Description
dark

string

Azure Haritalar ana stilinin koyu gri sürümü

main

string

Azure Haritalar ana stil

RasterTileFormat

Yanıtın istenen biçimi. Olası değer: png.

Name Tür Description
png

string

Png biçiminde bir resim. 0 ile 18 arasında yakınlaştırma düzeylerini destekler.

StaticMapLayer

Harita katmanı istendi. Katman etiketler veya karma olarak ayarlandıysa, biçim png olmalıdır.

Name Tür Description
basic

string

Çokgenler, kenarlıklar, yollar ve etiketler de dahil olmak üzere tüm harita özelliklerini içeren bir görüntü döndürür.

hybrid

string

Kenarlıklar, yollar ve etiketler içeren bir görüntü döndürür ve karma kutucuklar üretmek için diğer kutucuklara (uydu görüntüleri gibi) yer paylaşımlı hale getirilebilir.

labels

string

Yalnızca haritanın etiket bilgilerinin görüntüsünü döndürür.