Tutorial: Erstellen von Gebäudeplänen mithilfe von Azure Maps Creator

Artikel
10/24/2023

In diesem Tutorial wird beschrieben, wie Sie Gebäudepläne für die Verwendung in Microsoft Azure Maps erstellen. In diesem Tutorial wird Folgendes veranschaulicht:

Laden Sie Ihr Zeichnungspaket für Gebäudepläne hoch.
Konvertieren Ihres Zeichnungspakets in Kartendaten
Erstellen eines Datasets auf der Grundlage Ihrer Kartendaten
Erstellen eines Kachelsets auf der Grundlage der Daten in Ihrem Dataset
Rufen Sie aus Ihrem Kachelset die Standardkonfigurations-ID ab.

Sie können auch ein Dataset aus einem GeoJSON-Paket erstellen. Weitere Informationen finden Sie unter Erstellen eines Datasets mithilfe eines GeoJSON-Pakets (Vorschau).

Voraussetzungen

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

Wichtig

In diesem Artikel wird die geografische URL us.atlas.microsoft.com verwendet. Wenn Ihr Creator-Dienst nicht in den USA erstellt wurde, müssen Sie eine andere geografische URL verwenden. Weitere Informationen finden Sie unter Zugreifen auf Creator-Dienste.
Ersetzen Sie in den URL-Beispielen {Your-Azure-Maps-Subscription-key} durch Ihren Azure Maps-Abonnementschlüssel.

Hochladen eines Zeichnungspakets

Führen Sie die im Artikel Erstellen der Datenregistrierung beschriebenen Schritte aus, um das GeoJSON-Paket 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. Über udid verweisen Sie aus Ihrem Quellcode und aus den HTTP-Anforderungen auf das GeoJSON-Paket, das Sie in Ihr Azure Storage-Konto hochgeladen haben.

Konvertieren eines Zeichnungspakets

Nach dem Hochladen des Zeichnungspakets verwenden Sie jetzt den udid-Wert für das hochgeladene Paket, um das Paket in Kartendaten zu konvertieren. Die Conversion-API nutzt eine zeitintensive Transaktion, durch die das im Artikel Zeitintensiver Creator-Vorgang definierte Muster implementiert wird.

So konvertieren Sie ein Zeichnungspaket:

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, beispielsweise POST Convert Drawing Package.
Wählen Sie als HTTP-Methode POST aus.
Geben Sie die folgende URL für den Konvertierungsdienst ein. Ersetzen Sie {Your-Azure-Maps-Subscription-key} mit Ihrem Azure Maps-Abonnementschlüssel. Ersetzen Sie udid durch den udid-Wert des hochgeladenen Pakets.
```
https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2023-03-01-preview&udid={udid}&inputType=DWG&dwgPackageVersion=2.0
```
Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus.
Kopieren Sie den Wert des Schlüssels Operation-Location (Vorgangsspeicherort). Er enthält die Status-URL, die Sie verwenden, um den Status der Konvertierung zu überprüfen.

Überprüfen des Status der Zeichnungspaketkonvertierung

Nach Abschluss des Konvertierungsvorgangs wird ein conversionId-Wert zurückgegeben. Sie können auf die Konvertierungs-ID (conversionId) zugreifen, indem Sie den Status des Konvertierungsprozesses für das Zeichnungspaket überprüfen. Anschließend können Sie den conversionId Wert verwenden, um auf die konvertierten Daten zuzugreifen.

So überprüfen Sie den Status des Konvertierungsprozesses und rufen den conversionId-Wert ab

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, beispielsweise GET Conversion Status.
Wählen Sie als HTTP-Methode GET aus.
Geben Sie die Status-URL ein, die Sie im Abschnitt Konvertieren eines Zeichnungspakets kopiert haben. Die Anforderung sollte wie die folgende URL aussehen:
```
https://us.atlas.microsoft.com/conversions/operations/{operationId}?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}
```
Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus.
Kopieren Sie den Wert des Schlüssels Resource-Location. Hierbei handelt es sich um die URL des Ressourcenspeicherorts. Die URL des Ressourcenspeicherorts enthält den eindeutigen Bezeichner (conversionId), der von anderen APIs zum Zugriff auf die konvertierten Kartendaten verwendet wird.

Das Beispielzeichnungspaket sollte ohne Fehler oder Warnungen konvertiert werden. Falls bei Ihrem eigenen Zeichnungspaket Fehler oder Warnungen zurückgegeben werden, enthält die JSON-Antwort einen Link zur Schnellansicht für Zeichnungsfehler. Mithilfe der Schnellansicht für Zeichnungsfehler können Sie Details von Fehlern und Warnungen untersuchen. Empfehlungen zur Behebung von Konvertierungsfehlern und -warnungen finden Sie unter Fehler und Warnungen bei der Zeichnungskonvertierung.

Das folgende JSON-Fragment zeigt ein Beispiel für eine Konvertierungswarnung:

{
    "operationId": "{operationId}",
    "created": "2021-05-19T18:24:28.7922905+00:00",
    "status": "Succeeded",
     "warning": {
        "code": "dwgConversionProblem",
        "details": [
            {
                "code": "warning",
                "details": [
                    {
                        "code": "manifestWarning",
                        "message": "Ignoring unexpected JSON property: unitProperties[0].nonWheelchairAccessible with value False"
                    }
                ]
            }
        ]
    },
    "properties": {
        "diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
    }
}

