Render V2 - Get Map Tile

Service:

Maps

API Version:

2.1

Berlaku untuk: lihat tingkat harga.

Get Map Tiles API memungkinkan pengguna untuk meminta petak peta dalam format vektor atau raster biasanya diintegrasikan ke dalam kontrol peta atau SDK. Beberapa contoh petak peta yang dapat diminta adalah petak peta jalan Azure Maps, petak peta Radar Cuaca real time, atau petak peta yang dibuat menggunakan Azure Maps Creator. Secara default, Azure Maps menggunakan petak peta vektor untuk kontrol peta web (Web SDK) dan Android SDK.

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}

With optional parameters:

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}&timeStamp={timeStamp}&tileSize={tileSize}&language={language}&view={view}

Parameter URI

Name	In	Required	Type	Description
api-version	query	True	string	Nomor versi API Azure Maps. Versi saat ini adalah 2.1
tilesetId	query	True	TilesetID	Tileset adalah kumpulan data raster atau vektor yang dipecah menjadi kisi-kisi seragam petak peta persegi pada tingkat zoom preset. Setiap tileset memiliki tilesetId untuk digunakan saat membuat permintaan. TilesetId untuk tileset yang dibuat menggunakan Azure Maps Creator dihasilkan melalui Tileset Create API. Set petak peta siap pakai yang disediakan oleh Azure Maps tercantum di bawah ini. Misalnya, microsoft.base.
x	query	True	integer int32	Koordinat X petak peta pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1]. Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.
y	query	True	integer int32	Koordinat petak peta Y pada kisi zoom. Nilai harus dalam rentang [0, 2zoom -1]. Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.
zoom	query	True	integer int32	Tingkat perbesar tampilan untuk petak peta yang diinginkan. Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.
language	query		string	Bahasa tempat hasil pencarian harus dikembalikan. Harus menjadi salah satu tag bahasa IETF yang didukung, tidak peka huruf besar/kecil. Saat data dalam bahasa tertentu tidak tersedia untuk bidang tertentu, bahasa default digunakan. Silakan merujuk ke Bahasa yang Didukung untuk detailnya.
tileSize	query		MapTileSize	Ukuran petak peta yang dikembalikan dalam piksel.
timeStamp	query		string date-time	Tanggal dan waktu yang diinginkan dari petak peta yang diminta. Parameter ini harus ditentukan dalam format tanggal-waktu standar (misalnya 2019-11-14T16:03:00-08:00), seperti yang ditentukan oleh ISO 8601. Parameter ini hanya didukung ketika parameter tilesetId diatur ke salah satu nilai di bawah ini. microsoft.weather.infrared.main: Kami menyediakan petak peta hingga 3 jam sebelumnya. Petak peta tersedia dalam interval 10 menit. Kami membulatkan nilai timeStamp ke jangka waktu 10 menit terdekat. microsoft.weather.radar.main: Kami menyediakan petak peta hingga 1,5 jam sebelumnya dan hingga 2 jam di masa mendatang. Petak peta tersedia dalam interval 5 menit. Kami membulatkan nilai timeStamp ke jangka waktu 5 menit terdekat.
view	query		LocalizedMapView	Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan dalam Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang terkait dengan pemetaan, negara tempat peta, gambar, dan data lain dan konten pihak ketiga yang berwenang untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN. Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

Header Permintaan

Name	Required	Type	Description
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan Azure AD. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan Azure AD di Azure Maps lihat artikel berikut ini untuk panduan.

Respons

Name	Type	Description
200 OK	object	Petak peta dikembalikan dari panggilan API yang berhasil. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Headers Content-Type: string
Other Status Codes	ErrorResponse	Terjadi kesalahan tak terduga. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Keamanan

AADToken

Ini adalah Alur OAuth2 Azure Active Directory. Saat dipasangkan dengan kontrol akses berbasis peran Azure, kontrol akses tersebut dapat digunakan untuk mengontrol akses ke Azure Maps REST API. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa Azure Maps akun sumber daya atau sub-sumber daya. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin untuk Azure Maps REST API.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

• Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang diminta akses aplikasi. Ini dapat diperoleh dari API manajemen Peta.

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi direktori Azure Active. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.

• Saat ini, Azure Active Directory v1.0 atau v2.0 mendukung Kantor, Sekolah, dan Tamu tetapi tidak mendukung akun Pribadi.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, saat ini dapat diperlakukan sebagai kunci master ke akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server Azure Maps REST API tempat kunci ini dapat disimpan dengan aman.

