Web Özellik Hizmeti'ni kullanarak veri kümelerini sorgulama

Bu makalede, Web Özellik Hizmeti (WFS) kullanılarak Azure Haritalar Oluşturucu veri kümelerinin nasıl sorgulandığı açıklanmaktadır. WFS API'sini kullanarak bir veri kümesindeki tüm özellik koleksiyonlarını veya belirli bir koleksiyonu sorgulayabilirsiniz. Örneğin, belirli bir bina ve kat düzeyindeki tüm orta ölçekli toplantı odalarını bulmak için WFS'yi kullanabilirsiniz.

Önkoşullar

Bu makalede Öğretici: İç mekan haritaları oluşturmak için Oluşturucu kullanma başlığı altında kullanılan örnek iç mekan haritası kullanılmıştır.

Önemli

Özellik koleksiyonları için sorgu

Veri kümenizdeki tüm koleksiyonları sorgulamak için yeni bir HTTP GET İsteği oluşturun:

WFS API'si için aşağıdaki URL'yi girin. İstek aşağıdaki URL gibi görünmelidir:

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

Yanıt gövdesi GeoJSON biçiminde döndürülür ve veri kümesindeki tüm koleksiyonları içerir. Kolaylık olması için buradaki örnekte yalnızca koleksiyon gösterilmektedir unit . Tüm koleksiyonları içeren bir örneği görmek için bkz . WFS Koleksiyonları Açıklama API'si. Herhangi bir koleksiyon hakkında daha fazla bilgi edinmek için öğesinin içindeki links URL'lerden herhangi birini seçebilirsiniz.

{
"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"
            }
        ]
    },

Birim özellik koleksiyonu sorgusu

Bu bölümde, özellik koleksiyonu için WFS API'sinin sorgulanması gösterilmektedirunit.

Veri kümenizdeki birim koleksiyonunu sorgulamak için yeni bir HTTP GET İsteği oluşturun:

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

Yanıt geri döndükten sonra özelliklerden birinin unit özelliğini id kopyalayın. Aşağıdaki örnekte, özellik id "UNIT26" şeklindedir. Özellik durumunu güncelleştirirken özellikleriniz id olarak "UNIT26" kullanın.

{
    "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": ""
        }, {"..."}
    ]
}

Sonraki adımlar