Share via

RenderGetMapImageOptionalParams interface

  • Başvuru
Paket:
azure-maps-rest

İsteğe Bağlı Parametreler.

Extends

RequestOptionsBase

Özellikler

bbox

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

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

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

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

Harita katmanı istendi. Katman etiketler veya karma olarak ayarlandıysa, biçim png olmalıdır. Olası değerler şunlardır: 'basic', 'hybrid', 'labels'
path

Yol stili ve konumları. İ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 ile başlayan Azure Haritalar hesabı SKU'sunda desteklenir. Path parametresinin birden çok örneği, stilleriyle birden çok geometri belirtmeye olanak tanır. İstek başına parametre sayısı 10 ile, konum sayısı ise yol başına 100 ile sınırlıdır.

Varsayılan stili kullanarak yarıçapı 100 metre ve merkez noktası enlem 45°N ve boylam 122°W olan bir daireyi işlemek için querystring parametresini ekleyin

path=ra100||-122 45

Boylam enlemden önce gelir. URL kodlamadan sonra bu şuna benzer olacaktır:

path=ra100%7C%7C-122+45

Buradaki tüm örnekler netlik için URL kodlaması olmadan yol parametresini gösterir.

Bir çizgiyi işlemek için her konumu bir boru karakteriyle ayırın. Örneğin,

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

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

Azure Haritalar Veri Depolama'dan Yol konumlarını alma

S0 dışındaki tüm Azure Haritalar hesabı SKU'ları için yol konumu bilgileri Azure Haritalar Veri Depolama'dan alınabilir. Yol konumlarını içeren bir GeoJSON belgesini karşıya yükledikten sonra, Veri Depolama hizmeti yol parametresindeki verilere başvurmak için kullanabileceğiniz bir Benzersiz Veri Kimliği (UDID) döndürür.

Karşıya yüklenen GeoJSON belgesindeki nokta geometrisini yol konumları olarak kullanmak için, yol parametresinin locations bölümünde UDID'yi belirtin. Örneğin,

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Veri Depolama'dan yol konumlarını path parametresinde belirtilen konumlarla karıştırmaya izin verilmediğini unutmayın.

Stil Değiştirici Özeti