Type: apiKey
In: query

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol fine-grain ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

Successful Tile Request

Sample Request

HTTP

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId=microsoft.base&zoom=6&x=10&y=22

Sample Response

Status code:

200

Content-Type: application/vnd.mapbox-vector-tile

Response Body

"binary image string"

Definisi

ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
LocalizedMapView	Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan dalam Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang terkait dengan pemetaan, negara tempat peta, gambar, dan data lain dan konten pihak ketiga yang berwenang untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN. Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.
MapTileSize	Ukuran petak peta yang dikembalikan dalam piksel.
TilesetID	Tileset adalah kumpulan data raster atau vektor yang dipecah menjadi kisi-kisi seragam petak peta persegi pada tingkat zoom preset. Setiap tileset memiliki tilesetId untuk digunakan saat membuat permintaan. TilesetId untuk tileset yang dibuat menggunakan Azure Maps Creator dihasilkan melalui Tileset Create API. Set petak peta siap pakai yang disediakan oleh Azure Maps tercantum di bawah ini. Misalnya, microsoft.base.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name	Type	Description
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Name	Type	Description
error	ErrorDetail	Objek kesalahan.

LocalizedMapView

Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan dalam Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang terkait dengan pemetaan, negara tempat peta, gambar, dan data lain dan konten pihak ketiga yang berwenang untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN.

Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

Name	Type	Description
AE	string	Uni Emirat Arab (Tampilan Arab)
AR	string	Argentina (Tampilan Argentina)
Auto	string	Kembalikan data peta berdasarkan alamat IP permintaan.
BH	string	Bahrain (Tampilan Arab)
IN	string	India (Tampilan India)
IQ	string	Irak (Tampilan Arab)
JO	string	Yordania (Tampilan Arab)
KW	string	Kuwait (Tampilan Arab)
LB	string	Lebanon (Tampilan Arab)
MA	string	Maroko (Tampilan Maroko)
OM	string	Oman (Tampilan Arab)
PK	string	Pakistan (Tampilan Pakistan)
PS	string	Otoritas Palestina (Tampilan Arab)
QA	string	Qatar (Tampilan Arab)
SA	string	Arab Saudi (Tampilan Arab)
SY	string	Suriah (Tampilan Arab)
Unified	string	Tampilan Terpadu (Lainnya)
YE	string	Yaman (Tampilan Arab)

MapTileSize

Ukuran petak peta yang dikembalikan dalam piksel.

Name	Type	Description
256	string	Mengembalikan petak peta 256 kali 256 piksel.
512	string	Mengembalikan petak peta 512 kali 512 piksel.

TilesetID

Tileset adalah kumpulan data raster atau vektor yang dipecah menjadi kisi-kisi seragam petak peta persegi pada tingkat zoom preset. Setiap tileset memiliki tilesetId untuk digunakan saat membuat permintaan. TilesetId untuk tileset yang dibuat menggunakan Azure Maps Creator dihasilkan melalui Tileset Create API. Set petak peta siap pakai yang disediakan oleh Azure Maps tercantum di bawah ini. Misalnya, microsoft.base.

