Share via

RenderURL class

  • Referensi
Paket:
azure-maps-rest

RenderURL mewakili URL ke operasi render Azure Maps.

Extends
MapsURL

Konstruktor

RenderURL(Pipeline, string)

Membuat instans RenderURL.

Properti yang Diwariskan

mapsUrl

Nilai string URL dasar.

Metode

getMapImage(Aborter, GetMapImageOptions)

Merender gambar persegi panjang yang ditentukan pengguna yang berisi bagian peta menggunakan tingkat zoom dari 0 hingga 20. Layanan gambar statis merender gambar persegi panjang yang ditentukan pengguna yang berisi bagian peta menggunakan tingkat pembesaran tampilan dari 0 hingga 20. Rentang resolusi yang didukung untuk gambar peta adalah dari 1x1 hingga 8192x8192. Jika Anda memutuskan kapan harus menggunakan layanan gambar statis melalui layanan petak peta, Anda mungkin ingin mempertimbangkan bagaimana Anda ingin berinteraksi dengan peta yang dirender. Jika konten peta akan relatif tidak berubah, peta statis adalah pilihan yang baik. Jika Anda ingin mendukung banyak memperbesar, menggeser, dan mengubah konten peta, layanan petak peta akan menjadi pilihan yang lebih baik. Layanan juga menyediakan fungsionalitas Komposisi Gambar untuk mendapatkan gambar statis kembali dengan data tambahan seperti; pushpin dan overlay geometri dengan kemampuan S0 dan S1 berikut.

Di S0 Anda dapat:

  • Render hingga 5 pushpin yang ditentukan dalam permintaan
  • Berikan satu gambar kustom untuk pin yang dirujuk dalam permintaan
  • Menambahkan label ke pin pendorongan

Di S1 Anda dapat:

Silakan lihat Panduan Cara penggunaan untuk contoh terperinci.

Catatan : Parameter pusat atau bbox harus disediakan ke API.

Rentang Lat dan Lon yang didukung saat menggunakan parameter bbox , adalah sebagai berikut:

Tingkat Zoom Rentang Lon Maks Rentang Lat Maks
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

Menggunakan Get Map Image API: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

Mengembalikan petak peta gambar peta dengan ukuran 256x256, mengingat koordinat x dan y dan tingkat zoom. Tingkat perbesar tampilan berkisar antara 0 hingga 18. Nilai gaya yang tersedia saat ini adalah 'satelit' yang menyediakan citra satelit saja. Menggunakan Get Map Imagery Tile API: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Mengembalikan petak peta dalam format vektor atau raster biasanya untuk diintegrasikan ke dalam kontrol peta atau SDK baru. Secara default, Azure menggunakan petak peta vektor untuk kontrol peta webnya (lihat Tingkat Pembesaran Tampilan dan Kisi Petak Peta) Menggunakan GET Map Tile API: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Metode yang Diwarisi

newPipeline(Credential, INewPipelineOptions)

Metode statis yang digunakan untuk membuat objek Alur baru dengan Kredensial yang disediakan.

Detail Konstruktor

RenderURL(Pipeline, string)

Membuat instans RenderURL.

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

Parameter

pipeline
Pipeline

Panggil MapsURL.newPipeline() untuk membuat alur default, atau sediakan alur yang disesuaikan.

mapsUrl

string

String URL yang menunjuk ke layanan Azure Maps, defaultnya adalah "https://atlas.microsoft.com". Jika tidak ada protokol yang ditentukan, misalnya "atlas.microsoft.com", maka https akan diasumsikan.

Detail Properti yang Diwariskan

mapsUrl

Nilai string URL dasar.

mapsUrl: string

Nilai Properti

string

Diwarisi DariMapsURL.mapsUrl

Detail Metode

getMapImage(Aborter, GetMapImageOptions)

