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.

|:----------|:----------------|:----------------|:----------------|:-------------| |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 {endpoint}/map/static?api-version=2024-04-01

İsteğe bağlı parametrelerle:

GET {endpoint}/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

endpoint

path

True

string (uri)

Azure Haritalar service hostname. Azure açık bulut için https://atlas.microsoft.com kullanın. Belirli bir Azure Haritalar coğrafyası veya egemen bir bulutu hedeflemek için Azure Haritalar coğrafi kapsam bkz.

api-version

query

True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

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 Haritalar 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 Haritalar 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 Haritalar 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

Tileset

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 Haritalar'teki View parametresi, haritalar, görseller ve diğer verilerin ve Azure Haritalar ü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)

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 Haritalar hesabı için bu benzersiz ID, Azure Haritalar yönetim düzlemi Hesap API'dan alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar 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	file	İstek başarılı oldu. Media Types: "image/png", "image/jpeg", "application/json"
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı. Media Types: "image/png", "image/jpeg", "application/json"

Name

Tür

Description

200 OK

file

İstek başarılı oldu.

Media Types: "image/png", "image/jpeg", "application/json"

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Media Types: "image/png", "image/jpeg", "application/json"

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 Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek 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ç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.

Note

Bu güvenlik tanımı 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 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

subscription-key

Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.

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ğı 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ölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. 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	Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
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 Haritalar'teki View parametresi, haritalar, görseller ve diğer verilerin ve Azure Haritalar ü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	Yanıtın istenen medya türü.
Tileset	Kutucuk kümesi, önceden ayarlanmış yakınlaştırma düzeylerinde kare kutucuklardan oluşan tekdüzen bir kılavuza ayrılmış raster veya vektör verilerinden oluşan bir koleksiyondur. Her kutucuk kümesinin istekte bulunurken kullanabileceği bir tilesetId vardır. Azure Haritalar tarafından sağlanan kullanıma hazır tilesetler aşağıda listelenmiştir. Örneğin, microsoft.base.
TrafficTilesetId	Görüntü sonucunda yer değiştirilmiş trafik akışı olmadığını gösteren değer.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info		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

Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

LocalizedMapView

Numaralandırma

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	Amerika Birleşik Devletleri
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

Yanıtın istenen medya türü.

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.

Tileset

Numaralandırma

Kutucuk kümesi, önceden ayarlanmış yakınlaştırma düzeylerinde kare kutucuklardan oluşan tekdüzen bir kılavuza ayrılmış raster veya vektör verilerinden oluşan bir koleksiyondur. Her kutucuk kümesinin istekte bulunurken kullanabileceği bir tilesetId vardır. Azure Haritalar tarafından sağlanan kullanıma hazır tilesetler aşağıda listelenmiştir. Örneğin, microsoft.base.

Değer	Description
microsoft.base.road	microsoft.base.road
microsoft.base.darkgrey	microsoft.base.darkgrey
microsoft.imagery	microsoft.imagery

TrafficTilesetId

Numaralandırma

Görüntü sonucunda yer değiştirilmiş trafik akışı olmadığını gösteren değer.

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