Share via

RenderURL class

  • Başvuru
Paket:
azure-maps-rest

RenderURL, Azure Haritalar işleme işlemlerinin URL'sini temsil eder.

Extends
MapsURL

Oluşturucular

RenderURL(Pipeline, string)

Bir RenderURL örneği oluşturur.

Devralınan Özellikler

mapsUrl

Temel URL dize değeri.

Yöntemler

getMapImage(Aborter, GetMapImageOptions)

0 ile 20 arası yakınlaştırma düzeyini kullanarak harita bölümü içeren kullanıcı tanımlı dikdörtgen bir görüntüyü işler. Statik görüntü hizmeti, 0 ile 20 arası yakınlaştırma düzeyini kullanarak harita bölümü içeren kullanıcı tanımlı, dikdörtgen bir görüntüyü işler. Harita görüntüsü için desteklenen çözünürlük aralığı 1x1 ile 8192x8192 arasındadır. Harita kutucuğu hizmeti üzerinde statik görüntü hizmetini ne zaman kullanacağınıza karar verirseniz, işlenen haritayla nasıl etkileşime geçmek istediğinizi düşünebilirsiniz. Harita içeriği görece değişmeden olacaksa, statik bir harita iyi bir seçimdir. Harita içeriğini çok fazla yakınlaştırmayı, kaydırmayı ve değiştirmeyi desteklemek istiyorsanız harita kutucuğu hizmeti daha iyi bir seçim olacaktır. Hizmet ayrıca ek verilerle statik bir görüntüyü geri almak için Görüntü Oluşturma işlevi de sağlar; aşağıdaki S0 ve S1 özelliklerine sahip raptler ve geometri yer paylaşımları.

S0'da şunları yapabilirsiniz:

  • İstekte belirtilen en fazla 5 pushpin işleyin
  • İstekte başvuruda bulunilen pin'ler için bir özel görüntü sağlayın
  • Raptlere etiket ekleme

S1'de şunları yapabilirsiniz:

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

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

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

Yakınlaştırma Düzeyi Maksimum Lon Aralığı Maksimum Lat Aralığı
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22.5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941

Harita Görüntüsü Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

x ve y koordinatları ve yakınlaştırma düzeyine göre boyut 256x256 olan bir harita görüntüsü kutucuğu döndürür. Yakınlaştırma düzeyi 0 ile 18 arasında değişir. Mevcut stil değeri, yalnızca uydu görüntüsü sağlayan 'uydu'dur. Harita Görüntüsü Alma Kutucuğu API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Genellikle yeni bir harita denetimine veya SDK'ya tümleştirilecek vektör veya tarama biçiminde bir harita kutucukları döndürür. Varsayılan olarak Azure, web haritası denetimi için vektör eşleme kutucuklarını kullanır (bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu) Harita Kutucuğu Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Devralınan Yöntemler

newPipeline(Credential, INewPipelineOptions)

Kimlik bilgisi sağlanan yeni bir İşlem Hattı nesnesi oluşturmak için kullanılan statik bir yöntem.

Oluşturucu Ayrıntıları

RenderURL(Pipeline, string)

Bir RenderURL örneği oluşturur.

new RenderURL(pipeline: Pipeline, mapsUrl?: string)

Parametreler

pipeline
Pipeline

Varsayılan işlem hattı oluşturmak veya özelleştirilmiş bir işlem hattı sağlamak için MapsURL.newPipeline() çağrısı yapın.

mapsUrl

string

varsayılan olarak Azure Haritalar hizmetine işaret eden bir URL dizesidir"https://atlas.microsoft.com". Herhangi bir protokol belirtilmezse (örneğin "atlas.microsoft.com", https ) kabul edilir.

Devralınan Özellik Detayları

mapsUrl

Temel URL dize değeri.

mapsUrl: string

Özellik Değeri

string

MapsURL.mapsUrl'denDevralındı

Yöntem Ayrıntıları

getMapImage(Aborter, GetMapImageOptions)

0 ile 20 arası yakınlaştırma düzeyini kullanarak harita bölümü içeren kullanıcı tanımlı dikdörtgen bir görüntüyü işler. Statik görüntü hizmeti, 0 ile 20 arası yakınlaştırma düzeyini kullanarak harita bölümü içeren kullanıcı tanımlı, dikdörtgen bir görüntüyü işler. Harita görüntüsü için desteklenen çözünürlük aralığı 1x1 ile 8192x8192 arasındadır. Harita kutucuğu hizmeti üzerinde statik görüntü hizmetini ne zaman kullanacağınıza karar verirseniz, işlenen haritayla nasıl etkileşime geçmek istediğinizi düşünebilirsiniz. Harita içeriği görece değişmeden olacaksa, statik bir harita iyi bir seçimdir. Harita içeriğini çok fazla yakınlaştırmayı, kaydırmayı ve değiştirmeyi desteklemek istiyorsanız harita kutucuğu hizmeti daha iyi bir seçim olacaktır. Hizmet ayrıca ek verilerle statik bir görüntüyü geri almak için Görüntü Oluşturma işlevi de sağlar; aşağıdaki S0 ve S1 özelliklerine sahip raptler ve geometri yer paylaşımları.