Merender gambar persegi panjang yang ditentukan pengguna yang berisi bagian peta menggunakan tingkat zoom dari 0 hingga 20. Layanan gambar statis merender gambar persegi panjang yang ditentukan pengguna yang berisi bagian peta menggunakan tingkat pembesaran tampilan dari 0 hingga 20. Rentang resolusi yang didukung untuk gambar peta adalah dari 1x1 hingga 8192x8192. Jika Anda memutuskan kapan harus menggunakan layanan gambar statis melalui layanan petak peta, Anda mungkin ingin mempertimbangkan bagaimana Anda ingin berinteraksi dengan peta yang dirender. Jika konten peta akan relatif tidak berubah, peta statis adalah pilihan yang baik. Jika Anda ingin mendukung banyak memperbesar, menggeser, dan mengubah konten peta, layanan petak peta akan menjadi pilihan yang lebih baik. Layanan juga menyediakan fungsionalitas Komposisi Gambar untuk mendapatkan gambar statis kembali dengan data tambahan seperti; pushpin dan overlay geometri dengan kemampuan S0 dan S1 berikut.

Di S0 Anda dapat:

  • Render hingga 5 pushpin yang ditentukan dalam permintaan
  • Berikan satu gambar kustom untuk pin yang dirujuk dalam permintaan
  • Menambahkan label ke pin pendorongan

Di S1 Anda dapat:

Silakan lihat Panduan Cara penggunaan untuk contoh terperinci.

Catatan : Parameter pusat atau bbox harus disediakan ke API.

Rentang Lat dan Lon yang didukung saat menggunakan parameter bbox , adalah sebagai berikut:

Tingkat Zoom Rentang Lon Maks Rentang Lat Maks
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

Menggunakan Get Map Image API: https://docs.microsoft.com/rest/api/maps/render/getmapimage

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

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

options
GetMapImageOptions

Mengembalikan

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

Mengembalikan petak peta gambar peta dengan ukuran 256x256, mengingat koordinat x dan y dan tingkat zoom. Tingkat perbesar tampilan berkisar antara 0 hingga 18. Nilai gaya yang tersedia saat ini adalah 'satelit' yang menyediakan citra satelit saja. Menggunakan Get Map Imagery Tile API: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

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

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

zoom

number

Tingkat perbesar tampilan untuk petak peta yang diinginkan. Nilai zoom harus dalam rentang: 0-18 (inklusif).

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

xTileIndex

number

Koordinat X petak peta pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1].

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

yTileIndex

number

Koordinat petak peta Y pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1].

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

Mengembalikan

Promise<GetMapImageryTileResponse>

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

Mengembalikan petak peta dalam format vektor atau raster biasanya untuk diintegrasikan ke dalam kontrol peta atau SDK baru. Secara default, Azure menggunakan petak peta vektor untuk kontrol peta webnya (lihat Tingkat Pembesaran Tampilan dan Kisi Petak Peta) Menggunakan GET Map Tile API: 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>

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

format
TileFormat

Format respons yang diinginkan. Nilai yang mungkin adalah png & pbf. Nilai yang mungkin termasuk: 'png', 'pbf'

layer
MapTileLayer

Lapisan peta diminta. Nilai yang mungkin adalah dasar, hibrid, label, dan terra. Nilai yang mungkin termasuk: 'basic', 'hybrid', 'labels', 'terra'

style
MapTileStyle

Gaya peta yang akan dikembalikan. Nilai yang mungkin adalah & shaded_relief utama. Nilai yang mungkin termasuk: 'main', 'shaded_relief'

zoom

number

Tingkat perbesar tampilan untuk petak peta yang diinginkan. Untuk petak peta raster , nilai harus dalam rentang: 0-18 (inklusif). Petak peta terra raster, nilai harus dalam rentang 0-6 (inklusif). Untuk petak peta vektor , nilai harus dalam rentang: 0-22 (inklusif).

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

xTileIndex

number

Koordinat X petak peta pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1].

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

yTileIndex

number

Koordinat petak peta Y pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1].

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

options
GetMapTileOptions

Mengembalikan

Promise<GetMapTileResponse>

Detail Metode yang Diwarisi

newPipeline(Credential, INewPipelineOptions)

Metode statis yang digunakan untuk membuat objek Alur baru dengan Kredensial yang disediakan.

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

Parameter

credential
Credential

Seperti SubscriptionKeyCredential, TokenCredential, dan MapControlCredential.

pipelineOptions
INewPipelineOptions

Mengembalikan

Pipeline

Objek Alur baru.

Diwarisi DariMapsURL.newPipeline