Freigeben über


Erstellen benutzerdefinierte Stile für Gebäudepläne (Vorschau)

Hinweis

Einstellung von Azure Maps Creator

Der Gebäudeplandienst Azure Maps Creator ist veraltet und wird am 30. September 2025 eingestellt. Weitere Informationen finden Sie unter Ankündigung zum Ende des Lebenszyklus von Azure Maps Creator.

Wenn Sie mit Azure Maps Creator einen Gebäudeplan erstellen, werden Standardstile angewendet. In diesem Artikel wird erläutert, wie Sie diese Gestaltungselemente anpassen.

Voraussetzungen

Erstellen benutzerdefinierter Stile mithilfe des visuellen Editors von Creator

Es ist zwar möglich, die Stile Ihrer Gebäudepläne mit der Rest-API von Creator zu ändern, aber Creator bietet auch einen visuellen Stil-Editor, mit dem Sie benutzerdefinierte Stile erstellen können, ohne programmieren zu müssen. In diesem Artikel geht es ausschließlich um das Erstellen benutzerdefinierter Stile mit diesem Stil-Editor.

Öffnen des Stils

Wenn im Dienst Azure Maps Creator ein Gebäudeplan erstellt wird, werden automatisch Standardstile für Sie erstellt. Öffnen Sie diesen Standardstil, um die Stilelemente Ihres Gebäudeplans anzupassen.

Öffnen Sie den Stil-Editor, und wählen Sie auf der Symbolleistenschaltfläche Öffnen aus.

Screenshot des Menüs „Öffnen“ im visuellen Stil-Editor.

Das Dialogfeld Stil öffnen wird geöffnet.

Geben Sie in das Feld Azure Maps-Abonnementschlüssel eingeben Ihren Abonnementschlüssel ein.

Wählen Sie als Nächstes in der Dropdownliste die mit Ihrem Abonnementschlüssel verknüpfte Region aus.

Screenshot des Dialogfelds „Öffnen“ im visuellen Stil-Editor.

Wählen Sie die Schaltfläche Kartenkonfigurationsliste abrufen aus, um eine Liste aller Kartenkonfigurationen abzurufen, die der aktiven Creator-Ressource zugeordnet sind.

Screenshot des Dialogfelds „Stil öffnen“ im visuellen Stil-Editor, in dem die Dropdownliste „Kartenkonfiguration auswählen“ hervorgehoben ist.

Hinweis

Wenn die Kartenkonfiguration im Rahmen eines benutzerdefinierten Stils erstellt wurde und über einen benutzerseitig angegebenen Alias verfügt, wird dieser Alias in der Dropdownliste „Kartenkonfiguration“ angezeigt. Andernfalls wird einfach die mapConfigurationId angezeigt. Die standardmäßige Kartenkonfigurations-ID für ein bestimmtes Kachelset finden Sie mit der HTTP-Anforderung tileset get und durch Übergeben der Kachelset-ID:

https://{geography}.atlas.microsoft.com/tilesets/{tilesetId}?2023-03-01-preview

Die mapConfigurationId wird im Textkörper der Antwort zurückgegeben, z. B.:

"defaultMapConfigurationId": "68d74ad9-4f84-99ce-06bb-19f487e8e692"

Nachdem die gewünschte Kartenkonfiguration ausgewählt wurde, wird die Dropdownliste der Stile angezeigt.

Nachdem Sie den gewünschten Stil ausgewählt haben, wählen Sie die Schaltfläche Ausgewählten Stil laden aus.

Informationen zum Dialogfeld „Stil öffnen“

Screenshot des Dialogfelds „Stil öffnen“ im visuellen Stil-Editor, mit nummerierten Bearbeitungsfeldern, wobei jede Nummer mit den Nummern in der folgenden Tabelle korreliert.

# BESCHREIBUNG
1 Der Abonnementschlüssel Ihres Azure Maps-Kontos
2 Wählen Sie die Region des Azure Maps-Kontos aus.
3 Eine Liste der IDs und Aliase der Kartenkonfiguration.
4 Eine Liste der Stile, die der ausgewählten Kartenkonfiguration zugeordnet sind.

Ändern des Stils

Sobald Ihr Stil im Visual-Editor geöffnet ist, können Sie damit beginnen, die verschiedenen Elemente Ihres Gebäudeplans zu ändern, z. B. die Hintergrundfarben von Konferenzräumen, Büros oder Toiletten. Sie können auch die Schriftgröße für Bezeichnungen wie z. B. Büronummern ändern und festlegen, was auf verschiedenen Zoomebenen gezeigt wird.

Hintergrundfarbe ändern

