Azure Haritalar Web SDK'sı geçiş kılavuzu
Eşleme gereksinimleriniz için Azure Haritalar Web SDK'sını seçtiğiniz için teşekkür ederiz. Bu geçiş kılavuzu, v1 ve v2'den v3'e geçiş yapmanızı sağlayarak en son özelliklerden ve geliştirmelerden yararlanmanıza yardımcı olur.
Değişiklikleri anlama
Geçiş işlemine başlamadan önce, Web SDK v3'te sunulan önemli değişiklikler ve geliştirmeler hakkında bilgi sahibi olmanız önemlidir. Yeni özelliklerin kapsamını kavramak için sürüm notlarını gözden geçirin.
Web SDK sürümünü güncelleştirme
CDN
CDN (içerik teslim ağı) kullanıyorsanız, HTML dosyalarınızın öğesinde v3 stil sayfasına ve JavaScript'e head başvuruları güncelleştirin.
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
npm kullanıyorsanız aşağıdaki komutu çalıştırarak en son Azure Haritalar denetimine güncelleştirin:
npm install azure-maps-control@latest
Kimlik doğrulama yöntemlerini gözden geçirme (isteğe bağlı)
Güvenliği geliştirmek için, v2'den başlayarak Web SDK'sına daha fazla kimlik doğrulama yöntemi eklenir. Yeni yöntemler Arasında Microsoft Entra kimlik doğrulaması ve Paylaşılan Anahtar Kimlik Doğrulaması yer alır. Azure Haritalar web uygulaması güvenliği hakkında daha fazla bilgi için bkz. Azure Haritalar kimlik doğrulamasını yönetme.
Test Etme
Kapsamlı test, geçiş sırasında gereklidir. Farklı tarayıcılarda ve cihazlarda uygulamanızın işlevselliğini, performansını ve kullanıcı deneyimini kapsamlı bir şekilde test edin.
Aşamalı Dağıtım
Güncelleştirilmiş sürüm için aşamalı bir dağıtım stratejisini göz önünde bulundurun. Geçirilen sürümü tüm kullanıcı tabanınız için kullanılabilir hale getirmeden önce daha küçük bir kullanıcı grubuna veya denetimli bir ortama bırakın.
Bu adımları izleyerek ve en iyi yöntemleri göz önünde bulundurarak uygulamanızı Azure Haritalar Web SDK v1 ve v2'den v3'e başarıyla geçirebilirsiniz. Kullanıcılarınız için sorunsuz ve sorunsuz bir geçiş sağlarken en son sürüm tarafından sunulan yeni özellikleri ve iyileştirmeleri benimseyin. Daha fazla bilgi için bkz. Azure Haritalar Web SDK'sı en iyi yöntemleri.
Sonraki adımlar
Azure Haritalar'da Harita Denetimi istemci tarafı JavaScript kitaplığını kullanarak web ve mobil uygulamalara haritalar eklemeyi öğrenin: