Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure Maps Web SDK Map Control v1 und Map Control Versionen 2.0.0 bis 2.0.32 sind eingestellt. Aktualisieren Sie alle Anwendungen, die diese Versionen verwenden, auf Map Control v3. Dieser Leitfaden erklärt, wie man die Migration abschließt.
Änderungen verstehen
Bevor Sie mit dem Migrationsprozess beginnen, ist es wichtig, sich mit den wichtigsten Änderungen und Verbesserungen im Web SDK v3 vertraut zu machen. Lesen Sie die Release Notes, um den Umfang der neuen Funktionen zu verstehen.
Aktualisierung der Web-SDK-Version
CDN
Wenn du ein CDN (Content Delivery Network) verwendest, aktualisiere das Stylesheet und die JavaScript-Referenzen im Element head deiner HTML-Dateien.
Vor der Migration: Map Control 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>
Vor der Migration: Map Control v2
Der generische Map Control v2 CDN-Pfad lädt die neueste v2-Version, nicht eine spezifische v2.0.x-Version. Daher bedeutet diese URL allein nicht, dass eine Anwendung eine betroffene Version v2.0.x verwendet:
<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>
Für Anwendungen, die Map Control über npm installieren, prüfen Sie die aufgelöste azure-maps-control Version in der Paketsperrdatei. Versionen von 2.0.0 bis 2.0.32 wurden außer Dienst gestellt.
Nach der Migration: Map Control 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
Wenn du npm verwendest, aktualiere auf die neueste Version der Azure Maps-Steuerung, indem du folgenden Befehl ausführst:
npm install azure-maps-control@latest
Überprüfen Sie Authentifizierungsmethoden (optional)
Um die Sicherheit zu erhöhen, sind ab Version 2 weitere Authentifizierungsmethoden im Web SDK enthalten. Die neuen Methoden umfassen Microsoft Entra-Authentifizierung und Shared Key Authentication. Für weitere Informationen zur Sicherheit von Azure Maps-Webanwendungen siehe Authentifizierung verwalten in Azure Maps.
Testing
Umfassende Tests sind während der Migration unerlässlich. Führen Sie gründliche Tests der Funktionalität, Leistung und Benutzererfahrung Ihrer Anwendung in verschiedenen Browsern und Geräten durch.
Schrittweise Einführung
Betrachten Sie eine schrittweise Einführung für die aktualisierte Version. Gib die migrierte Version für eine kleinere Gruppe von Benutzern oder in einer kontrollierten Umgebung frei, bevor du sie deiner gesamten Nutzerbasis zur Verfügung stellst.
Indem Sie diese Schritte befolgen und Best Practices berücksichtigen, können Sie Ihre Anwendung von Azure Maps Web SDK Map Control v1 oder v2.0.x auf v3 migrieren. Weitere Informationen finden Sie unter den Best Practices des Azure Maps Web SDK.
Nächste Schritte
Erfahren Sie, wie Sie Karten zu Web- und Mobilanwendungen hinzufügen können, indem Sie die clientseitige JavaScript-Bibliothek Map Control in Azure Maps verwenden: