Erstellen eines Featurezustandssets

  • Artikel

Featurezustandssets definieren dynamische Eigenschaften und Werte für bestimmte Features, die dies unterstützen. In diesem Artikel wird erläutert, wie Sie einen Zustandsset erstellen, das Werte und entsprechende Stile für eine Eigenschaft definiert und den Zustand einer Eigenschaft ändert.

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 ersetzen:
    • {Azure-Maps-Subscription-key} mit Ihrem Azure Maps-Abonnementschlüssel.
    • {datasetId} durch die datasetId, die im Abschnitt Überprüfen des Status der Dataseterstellung des Tutorials Verwenden von Creator zum Erstellen von Gebäudeplänen abgerufen wurde

Ein Featurezustandsset erstellen

So erstellen Sie ein Zustandsset:

Erstellen Sie eine neue HTTP POST-Anforderung, die die Zustandsset-API verwendet. Die Anforderung sollte wie die folgende URL aussehen:

https://us.atlas.microsoft.com/featurestatesets?api-version=2.0&datasetId={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}

Legen Sie als Nächstes Content-Type auf application/json in der Kopfzeile der Anforderung auf fest.

Wenn Sie ein Tool wie Postman verwenden, sollte es wie folgt aussehen:

A screenshot of Postman showing the Header tab of the POST request that shows the Content Type Key with a value of application forward slash json.

Schließen Sie schließlich im Textkörper der HTTP-Anforderung die Formatvorlageninformationen im unformatierten JSON-Format ein. Damit werden der occupied-Eigenschaft je nach ihrem Wert unterschiedliche Farben zugewiesen:

{
    "styles":[
        {
            "keyname":"occupied",
            "type":"boolean",
            "rules":[
            {
                "true":"#FF0000",
                "false":"#00FF00"
            }
            ]
        }
    ]
}

Kopieren Sie nach erfolgreicher Antwortrückgabe die Zustandsset-ID (statesetId) aus dem Antworttext. Die Zustandsset-ID (statesetId) wird im nächsten Abschnitt verwendet, um den Zustand der Eigenschaft occupancy (Auslastung) der Einheit mit der Feature-ID (id) „UNIT26“ zu ändern. Wenn Sie Postman verwenden, sieht das folgendermaßen aus:

A screenshot of Postman showing the resource Stateset ID value in the responses body.

Aktualisieren eines Featurezustands

In diesem Abschnitt erfahren Sie, wie Sie den occupied-Zustand der Einheit mit dem Feature id „UNIT26“ aktualisieren. Erstellen Sie zum Aktualisieren des occupied-Zustands eine neue HTTP-PUT-Anforderung, die die Featurezustandssets-API aufruft. Die Anforderung sollte in etwa wie die folgende URL aussehen (ersetzen Sie {statesetId} durch statesetId, die Sie im Schritt Erstellen eines Featurezustandssets erhalten haben):

https://us.atlas.microsoft.com/featurestatesets/{statesetId}/featureStates/UNIT26?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}

Legen Sie als Nächstes Content-Type auf application/json in der Kopfzeile der Anforderung auf fest.

Wenn Sie ein Tool wie Postman verwenden, sollte es wie folgt aussehen:

A screenshot of the header tab information for stateset creation.

Schließen Sie schließlich im Textkörper der HTTP-Anforderung die Formatvorlageninformationen im unformatierten JSON-Format ein. Damit werden der occupied-Eigenschaft je nach ihrem Wert unterschiedliche Farben zugewiesen:

{
    "states": [
        {
            "keyName": "occupied",
            "value": true,
            "eventTimestamp": "2020-11-14T17:10:20"
        }
    ]
}

Hinweis

Die Aktualisierung wird nur gespeichert, wenn der Zeitstempel der Bereitstellung nach dem Zeitstempel der vorherigen Anforderung liegt.

Sobald die HTTP-Anforderung gesendet wurde und das Update abgeschlossen ist, erhalten Sie einen 200 OK-HTTP-Statuscode. Falls Sie dynamische Stile für einen Gebäudeplan implementiert haben, wird die Aktualisierung zum angegebenen Zeitstempel auf Ihrer Karte gerendert.

Zusätzliche Informationen

Nächste Schritte

Erfahren Sie, wie Sie dynamische Formatierung für Gebäudepläne implementieren.

dynamische Formatierung