Wegfindungsdienst für Gebäudepläne (Vorschau)

  • Artikel

Mit dem Wegfindungsdienst von Azure Maps Creator können Sie überall auf Ihrem Gebäudeplan von Ort zu Ort navigieren. Der Dienst nutzt Treppen und Aufzüge, um zwischen den Stockwerken zu navigieren, und bietet Anleitungen, die Sie beim Umgehen physischer Hindernisse unterstützen. In diesem Artikel wird beschrieben, wie Sie auf einem Beispielgebäudeplan einen Pfad von einem Startpunkt zu einem Zielpunkt generieren.

Voraussetzungen

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.
  • In den URL-Beispielen in diesem Artikel müssen Sie Folgendes ausführen:
    • Ersetzen Sie {Your-Azure-Maps-Subscription-key} mit Ihrem Azure Maps-Abonnementschlüssel.
    • Ersetzen Sie {datasetId} durch Ihre datasetId. Weitere Informationen finden Sie im Abschnitt Überprüfen des Status der Dataseterstellung des Tutorials Verwenden von Creator zum Erstellen von Gebäudeplänen.

Erstellen eines Routesets

Ein Routeset ist eine Sammlung von Gebäudeplandaten, die vom Wegfindungsdienst verwendet wird.

Aus dem Dataset wird ein Routeset erstellt. Das Routeset ist vom Dataset unabhängig, d. h., wenn das Dataset gelöscht wird, ist das Routeset weiterhin vorhanden.

Nachdem Sie ein Routeset erstellt haben, können Sie die Wegfindungs-API verwenden, um einen Pfad vom Startpunkt zum Zielpunkt innerhalb der Einrichtung abzurufen.

So erstellen Sie ein Routeset:

  1. Führen Sie die folgende HTTP POST-Anforderung aus:

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

  2. Kopieren Sie den Wert des Schlüssels Operation-Location aus dem Antwortheader.

Der Schlüssel Operation-Location ist die Status-URL, mit der der Status der Routeseterstellung überprüft wird, wie im nächsten Abschnitt gezeigt.

Überprüfen des Status der Routeseterstellung und Abrufen der routesetId

So können Sie den Status der Routeseterstellung überprüfen und die routesetId abrufen:

  1. Führen Sie die folgende HTTP GET-Anforderung aus:

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

    Hinweis

    Rufen Sie die operationId aus dem Operation-Location-Schlüssel im Antwortheader ab, wenn Sie ein neues Routeset erstellen.

  2. Kopieren Sie den Wert des Schlüssels Resource-Location aus dem Antwortheader. Es handelt sich um die URL des Ressourcenspeicherorts und enthält die routesetId:

    https://us.atlas.microsoft.com/routesets/**675ce646-f405-03be-302e-0d22bcfe17e8**?api-version=2023-03-01-preview

Notieren Sie sich den Namen in routesetId. Sie ist in allen Anforderungen zur Wegfindung erforderlich, wenn Sie die Einrichtungs-ID abrufen.

Abrufen der Einrichtungs-ID

Die facilityId, eine Eigenschaft des Routesets, ist ein erforderlicher Parameter bei der Suche nach einem Wegfindungspfad. Rufen Sie die facilityId ab, indem Sie das Routeset abfragen.

  1. Führen Sie die folgende HTTP GET-Anforderung aus:

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

  2. Die facilityId ist eine Eigenschaft des facilityDetails-Objekts, die Sie im Antworttext der Routesetanforderung finden können, die im folgenden Beispiel FCL43 lautet:

{
    "routeSetId": "675ce646-f405-03be-302e-0d22bcfe17e8",
    "dataSetId": "eec3825c-620f-13e1-b469-85d2767c8a41",
    "created": "10/10/2022 6:58:32 PM +00:00",
    "facilityDetails": [
        {
            "facilityId": "FCL43",
            "levelOrdinals": [
                0,
                1
            ]
        }
    ],
    "creationMode": "Wall",
    "ontology": "facility-2.0"
}

Abrufen eines Wegfindungspfads

Verwenden Sie die Wegfindungs-API, um einen Pfad aus dem Routeset zu generieren, das Sie im vorherigen Abschnitt erstellt haben. Die Wegfindungs-API erfordert eine Abfrage, die Start- und Endpunkte in einem Gebäudeplan sowie Ordnungszahlen auf Stockwerkebene enthält. Weitere Informationen zur Creator-Wegfindung finden Sie unter Wegfindung im Artikel zu Konzepten.

So erstellen Sie eine Wegfindungsabfrage:

  1. Führen Sie die folgende HTTP GET-Anforderung aus (ersetzen Sie {routesetId} durch die routesetId, die im Abschnitt Überprüfen des Routeseterstellungsstatus abgerufen wurde, und {facilityId} durch die in Abrufen der Facility-ID abgerufene facilityId):

    https://us.atlas.microsoft.com/wayfinding/path?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}&routesetid={routeset-ID}&facilityid={facility-ID}&fromPoint={lat,lon}&fromLevel={from-level}&toPoint={lat,lon}&toLevel={to-level}&minWidth={minimun-width}

    Tipp

    Der AvoidFeatures-Parameter kann verwendet werden, um etwas für den Wegfindungsdienst anzugeben, das bei der Bestimmung des Pfads vermieden werden soll, z. B. Aufzüge oder Treppen.

  2. Die Details des Pfads und seiner Etappen werden im Textkörper der Antwort angezeigt.

Die Zusammenfassung zeigt die geschätzte Reisezeit in Sekunden für den gesamten Weg an. Darüber hinaus wird die geschätzte Zeit für jeden Abschnitt der Reise am Anfang jeder Etappe angezeigt.

Der Wegfindungsdienst berechnet den Pfad über bestimmte dazwischen liegende Punkte. Jeder Punkt wird zusammen mit seinen Breiten- und Längengradangaben angezeigt.