Erstellen eines Datasets

Ein Dataset ist eine Sammlung von Kartenfeatures wie Gebäuden, Ebenen und Räumen. Verwenden Sie zum Erstellen eines Datasets die Dataseterstellungs-API. Die Dataseterstellungs-API akzeptiert die Konvertierungs-ID (conversionId) für das konvertierte Zeichnungspaket und gibt einen datasetId-Wert für das erstellte Dataset zurück.

So erstellen Sie ein Dataset:

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, z. B. POST Dataset Create.
Wählen Sie die HTTP-Methode POST aus.
Geben Sie die folgende URL für den Datasetdienst ein. Ersetzen Sie {conversionId} durch den conversionId-Wert, den Sie unter Überprüfen des Status der Zeichnungspaketkonvertierung erhalten haben.
```
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&subscription-key={Your-Azure-Maps-Subscription-key}
```
Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus.
Kopieren Sie den Wert des Schlüssels Operation-Location (Vorgangsspeicherort). Er enthält die Status-URL, die Sie verwenden, um den Status des Datasets zu überprüfen.

Überprüfen des Status der Dataseterstellung

So überprüfen Sie den Status der Dataseterstellung und rufen den datasetId-Wert ab

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, beispielsweise GET Dataset Status.
Wählen Sie als HTTP-Methode GET aus.

Geben Sie die Status-URL ein, die Sie im Abschnitt Erstellen eines Datasets kopiert haben. Die Anforderung sollte wie die folgende URL aussehen:

https://us.atlas.microsoft.com/datasets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus. Der Wert des Schlüssels Resource-Location ist die URL des Ressourcenspeicherorts. Die URL des Ressourcenspeicherorts enthält den eindeutigen Bezeichner (datasetId) des Datasets.
Speichern Sie den Wert datasetId, da Sie ihn im nächsten Tutorial verwenden werden.

Erstellen eines Kachelsets

Bei einem Kachelset handelt es sich um eine Gruppe von Vektorkacheln, die auf der Karte gerendert werden. Kachelsets werden auf der Grundlage vorhandener Datasets erstellt. Ein Kachelset ist jedoch unabhängig von dem Dataset, aus dem es stammt. Wenn das Dataset gelöscht wird, ist das Kachelset weiterhin vorhanden.

So erstellen Sie ein Kachelset:

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, z. B. POST Tileset Create.
Wählen Sie die HTTP-Methode POST aus.
Geben Sie die folgende URL für den Kachelsetdienst ein. Ersetzen Sie {datasetId} durch den datasetId-Wert, den Sie im Abschnitt Überprüfen des Status der Dataseterstellung abgerufen haben.
```
https://us.atlas.microsoft.com/tilesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Primary-Subscription-key}
```
Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus.
Kopieren Sie den Wert des Schlüssels Operation-Location (Vorgangsspeicherort). Er enthält die Status-URL, die Sie verwenden, um den Status des Kachelsets zu überprüfen.

Überprüfen des Status der Kachelseterstellung

So überprüfen Sie den Status der Kachelseterstellung und rufen den tilesetId-Wert ab

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, beispielsweise GET Tileset Status.
Wählen Sie als HTTP-Methode GET aus.

Geben Sie die Status-URL ein, die Sie im Abschnitt Erstellen eines Kachelsets kopiert haben. Die Anforderung sollte wie die folgende URL aussehen:

https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

Wählen Sie Send (Senden) aus.
Wählen Sie im Antwortfenster die Registerkarte Headers aus. Der Wert des Schlüssels Resource-Location ist die URL des Ressourcenspeicherorts. Die URL des Ressourcenspeicherorts enthält den eindeutigen Bezeichner (tilesetId) des Datasets.

Abrufen der Kartenkonfiguration (Vorschau)

Nachdem Sie ein Kachelset erstellt haben, können Sie den mapConfigurationId-Wert mithilfe der HTTP-Anforderung tileset get abrufen:

Klicken Sie in der Postman-App auf New (Neu).
Wählen Sie im Fenster Create New (Neu erstellen) die Option HTTP Request (HTTP-Anforderung) aus.
Geben Sie unter Request name einen Namen für die Anforderung ein, beispielsweise GET mapConfigurationId from Tileset.
Wählen Sie als HTTP-Methode GET aus.

Geben Sie die folgende URL für den Kachelsetdienst ein. Übergeben Sie die Kachelset-ID, die Sie im vorherigen Schritt erhalten haben.

https://us.atlas.microsoft.com/tilesets/{tilesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

Wählen Sie Send (Senden) aus.
Der JSON-Code des Kachelsets wird im Text der Antwort angezeigt. Scrollen Sie nach unten, um den mapConfigurationId-Wert anzuzeigen:
```
"defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"
```

Weitere Informationen finden Sie im Artikel zu Konzepten für Gebäudepläne unter Kartenkonfiguration.

Nächste Schritte

Was ist Azure Maps Creator?

Ersteller für Gebäudepläne

Verwenden des Moduls „Indoor Maps“ von Azure Maps mit benutzerdefinierten Formatvorlagen