S0'da şunları yapabilirsiniz:

  • İstekte belirtilen en fazla 5 pushpin işleyin
  • İstekte başvuruda bulunilen pin'ler için bir özel görüntü sağlayın
  • Raptlere etiket ekleme

S1'de şunları yapabilirsiniz:

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

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

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

Yakınlaştırma Düzeyi Maksimum Lon Aralığı Maksimum Lat Aralığı
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22.5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941

Harita Görüntüsü Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmapimage

function getMapImage(aborter: Aborter, options: GetMapImageOptions): Promise<GetMapImageResponse>

Parametreler

aborter
Aborter

İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.

options
GetMapImageOptions

Döndürülenler

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

x ve y koordinatları ve yakınlaştırma düzeyine göre boyut 256x256 olan bir harita görüntüsü kutucuğu döndürür. Yakınlaştırma düzeyi 0 ile 18 arasında değişir. Mevcut stil değeri, yalnızca uydu görüntüsü sağlayan 'uydu'dur. Harita Görüntüsü Alma Kutucuğu API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

function getMapImageryTile(aborter: Aborter, zoom: number, xTileIndex: number, yTileIndex: number): Promise<GetMapImageryTileResponse>

Parametreler

aborter
Aborter

İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.

zoom

number

İstenen kutucuk için yakınlaştırma düzeyi. Yakınlaştırma değeri şu aralıkta olmalıdır: 0-18 (dahil).

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

xTileIndex

number

Yakınlaştırma kılavuzundaki kutucuğun X koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

yTileIndex

number

Yakınlaştırma kılavuzundaki kutucuğun Y koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

Döndürülenler

Promise<GetMapImageryTileResponse>

getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Genellikle yeni bir harita denetimine veya SDK'ya tümleştirilecek vektör veya tarama biçiminde bir harita kutucukları döndürür. Varsayılan olarak Azure, web haritası denetimi için vektör eşleme kutucuklarını kullanır (bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu) Harita Kutucuğu Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/render/getmaptile

function getMapTile(aborter: Aborter, format: TileFormat, layer: MapTileLayer, style: MapTileStyle, zoom: number, xTileIndex: number, yTileIndex: number, options?: GetMapTileOptions): Promise<GetMapTileResponse>

Parametreler

aborter
Aborter

İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.

format
TileFormat

Yanıtın istenen biçimi. Olası değerler png & pbf'tir. Olası değerler şunlardır: 'png', 'pbf'

layer
MapTileLayer

Harita katmanı istendi. Olası değerler temel, karma, etiketler ve terra'dır. Olası değerler şunlardır: 'basic', 'hybrid', 'labels', 'terra'

style
MapTileStyle

Döndürülecek eşleme stili. Olası değerler ana & shaded_relief. Olası değerler şunlardır: 'main', 'shaded_relief'

zoom

number

İstenen kutucuk için yakınlaştırma düzeyi. Raster kutucukları için değer şu aralıkta olmalıdır: 0-18 (dahil). Terra raster kutucukları, değerler 0-6 (dahil) aralığında olmalıdır. Vektör kutucukları için değer şu aralıkta olmalıdır: 0-22 (dahil).

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

xTileIndex

number

Yakınlaştırma kılavuzundaki kutucuğun X koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

yTileIndex

number

Yakınlaştırma kılavuzundaki kutucuğun Y koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

options
GetMapTileOptions

Döndürülenler

Promise<GetMapTileResponse>

Devralınan Yöntemin Ayrıntıları

newPipeline(Credential, INewPipelineOptions)

Kimlik bilgisi sağlanan yeni bir İşlem Hattı nesnesi oluşturmak için kullanılan statik bir yöntem.

static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline

Parametreler

credential
Credential

SubscriptionKeyCredential, TokenCredential ve MapControlCredential gibi.

pipelineOptions
INewPipelineOptions

Döndürülenler

Pipeline

Yeni bir İşlem Hattı nesnesi.

MapsURL.newPipeline'denDevralındı