Aracılığıyla paylaş

RenderGetMapStaticImageQueryParamProperties interface

Paket:
@azure-rest/maps-render

Özellikler

bbox

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

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

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

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

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'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, 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 Dize 000000-FFFFFF
Fc Dolgu rengi Dize 000000-FFFFFF
La Alfa çizgisi (opaklık) kayan noktalı sayı 0 - 1
Fa Alfa doldurma (opaklık) kayan noktalı sayı 0 - 1
Lw Çizgi genişliği int32 (0, 50]
Ra Daire yarıçapı (metre) kayan noktalı sayı 0'dan büyük
pins

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'su pin parametresinin yalnızca tek bir örneğini destekler ve konum sayısı pin başına 5 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 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.

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. Mesela

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. Mesela

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) kayan noktalı sayı 0 - 1
Bir Sabit tutturucu <int32, int32> *
co Raptiye rengi Dize 000000-FFFFFF
La Etiket tutturucu <int32, int32> *
Lc Etiket rengi Dize 000000-FFFFFF
Ls Etiket boyutu kayan noktalı sayı 0'dan büyük
Ro Rotasyon kayan noktalı sayı -360 - 360
Sc Ölçeklemek kayan noktalı sayı 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

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

İ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

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'daki View parametresi, Haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar aracılığıyla erişim yetkiniz olan üçüncü taraf içeriğinin bulunduğu ülkenin/bölgenin eşlemeyle 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 bakın.
width

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

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.

Özellik Ayrıntıları

bbox

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.

bbox?: number[]

Özellik Değeri

number[]

center

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.

center?: number[]

Özellik Değeri

number[]

height

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.

height?: number

Özellik Değeri

number

language

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.

language?: string

Özellik Değeri

string

path

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'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, 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 Dize 000000-FFFFFF
Fc Dolgu rengi Dize 000000-FFFFFF
La Alfa çizgisi (opaklık) kayan noktalı sayı 0 - 1
Fa Alfa doldurma (opaklık) kayan noktalı sayı 0 - 1
Lw Çizgi genişliği int32 (0, 50]
Ra Daire yarıçapı (metre) kayan noktalı sayı 0'dan büyük 
path?: string

Özellik Değeri

string

pins

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'su pin parametresinin yalnızca tek bir örneğini destekler ve konum sayısı pin başına 5 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 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.

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. Mesela

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. Mesela

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) kayan noktalı sayı 0 - 1
Bir Sabit tutturucu <int32, int32> *
co Raptiye rengi Dize 000000-FFFFFF
La Etiket tutturucu <int32, int32> *
Lc Etiket rengi Dize 000000-FFFFFF
Ls Etiket boyutu kayan noktalı sayı 0'dan büyük
Ro Rotasyon kayan noktalı sayı -360 - 360
Sc Ölçeklemek kayan noktalı sayı 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.
pins?: string

Özellik Değeri

string

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.

tilesetId?: "microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

Özellik Değeri

"microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

trafficLayer

İ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.

trafficLayer?: "microsoft.traffic.relative.main" | "none"

Özellik Değeri

"microsoft.traffic.relative.main" | "none"

view

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'daki View parametresi, Haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar aracılığıyla erişim yetkiniz olan üçüncü taraf içeriğinin bulunduğu ülkenin/bölgenin eşlemeyle 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 bakın.

view?: "AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

Özellik Değeri

"AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

width

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.

width?: number

Özellik Değeri

number

zoom

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.

zoom?: number

Özellik Değeri

number