Değiştirici Description Aralık
Lc Çizgi rengi 000000 'a FFFFFF
Fc Dolgu rengi 000000 'a FFFFFF
La Alfa çizgi (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

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.

Azure Haritalar Veri Depolama alanından Pushpin alma

S0 dışındaki tüm Azure Haritalar hesabı SKU'ları için pushpin görüntüsü ve konum bilgileri Azure Haritalar Veri Depolama'dan alınabilir. Raptiye konumlarını içeren bir pushpin görüntüsünü veya GeoJSON belgesini karşıya yükledikten sonra, Veri Depolama hizmeti pinler parametresindeki verilere başvurmak için kullanabileceğiniz benzersiz bir Veri Kimliği (UDID) döndürür.

Azure Haritalar Veri Depolama'dan özel bir pushpin görüntüsü kullanmak için pushpin stilinin adı olarak 'udid-' ön ekini içeren UDID'yi belirtin. Örneğin,

pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45

Karşıya yüklenen GeoJSON belgesindeki nokta geometrisini pin konumları olarak kullanmak için, pinler parametresinin locations bölümünde UDID'yi belirtin. Örneğin,

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Yalnızca nokta ve çok noktalı geometri, geometri koleksiyonlarından nokta ve çok noktalı geometri ile özelliklerden nokta geometrisi kullanılacağını unutmayın. Linestring ve çokgen geometrisi yoksayılır. Nokta bir özellikten geliyorsa ve özellik "label" adlı bir dize özelliğine sahipse, bu özelliğin değeri raptiye etiketi olarak kullanılır.

Pin konumlarını Veri Depolama'dan ve pins parametresinde belirtilen sabitleme konumlarıyla karıştırabilirsiniz. Boruyla ayrılmış pin konumlarından herhangi biri boylam ve enlem veya UDID olabilir. Örneğin,

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

Ö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

Döndürülecek eşleme stili. Şu anda yalnızca kullanılabilir stil ana stildir. Olası değerler şunlardır: 'main'
view

View parametresi, haritada görüntülenen kenarlıklar ve etiketler de dahil olmak üzere Azure Haritalar hizmetleri aracılığıyla hangi jeopolitik olarak tartışmalı içerik kümesinin döndürülür olduğunu belirtir. View parametresi ("kullanıcı bölgesi parametresi" olarak da adlandırılır) ilgili ülke/bölge için doğru eşlemeleri gösterir. 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'deki 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 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

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

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 .

Devralınan Özellikler

abortSignal

İstekleri durdurmak için kullanılabilecek sinyal.
customHeaders

{object} [customHeaders] İstek gönderilmeden önce uygulanacak kullanıcı tanımlı özel istek üst bilgileri.
onDownloadProgress

İndirme ilerlemesi üzerine tetiklenen geri çağırma.
onUploadProgress

Karşıya yükleme ilerlemesi üzerine tetiklenen geri çağırma.
timeout

Bir isteğin otomatik olarak sonlandırılmadan önce ne kadar süre alabileceğini milisaniye cinsinden belirtin.

Özellik Ayrıntıları

bbox

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.

bbox?: string

Özellik Değeri

string

center

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.
center?: string

Özellik Değeri

string

height

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.

height?: number

Özellik Değeri

number

language

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.

language?: string

Özellik Değeri

string

layer

Harita katmanı istendi. Katman etiketler veya karma olarak ayarlandıysa, biçim png olmalıdır. Olası değerler şunlardır: 'basic', 'hybrid', 'labels'

layer?: StaticMapLayer

Özellik Değeri

StaticMapLayer

path

Yol stili ve konumları. İ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 ile başlayan Azure Haritalar hesabı SKU'sunda desteklenir. Path parametresinin birden çok örneği, stilleriyle birden çok geometri belirtmeye olanak tanır. İstek başına parametre sayısı 10 ile, konum sayısı ise yol başına 100 ile sınırlıdır.

Varsayılan stili kullanarak yarıçapı 100 metre ve merkez noktası enlem 45°N ve boylam 122°W olan bir daireyi işlemek için querystring parametresini ekleyin

path=ra100||-122 45

Boylam enlemden önce gelir. URL kodlamadan sonra bu şuna benzer olacaktır:

path=ra100%7C%7C-122+45

Buradaki tüm örnekler netlik için URL kodlaması olmadan yol parametresini gösterir.

Bir çizgiyi işlemek için her konumu bir boru karakteriyle ayırın. Örneğin,

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

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

Azure Haritalar Veri Depolama'dan Yol konumlarını alma

S0 dışındaki tüm Azure Haritalar hesabı SKU'ları için yol konumu bilgileri Azure Haritalar Veri Depolama'dan alınabilir. Yol konumlarını içeren bir GeoJSON belgesini karşıya yükledikten sonra, Veri Depolama hizmeti yol parametresindeki verilere başvurmak için kullanabileceğiniz bir Benzersiz Veri Kimliği (UDID) döndürür.

Karşıya yüklenen GeoJSON belgesindeki nokta geometrisini yol konumları olarak kullanmak için, yol parametresinin locations bölümünde UDID'yi belirtin. Örneğin,

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Veri Depolama'dan yol konumlarını path parametresinde belirtilen konumlarla karıştırmaya izin verilmediğini unutmayın.

Stil Değiştirici Özeti

Değiştirici Description Aralık
Lc Çizgi rengi 000000 'a FFFFFF
Fc Dolgu rengi 000000 'a FFFFFF
La Alfa çizgi (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 
path?: string[]

Özellik Değeri

string[]

pins

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.

Azure Haritalar Veri Depolama alanından Pushpin alma

S0 dışındaki tüm Azure Haritalar hesabı SKU'ları için pushpin görüntüsü ve konum bilgileri Azure Haritalar Veri Depolama'dan alınabilir. Raptiye konumlarını içeren bir pushpin görüntüsünü veya GeoJSON belgesini karşıya yükledikten sonra, Veri Depolama hizmeti pinler parametresindeki verilere başvurmak için kullanabileceğiniz benzersiz bir Veri Kimliği (UDID) döndürür.

Azure Haritalar Veri Depolama'dan özel bir pushpin görüntüsü kullanmak için pushpin stilinin adı olarak 'udid-' ön ekini içeren UDID'yi belirtin. Örneğin,

pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45

Karşıya yüklenen GeoJSON belgesindeki nokta geometrisini pin konumları olarak kullanmak için, pinler parametresinin locations bölümünde UDID'yi belirtin. Örneğin,

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Yalnızca nokta ve çok noktalı geometri, geometri koleksiyonlarından nokta ve çok noktalı geometri ile özelliklerden nokta geometrisi kullanılacağını unutmayın. Linestring ve çokgen geometrisi yoksayılır. Nokta bir özellikten geliyorsa ve özellik "label" adlı bir dize özelliğine sahipse, bu özelliğin değeri raptiye etiketi olarak kullanılır.

Pin konumlarını Veri Depolama'dan ve pins parametresinde belirtilen sabitleme konumlarıyla karıştırabilirsiniz. Boruyla ayrılmış pin konumlarından herhangi biri boylam ve enlem veya UDID olabilir. Örneğin,

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

Ö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.
pins?: string[]

Özellik Değeri

string[]

style

Döndürülecek eşleme stili. Şu anda yalnızca kullanılabilir stil ana stildir. Olası değerler şunlardır: 'main'

style?: Style

Özellik Değeri

Style

view

View parametresi, haritada görüntülenen kenarlıklar ve etiketler de dahil olmak üzere Azure Haritalar hizmetleri aracılığıyla hangi jeopolitik olarak tartışmalı içerik kümesinin döndürülür olduğunu belirtir. View parametresi ("kullanıcı bölgesi parametresi" olarak da adlandırılır) ilgili ülke/bölge için doğru eşlemeleri gösterir. 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'deki 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 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.

view?: string

Özellik Değeri

string

width

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.

width?: number

Özellik Değeri

number

zoom

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 .

zoom?: number

Özellik Değeri

number

Devralınan Özellik Detayları

abortSignal

İstekleri durdurmak için kullanılabilecek sinyal.

abortSignal?: AbortSignalLike

Özellik Değeri

AbortSignalLike

Devralınan RequestOptionsBase.abortSignal

customHeaders

{object} [customHeaders] İstek gönderilmeden önce uygulanacak kullanıcı tanımlı özel istek üst bilgileri.

customHeaders?: [key: string]: string

Özellik Değeri

[key: string]: string

Devralınan RequestOptionsBase.customHeaders

onDownloadProgress

İndirme ilerlemesi üzerine tetiklenen geri çağırma.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Özellik Değeri

(progress: TransferProgressEvent) => void

Devralınan RequestOptionsBase.onDownloadProgress

onUploadProgress

Karşıya yükleme ilerlemesi üzerine tetiklenen geri çağırma.

onUploadProgress?: (progress: TransferProgressEvent) => void

Özellik Değeri

(progress: TransferProgressEvent) => void

Devralınan RequestOptionsBase.onUploadProgress

timeout

Bir isteğin otomatik olarak sonlandırılmadan önce ne kadar süre alabileceğini milisaniye cinsinden belirtin.

timeout?: number

Özellik Değeri

number

Devralınan RequestOptionsBase.timeout