Verwenden der Azure Maps-Schnellansicht für Zeichnungsfehler mit Creator

  • Artikel

Die Schnellansicht für Zeichnungsfehler ist eine eigenständige Webanwendung zum Anzeigen von Warnungen und Fehlern im Zusammenhang mit Zeichnungspaketen, die im Zuge des Konvertierungsprozesses erkannt wurden. Bei der Webanwendung für die Fehlerschnellansicht handelt es sich um eine statische Seite, die ohne Internetverbindung verwendet werden kann. Die Fehlerschnellansicht kann zur Behebung von Fehlern und Warnungen verwendet werden, um die Anforderungen für Zeichnungspakete zu erfüllen. Im Falle eines erkannten Fehlers wird von der Azure Maps-Konvertierungs-API eine Antwort mit einem Link zur Fehlerschnellansicht zurückgegeben.

Voraussetzungen

In diesem Tutorial wird die Anwendung Postman verwendet. Sie können aber auch eine andere API-Entwicklungsumgebung nutzen.

Download

  1. Führen Sie die im Artikel Erstellen der Datenregistrierung beschriebenen Schritte aus, um das Zeichnungspaket in Ihr Azure Storage-Konto hochzuladen und dann in Ihrem Azure Maps-Konto zu registrieren.

    Wichtig

    Notieren Sie sich unbedingt den Wert des eindeutigen Bezeichners (udid), da Sie ihn benötigen werden. Mit udid verweisen Sie aus Ihrem Quellcode und aus den HTTP-Anforderungen auf das Zeichnungspaket, das Sie in Ihr Azure Storage-Konto hochgeladen haben.

  2. Verwenden Sie nach dem Hochladen des Zeichnungspakets udid für das hochgeladene Paket, um das Paket in Kartendaten zu konvertieren. Die Schritte zum Konvertieren eines Pakets finden Sie unter Konvertieren eines Zeichnungspakets.

    Hinweis

    Nach erfolgreichem Abschluss des Konvertierungsvorgangs wird kein Link zum Tool für die Fehlerschnellansicht zurückgegeben.

  3. Sehen Sie sich in der Postman-Anwendung auf der Registerkarte Headers (Header) die von der Konvertierungs-API zurückgegebene Eigenschaft diagnosticPackageLocation an. Die Antwort sollte in etwa wie der folgende JSON-Code aussehen:

    {
    "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
    "created": "2020-04-22T19:39:54.9518496+00:00",
    "status": "Failed",
    "properties": {
        "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=2.0"
    }
}

  4. Laden Sie die Schnellansicht für Zeichnungspaketfehler herunter, indem Sie eine Anforderung vom Typ HTTP-GET an die URL diagnosticPackageLocation senden.

Einrichten

Das heruntergeladene ZIP-Paket aus dem diagnosticPackageLocation-Link enthält die folgenden beiden Dateien.

  • VisualizationTool.zip: Enthält den Quellcode, die Medien und die Webseite für die Schnellansicht für Zeichnungsfehler.
  • ConversionWarningsAndErrors.jsauf: Enthält eine formatierte Liste mit Warnungen, Fehlern und anderen Details, die von der Schnellansicht für Zeichnungsfehler verwendet werden.

Entzippen Sie den Ordner VisualizationTool.zip. Er enthält folgende Elemente:

  • Ordner assets: Bilder und Mediendateien
  • Ordner static: Quellcode
  • Datei index.html: die Webanwendung

Öffnen Sie die Datei index.html mit einer der im Anschluss angegebenen Browserversionen mit der entsprechenden Versionsnummer. Sie können auch eine andere Version verwenden, sofern diese ein vergleichbar kompatibles Verhalten wie die aufgeführte Version bietet.

  • Microsoft Edge 80
  • Safari 13
  • Chrome 80
  • Firefox 74

Verwenden des Schnellansichtstools für Zeichnungsfehler

Nachdem Sie das Schnellansichtstool für Zeichnungsfehler gestartet haben, wird die Uploadseite angezeigt. Die Uploadseite enthält ein Drag & Drop-Feld. Das Drag & Drop-Feld kann auch als Schaltfläche zum Starten eines Datei-Explorer-Dialogfelds verwendet werden.

Drawing Error Visualizer App - Start Page

Die Datei ConversionWarningsAndErrors.json wurde am Stamm des heruntergeladenen Verzeichnisses platziert. Um die ConversionWarningsAndErrors.json zu laden, ziehen Sie die Datei per Drag & Drop in das Feld. Wählen Sie alternativ das Feld aus, suchen Sie die Datei im File Explorer dialogue, und laden Sie sie hoch.

Drawing Error Visualizer App - Drag and drop to load data

Die Datei ConversionWarningsAndErrors.json enthält eine Liste Ihrer Zeichnungspaketfehler und -warnungen. Um ausführliche Informationen zu einem Fehler oder einer Warnung anzuzeigen, wählen Sie den Link Details aus. Daraufhin wird unter der Liste ein entsprechender Abschnitt angezeigt. Nun können Sie zu den einzelnen Fehlern navigieren, um weitere Informationen zur Fehlerbehebung zu erhalten.

Drawing Error Visualizer App - Errors and Warnings

Nächste Schritte

Weitere Informationen finden Sie unter:

Was ist Azure Maps Creator?

Creator für Gebäudepläne