Conversion

Operations

Convert

Gilt für: Siehe Tarife.

Creator ermöglicht die Entwicklung von Anwendungen basierend auf Ihren privaten Gebäudeplandaten mithilfe von Azure Karten API und SDK. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Karten Creator gelten.

Mit der Konvertierungs-API kann der Aufrufer einen Satz von DWG-Entwurfsdateien als gezipptes Zeichnungspaket in Azure Karten importieren. Das Zeichnungspaket sollte zuerst mit dem Azure Karten Data Servicehochgeladen werden. Verwenden Sie nach dem Hochladen die udid von der Daten-Hochladen-API zurückgegebene , um diese Konvertierungs-API aufzurufen.

Konvertieren eines DWG-Pakets

Die Konvertierungs-API führt eine Anforderung mit langer Ausführungslaufzeitaus.

Debuggen von Problemen mit DWG-Paketen

Wenn während des Konvertierungsprozesses Probleme mit dem DWG-Paket auftreten, werden fehler und Warnungen in der Antwort zusammen mit einem Diagnosepaket bereitgestellt, um diese Probleme zu visualisieren und zu diagnostizieren. Falls Probleme mit Ihrem DWG-Paket auftreten, gibt der Hier beschriebene Status des Konvertierungsvorgangs den Speicherort des Diagnosepakets zurück, das vom Aufrufer heruntergeladen werden kann, um diese Probleme zu visualisieren und zu diagnostizieren. Der Speicherort des Diagnosepakets befindet sich im Abschnitt eigenschaften der Statusantwort des Konvertierungsvorgangs und sieht wie folgt aus:

{
    "properties": {
        "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapdata/{DiagnosticPackageId}?api-version=1.0"                
    }            
}

Das Diagnosepaket kann heruntergeladen werden, indem eine HTTP GET Anforderung für ausgeführt diagnosticPackageLocation wird. Weitere Informationen zur Verwendung des Tools zum Visualisieren und Diagnostizieren aller Fehler und Warnungen finden Sie unter Drawing Error Visualizer.

Ein Konvertierungsvorgang wird als erfolgreich markiert, wenn null oder mehr Warnungen vorhanden sind, aber als fehlerhaft markiert wird, wenn Fehler auftreten.

Delete

Gilt für: Siehe Tarife.

Creator ermöglicht die Entwicklung von Anwendungen basierend auf Ihren privaten Gebäudeplandaten mithilfe von Azure Karten API und SDK. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Karten Creator gelten.

Mit dieser API kann der Aufrufer alle Datenkonvertierungen löschen, die zuvor mit der Konvertierungs-APIerstellt wurden.

Löschanforderung übermitteln

Um Ihre Konvertierungsdaten zu löschen, geben Sie eine DELETE Anforderung aus, in der der Pfad die conversionId der zu löschende Daten enthält.

Antwort zum Löschen von Konvertierungen

Die API zum Löschen von Konvertierungen gibt eine 204 No Content HTTP-Antwort mit einem leeren Text zurück, wenn die konvertierten Datenressourcen erfolgreich gelöscht wurden.

Eine 400 Bad Request HTTP-Fehlerantwort wird zurückgegeben, wenn keine Ressource gefunden wird, die dem übergebenen zugeordnet conversionId ist.

Get

Gilt für: Siehe Tarife.

Creator ermöglicht die Entwicklung von Anwendungen basierend auf Ihren privaten Gebäudeplandaten mithilfe von Azure Karten API und SDK. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Karten Creator gelten.

Mit dieser API kann der Aufrufer eine erfolgreiche Datenkonvertierung abrufen, die zuvor mit der Konvertierungs-APIübermittelt wurde.

Get Operation

Dieser Pfad wird von einem Aufruf von POST /conversions abgerufen. Während der Bearbeitung wird ein http200-Header ohne zusätzliche Header zurückgegeben, gefolgt von einem http200-Header mit Resource-Location,sobald er erfolgreich abgeschlossen wurde.

List

Gilt für: Siehe Tarife.

Creator ermöglicht die Entwicklung von Anwendungen basierend auf Ihren privaten Gebäudeplandaten mithilfe von Azure Karten API und SDK. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Karten Creator gelten.

Mit dieser API kann der Aufrufer eine Liste aller erfolgreichen Datenkonvertierungen abrufen, die zuvor mit der Konvertierungs-APIübermittelt wurden.

Senden einer Listenanforderung

Um alle erfolgreichen Konvertierungen aufzulisten, geben Sie eine GET Anforderung ohne zusätzliche Parameter aus.

Auflisten der Datenantwort

Die Konvertierungslisten-API gibt die vollständige Liste aller Konvertierungsdetails im json Format zurück.

Hier ist eine Beispielantwort, die die Details von zwei erfolgreichen Konvertierungsanforderungen zurückgibt:


{
    "conversions": 
    [
        {
            "conversionId": "54398242-ea6c-1f31-4fa6-79b1ae0fc24d",
            "udid": "31838736-8b84-11ea-bc55-0242ac130003",
            "created": "5/19/2020 9:00:00 AM +00:00",
            "description": "User provided description.",
            "featureCounts": {
                "DIR": 1,
                "LVL": 3,
                "FCL": 1,
                "UNIT": 150,
                "CTG": 8,
                "AEL": 0,
                "OPN": 10
            }
        },
        {
            "conversionId": "2acf7d32-8b84-11ea-bc55-0242ac130003",
            "udid": "1214bc58-8b84-11ea-bc55-0242ac1300039",
            "created": "5/19/2020 9:00:00 AM +00:00",
            "description": "User provided description.",
            "featureCounts": {
                "DIR": 1,
                "LVL": 3,
                "FCL": 1,
                "UNIT": 150,
                "CTG": 8,
                "AEL": 0,
                "OPN": 10
            }
        }
    ]
}