Name	Type	Description
microsoft.base	string	Peta dasar adalah peta standar yang menampilkan jalan, fitur alami dan buatan bersama dengan label untuk fitur-fitur tersebut dalam petak peta vektor. Mendukung tingkat zoom 0 hingga 22. Format: vektor (pbf).
microsoft.base.darkgrey	string	Semua lapisan dengan gaya abu-abu gelap kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.base.hybrid	string	Menampilkan data jalan, batas, dan label dalam petak peta vektor. Mendukung tingkat zoom 0 hingga 22. Format: vektor (pbf).
microsoft.base.hybrid.darkgrey	string	Data jalan, batas, dan label dalam gaya abu-abu gelap kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.base.hybrid.road	string	Jalan, batas, dan label data dalam gaya utama kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.base.labels	string	Menampilkan label untuk jalan, fitur alami dan buatan dalam petak peta vektor. Mendukung tingkat zoom 0 hingga 22. Format: vektor (pbf).
microsoft.base.labels.darkgrey	string	Beri label data dalam gaya abu-abu gelap kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.base.labels.road	string	Beri label data dalam gaya utama kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.base.road	string	Semua lapisan dengan gaya utama kami. Mendukung tingkat zoom 0 hingga 22. Format: raster (png).
microsoft.dem	string	Petak Peta Model Elevasi Digital. Petak peta dalam format GeoTIFF dengan satu pita floating point 32-bit. Petak peta menutupi seluruh daratan Bumi. Beberapa pulau kecil (misalnya, atol) mungkin tidak diwakili secara akurat. Unit vertikal untuk pengukuran tinggi elevasi adalah meter. Nilai elevasi -32767.0 digunakan untuk titik yang tidak memiliki nilai data, paling sering dikembalikan di mana tidak ada landmass (yaitu air). Datum referensi horizontal adalah World Geodetic System 1984 (WGS84-G1150) dan datum referensi vertikal adalah Earth Gravitational Model 2008 (EGM2008). Petak peta adalah persegi 258x258 piksel daripada standar 256 x 256. Ini dilakukan untuk memungkinkan interpolasi nilai yang akurat di tepi petak peta. Dengan demikian ubin yang berdampingan tumpang tindih dengan 1 piksel di semua tepi. Data petak peta berasal dari produk Airbus WorldDEM4Ortho. Daerah perkotaan kira-kira rata turun ke permukaan tanah. Semua area lain diwakili oleh tingkat permukaan objek (misalnya, pohon). Hanya mendukung zoom level 13. Format: raster (tiff).
microsoft.dem.contours	string	Petak peta garis kontur elevasi digital. Dibandingkan dengan opsi microsoft.dem, petak peta ini dalam format vektor dan ditujukan untuk tujuan visualisasi. Petak peta menutupi seluruh daratan Bumi. Beberapa pulau kecil (misalnya, atol) mungkin tidak diwakili secara akurat. Unit vertikal untuk pengukuran tinggi elevasi adalah meter. Datum referensi horizontal adalah World Geodetic System 1984 (WGS84-G1150) dan datum referensi vertikal adalah Earth Gravitational Model 2008 (EGM2008). Data petak peta berasal dari produk Airbus WorldDEM4Ortho. Daerah perkotaan kira-kira rata turun ke permukaan tanah. Semua area lain diwakili oleh tingkat permukaan objek (misalnya, pohon). Mendukung tingkat perbesar tampilan 9 hingga 14. Format: vektor (pbf).
microsoft.imagery	string	Kombinasi citra satelit dan udara. Hanya tersedia dalam SKU harga S1. Mendukung tingkat zoom 1 hingga 19. Format: raster (jpeg).
microsoft.terra.main	string	Lega berteduh dan lapisan terra. Mendukung tingkat perbesar tampilan 0 hingga 6. Format: raster (png).
microsoft.traffic.absolute	string	petak peta lalu lintas absolut di vektor
microsoft.traffic.absolute.main	string	petak peta lalu lintas absolut dalam raster dengan gaya utama kami.
microsoft.traffic.delay	string	petak peta lalu lintas di vektor
microsoft.traffic.delay.main	string	petak peta lalu lintas dalam raster dalam gaya utama kami
microsoft.traffic.incident	string	petak peta insiden di vektor
microsoft.traffic.reduced.main	string	mengurangi petak peta lalu lintas dalam raster dengan gaya utama kami
microsoft.traffic.relative	string	petak peta lalu lintas relatif di vektor
microsoft.traffic.relative.dark	string	petak peta lalu lintas relatif dalam raster dalam gaya gelap kami.
microsoft.traffic.relative.main	string	petak peta lalu lintas relatif dalam raster dengan gaya utama kami.
microsoft.weather.infrared.main	string	Petak peta inframerah cuaca. Gambar Satelit Inframerah terbaru menunjukkan awan berdasarkan suhunya. Silakan lihat informasi cakupan untuk layanan Azure Maps Weather. Untuk mempelajari selengkapnya tentang data Satelit yang dikembalikan, silakan lihat Konsep cuaca. Mendukung tingkat perbesar tampilan 0 hingga 15. Format: raster (png).
microsoft.weather.radar.main	string	Petak peta radar cuaca. Gambar radar cuaca terbaru termasuk area hujan, salju, es dan kondisi campuran. Silakan lihat informasi cakupan untuk layanan Azure Maps Weather. Untuk mempelajari selengkapnya tentang data Radar, silakan lihat Konsep cuaca. Mendukung tingkat perbesar tampilan 0 hingga 15. Format: raster (png).