Um die Hintergrundfarbe für alle Einheiten auf der angegebenen Ebene zu ändern, platzieren Sie den Mauszeiger auf die gewünschte Einheit und wählen sie mit der linken Maustaste aus. Es wird ein Popupmenü mit den Ebenen angezeigt, die den Kategorien zugeordnet sind, denen wiederum die Einheit zugeordnet ist. Sobald Sie die Ebene ausgewählt haben, deren Stileigenschaften Sie ändern möchten, ist diese Ebene im linken Bereich zur Änderung bereit.

Screenshot des Dialogfelds für die Ebene der Einheit im visuellen Stil-Editor.

Öffnen Sie die Farbpalette, und wählen Sie die Farbe aus, in die Sie die gewählte Einheit ändern möchten.

Screenshot der Farbpalette im visuellen Stil-Editor.

Basiskarte

Die Dropdownliste „Basiskarte“ auf der Symbolleiste des visuellen Editors enthält eine Liste von Basiskartenstilen, die die Stilattribute der Basiskarte beeinflussen, zu der Ihr Gebäudeplan gehört. Die Stilelemente Ihres Gebäudeplans ändern sich nicht, aber Sie können sehen, wie Ihr Plan mit den verschiedenen Basiskarten aussieht.

Screenshot der Dropdownliste „Basiskarten“ auf der Symbolleiste des visuellen Editors.

Speichern benutzerdefinierter Stile

Sobald Sie die gewünschten Änderungen an Ihren Stilen vorgenommen haben, speichern Sie die Änderungen in Ihrer Creator-Ressource. Sie können Ihren Stil mit den Änderungen überschreiben oder einen neuen Stil erstellen.

Wählen Sie auf der Symbolleiste die Schaltfläche Speichern aus, um Ihre Änderungen zu speichern.

Screenshot des Menüs „Speichern“ im visuellen Stil-Editor.

Daraufhin wird das Dialogfeld Stil- und Kartenkonfiguration hochladen angezeigt:

Screenshot des Dialogfelds „Stil- und Kartenkonfiguration hochladen“ im visuellen Stil-Editor.

In der folgenden Tabelle werden die vier Felder beschrieben, die Ihnen angezeigt werden.

Eigenschaft BESCHREIBUNG
Stilbeschreibung Eine benutzerdefinierte Beschreibung für dieses Stils.
Beschreibung der Kartenkonfiguration Eine benutzerdefinierte Beschreibung dieser Kartenkonfiguration.
Alias der Kartenkonfiguration Ein Alias zum Verweisen auf diese Kartenkonfiguration.
Bei programmgesteuerten Verweisen wird über die Kartenkonfigurations-ID auf die Kartenkonfiguration verwiesen, wenn kein Alias angegeben ist.

Wissenswertes zu Aliasen:

  1. Können mit alphanumerischen Zeichen (0-9, a-z, A-Z), Bindestrichen (-) und Unterstrichen (_) benannt werden.
  2. Kann anstelle der ID dieses Objekts zum Verweisen auf die zugrunde liegende Kartenkonfiguration verwendet werden. Dies ist besonders wichtig, da die Kartenkonfiguration nicht aktualisiert werden kann. Das bedeutet, dass bei jedem Speichern von Änderungen eine neue ID generiert wird. Der Alias kann aber unverändert bleiben, wodurch Verweise darauf weniger fehleranfällig sind, wenn die Konfiguration mehrfach geändert wurde.

Warnung

Duplizierte Aliase sind nicht zulässig. Bei Verwendung des Alias einer vorhandenen Kartenkonfiguration wird die Kartenkonfiguration, auf die der Alias verweist, überschrieben, die vorhandene Kartenkonfiguration wird gelöscht, und Verweise auf diese ID führen zu Fehlern. Weitere Informationen finden Sie unter Kartenkonfiguration im Artikel zu Konzepten.

Nachdem Sie die Werte in die einzelnen Pflichtfelder eingegeben haben, wählen Sie die Schaltfläche Kartenkonfiguration hochladen aus, um die Stil- und Kartenkonfigurationsdaten in Ihrer Creator-Ressource zu speichern.

Nachdem Sie Ihre benutzerdefinierten Stile erfolgreich hochgeladen haben, werden im Dialogfeld Upload abgeschlossen die Werte für die Stil-ID, die Kartenkonfigurations-ID und den Kartenkonfigurationsalias angezeigt. Weitere Informationen finden Sie unter Benutzerdefinierte Formatierung und Kartenkonfiguration.

Screenshot: Dialogfeld „Upload abgeschlossen“ im visuellen Stil-Editor mit Werten für die Stil-ID, die Kartenkonfigurations-ID und den Kartenkonfigurationsalias

Tipp

Notieren Sie sich den Wert für den Kartenkonfigurationsalias. Dieser wird zum Instanziieren des Indoor-Managers eines Map-Objekts benötigt, wenn Sie Anwendungen in Azure Maps entwickeln. Notieren Sie sich außerdem die Stil-ID, die für andere Kachelsets wiederverwendet werden kann.

