Render - Get Map Static Image
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
GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}¢er={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
Boylam enlemden önce gelir. URL kodlamadan sonra bu şuna benzer olacaktır:
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,
İlk ve son noktaların eşit olduğu kapalı bir yol ile çokgen belirtilir. Örneğin,
Ç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ştiricilerStil 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
Daha karmaşık bir görsel stil oluşturmak için birden çok stil değiştirici birleştirilebilir.
Stil Değiştirici Özeti
|
|||||||||||||||||||||||||||||||||||||
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
Boylam enlemden önce gelir. URL kodlamadan sonra bu şuna benzer olacaktır:
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,
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ştiricilerStil 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
Rapt EtiketleriRaptiyelere etiket eklemek için, etiketi koordinatlardan hemen önce tek tırnak içine alın. veya
'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,
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
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
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
Ö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,
URL kodlamadan sonra şöyle görünür:
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
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
'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
'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
Stil Değiştirici Özeti
|
|||||||||||||||||||||||||||||||||||||
tileset
|
query |
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. |
||||||||||||||||||||||||||||||||||||||
traffic
|
query |
İ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 |
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. |
İ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 |
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 |
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-id
gerektirir. 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
GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10¢er=-122.177621,47.613079
Örnek yanıt
Content-Type: image/png
"{file}"
Tanımlar
Name | Description |
---|---|
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Localized |
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. |
Media |
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. |
Tileset |
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. |
Traffic |
İ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 |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
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. |