Panduan migrasi Azure Peta Web SDK
Terima kasih telah memilih Azure Peta Web SDK untuk kebutuhan pemetaan Anda. Panduan migrasi ini membantu Anda beralih dari v1 dan v2 ke v3, memungkinkan Anda memanfaatkan fitur dan penyempurnaan terbaru.
Memahami perubahan
Sebelum Anda memulai proses migrasi, penting untuk membiasakan diri dengan perubahan dan peningkatan utama yang diperkenalkan di Web SDK v3. Tinjau catatan rilis untuk memahami cakupan fitur baru.
Memperbarui versi Web SDK
CDN
Jika Anda menggunakan CDN (jaringan pengiriman konten), perbarui referensi ke lembar gaya v3 dan JavaScript dalam head elemen file HTML Anda.
v1
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/css/atlas.min.css?api-version=1" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/js/atlas.min.js?api-version=1"></script>
v2
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>
v3
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>
npm
Jika Anda menggunakan npm, perbarui ke kontrol Azure Peta terbaru dengan menjalankan perintah berikut:
npm install azure-maps-control@latest
Meninjau metode autentikasi (opsional)
Untuk meningkatkan keamanan, lebih banyak metode autentikasi disertakan dalam Web SDK mulai dari v2. Metode baru mencakup autentikasi Microsoft Entra dan Autentikasi Kunci Bersama. Untuk informasi selengkapnya tentang keamanan aplikasi web Azure Peta, lihat Mengelola Autentikasi di Azure Peta.
Pengujian
Pengujian komprehensif sangat penting selama migrasi. Lakukan pengujian menyeluruh tentang fungsionalitas, performa, dan pengalaman pengguna aplikasi Anda di browser dan perangkat yang berbeda.
Peluncuran Bertahap
Pertimbangkan strategi peluncuran bertahap untuk versi yang diperbarui. Rilis versi yang dimigrasikan ke grup pengguna yang lebih kecil atau di lingkungan terkontrol sebelum membuatnya tersedia untuk seluruh basis pengguna Anda.
Dengan mengikuti langkah-langkah ini dan mempertimbangkan praktik terbaik, Anda dapat berhasil memigrasikan aplikasi Anda dari Azure Peta Web SDK v1 dan v2 ke v3. Rangkul kemampuan dan peningkatan baru yang ditawarkan oleh versi terbaru sambil memastikan transisi yang lancar dan mulus untuk pengguna Anda. Untuk informasi selengkapnya, lihat Praktik terbaik Azure Peta Web SDK.
Langkah berikutnya
Pelajari cara menambahkan peta ke aplikasi web dan seluler menggunakan pustaka JavaScript sisi klien Kontrol Peta di Azure Peta: