Datasets mithilfe des Web Feature Service abfragen

Artikel
03/06/2024

In diesem Artikel wird beschrieben, wie Sie Azure Maps Creator-Datasets mithilfe des Web Feature Service (WFS) abfragen. Mit der WFS-API können Sie alle Featuresammlungen oder eine bestimmte Sammlung innerhalb eines Datasets abfragen. Beispielsweise können Sie WFS verwenden, um alle mittelgroßen Besprechungsräume in einem bestimmten Gebäude und einer bestimmten Etage zu finden.

Voraussetzungen

Erfolgreicher Abschluss des Tutorials: Erstellen von Gebäudeplänen mithilfe von Creator.
Das datasetId, das im Abschnitt Überprüfen des Status der Dataseterstellung des Tutorials Verwenden von Creator zum Erstellen von Gebäudeplänen abgerufen wurde.

In diesem Artikel wird dasselbe Beispiel für einen Gebäudeplan verwendet, wie im Tutorial „Verwenden von Creator zum Erstellen von Gebäudeplänen“.

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

Abfragen von Featuresammlungen

Um alle Sammlungen in Ihrem Dataset abzufragen, erstellen Sie eine neue HTTP GET-Anforderung:

Geben Sie die folgende URL für die WFS-API ein. Die Anforderung sollte wie die folgende URL aussehen:

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

Der Antworttext wird im GeoJSON-Format zurückgegeben und enthält alle Sammlungen im Dataset. Der Einfachheit halber enthält das hier gezeigte Beispiel nur die Sammlung unit. Ein Beispiel mit allen Sammlungen finden Sie unter WFS-API für Sammlungsbeschreibungen. Wenn Sie weitere Informationen zu einer Sammlung benötigen, können Sie eine der URLs im Element links auswählen.

{
"collections": [
    {
        "name": "unit",
        "description": "A physical and non-overlapping area which might be occupied and traversed by a navigating agent. Can be a hallway, a room, a courtyard, etc. It is surrounded by physical obstruction (wall), unless the is_open_area attribute is equal to true, and one must add openings where the obstruction shouldn't be there. If is_open_area attribute is equal to true, all the sides are assumed open to the surroundings and walls are to be added where needed. Walls for open areas are represented as a line_element or area_element with is_obstruction equal to true.",
        "links": [
            {
                "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit/definition?api-version=1.0",
                "rel": "describedBy",
                "title": "Metadata catalogue for unit"
            },
            {
                "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit/items?api-version=1.0",
                "rel": "data",
                "title": "unit"
            }
            {
                "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit?api-version=1.0",
                "rel": "self",
                "title": "Metadata catalogue for unit"
            }
        ]
    },

Abfragen der Featuresammlung „unit“ (Einheit)

In diesem Abschnitt wird das Abfragen einer WFS-API für die unit-Featuresammlung veranschaulicht.

Um die Einheitensammlungen in Ihrem Dataset abzufragen, erstellen Sie eine neue HTTP GET-Anforderung:

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

Nachdem die Antwort zurückgegeben wurde, kopieren Sie das Feature id für eines der Features vom Typ unit. Im folgenden Beispiel lautet die ID (id) des Features „UNIT26“. Verwenden Sie beim Aktualisieren eines Featurezustands „UNIT26“ als id des Features.

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": ["..."]
            },
            "properties": {
                "original_id": "b7410920-8cb0-490b-ab23-b489fd35aed0",
                "category_id": "CTG8",
                "is_open_area": true,
                "navigable_by": [
                    "pedestrian"
                ],
                "route_through_behavior": "allowed",
                "level_id": "LVL14",
                "occupants": [],
                "address_id": "DIR1",
                "name": "157"
            },
            "id": "UNIT26",
            "featureType": ""
        }, {"..."}
    ]
}

Nächste Schritte

Erstellen eines Featurezustandssets

Freigeben über