Benutzerdefinierte Kategorien

In Azure Maps Creator ist eine Liste mit Kategorien definiert. Wenn Sie Ihr Manifest erstellen, ordnen Sie jede Einheit in Ihren Räumlichkeiten einer dieser Kategorien im Objekt unitProperties zu.

Es kann vorkommen, dass Sie eine neue Kategorie erstellen möchten. Möglicherweise möchten Sie in der Lage sein, auf alle Räume, die für Menschen mit Behinderungen besonders geeignet sind, unterschiedliche Stilattribute anzuwenden – z. B. einen Raum mit Bildschirmtelefonen, auf denen Menschen mit Hörbehinderungen ablesen können, was die Personen in einem Telefongespräch sagen.

Geben Sie dazu den gewünschten Wert in categoryName für den gewünschten unitName im JSON-Code des Manifests ein, ehe Sie Ihr Zeichnungspaket hochladen.

Screenshot des benutzerdefinierten Kategorienamens im Manifest.

Der Kategoriename ist keiner Ebene zugeordnet, wenn er in einem visuellen Editor angezeigt wird, und weist keinen Standardstil auf. Um ihn mit einem Stil zu versehen, erstellen Sie eine neue Ebene und fügen dieser die neue Kategorie hinzu.

Screenshot, der den Unterschied bei den Ebenen zeigt, die angezeigt werden, nachdem Sie den Kategorienamen im Manifest geändert haben.

Um eine neue Ebene zu erstellen, wählen Sie die Schaltfläche „Duplizieren“ für eine vorhandene Ebene aus. Dadurch wird eine Kopie der ausgewählten Ebene erstellt, die Sie nach Bedarf ändern können. Benennen Sie als Nächstes die Ebene um, indem Sie in das Feld ID einen neuen Namen eingeben. In diesem Beispiel haben wir indoor_unit_room_accessible eingegeben.

Screenshot der Schaltfläche „Duplizieren“ im Bereich „Ebenen“ auf der Symbolleiste des visuellen Editors, samt Ebenen-ID mit dem Namen der neuen Ebene, der mit dem Namen der Originalebene übereinstimmt, wobei am Ende „Bindestrich_copy“ hinzugefügt wurde.

Sobald Sie eine neue Ebene erstellt haben, müssen Sie ihr den Namen Ihrer neuen Kategorie zuordnen. Dazu müssen Sie die kopierte Ebene so bearbeiten, dass die vorhandenen Kategorien entfernt und die neuen hinzugefügt werden.

Der JSON-Code sieht beispielsweise wie folgt aus:

{
  "id": "indoor_unit_room_accessible",
  "type": "fill",
  "filter": [
    "all",
    ["has", "floor0"],
    [
      "any",
      [
        "case",
        [
          "==",
          [
            "typeof",
            ["get", "categoryName"]
          ],
          "string"
        ],
        [
          "==",
          ["get", "categoryName"],
          "room.accessible.phone"
        ],
        false
      ]
    ]
  ],
  "layout": {"visibility": "visible"},
  "metadata": {
    "microsoft.maps:layerGroup": "unit"
  },
  "minzoom": 16,
  "paint": {
    "fill-antialias": true,
    "fill-color": [
      "string",
      ["feature-state", "color"],
      "rgba(230, 230, 230, 1)"
    ],
    "fill-opacity": 1,
    "fill-outline-color": "rgba(120, 120, 120, 1)"
  },
  "source-layer": "Indoor unit",
  "source": "{tilesetId}"
}

Nur Features, die dem Filter entsprechen, werden auf der Karte angezeigt. Sie müssen den Filter so bearbeiten, dass alle Kategorien, die Sie nicht auf der Karte anzeigen möchten, entfernt werden und die neue Kategorie hinzugefügt wird.

Der JSON-Code für den Filter kann beispielsweise so aussehen:

[
  "all",
  ["has", "floor0"],
  [
    "any",
    [
      "case",
      [
        "==",
        [
          "typeof",
          ["get", "categoryName"]
        ],
        "string"
      ],
      [
        "==",
        ["get", "categoryName"],
        "room.accessible.phone"
      ],
      false
    ]
  ]
]

Wenn Sie jetzt diese Einheit in der Karte auswählen, wird im Popupmenü die neue Ebenen-ID angezeigt, die in diesem Beispiel indoor_unit_room_accessible lautet. Nach ihrer Auswahl können Sie den Stil bearbeiten.

Screenshot des Popupmenüs mit der neuen Ebene, die angezeigt wird, wenn Sie die Einheit „Telefon 11“ auswählen.

Nächste Schritte