Teilen über


Migrationsleitfaden für das Azure Maps Web SDK

Vielen Dank, dass Sie das Azure Maps Web SDK für Ihre Zuordnungsanforderungen ausgewählt haben. Dieser Migrationsleitfaden hilft Ihnen bei der Umstellung von v1 bzw. v2 auf v3, um die neuesten Features und Verbesserungen nutzen zu können.

Wichtige Änderungen

Bevor Sie mit dem Migrationsprozess beginnen, ist es wichtig, sich mit den wichtigsten Änderungen und Verbesserungen vertraut zu machen, die im Web SDK v3 eingeführt wurden. Lesen Sie die Versionshinweise, um sich einen Überblick über die neuen Features zu verschaffen.

Aktualisieren der Web SDK-Version

CDN

Wenn Sie ein CDN (Content Delivery Network) verwenden, aktualisieren Sie im head-Element Ihrer HTML-Dateien die Verweise auf das v3-Stylesheet und auf JavaScript.

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

Wenn Sie npm verwenden, aktualisieren Sie auf das neueste Azure Maps-Steuerelement, indem Sie den folgenden Befehl ausführen:

npm install azure-maps-control@latest

Überprüfen der Authentifizierungsmethoden (optional)

Ab v2 sind weitere Authentifizierungsmethoden im Web SDK enthalten, um für mehr Sicherheit zu sorgen. Zu den neuen Methoden gehören die Microsoft Entra-Authentifizierung und die Authentifizierung mit gemeinsam verwendetem Schlüssel. Weitere Informationen zur Sicherheit in Azure Maps-Webanwendungen finden Sie unter Verwalten der Authentifizierung in Azure Maps.

Testen

Umfassende Tests sind während der Migration unerlässlich. Testen Sie Funktionalität, Leistung und Benutzererlebnis Ihrer Anwendung gründlich in verschiedenen Browsern und auf unterschiedlichen Geräten.

Schrittweiser Rollout

Erwägen Sie eine schrittweise Rolloutstrategie für die aktualisierte Version. Geben Sie die migrierte Version für eine kleinere Gruppe von Benutzer*innen oder in einer kontrollierten Umgebung frei, bevor Sie sie für Ihre gesamte Benutzerbasis verfügbar machen.

Mit diesen Schritten und den entsprechenden bewährten Methoden können Sie Ihre Anwendung erfolgreich von v1 bzw. v2 des Azure Maps Web SDK zu v3 migrieren. Nutzen Sie die neuen Funktionen und Verbesserungen der neuesten Version, und sorgen Sie gleichzeitig für einen reibungslosen und nahtlosen Übergang für Ihre Benutzer*innen. Weitere Informationen finden Sie unter Best Practices für das Azure Maps-Web-SDK.

Nächste Schritte

Erfahren Sie, wie Sie mit der clientseitigen JavaScript-Bibliothek Map Control in Azure Maps Karten zu Web- und Mobilanwendungen hinzufügen können: