Condividi tramite

Eseguire query su set di dati usando Web Feature Service

  • Articolo

Nota

Ritiro di Creator di Mappe di Azure

Il servizio per la creazione di piante dell'interno Creator di Mappe di Azure è ora deprecato e verrà ritirato il 30/09/25. Per altre informazioni, vedere Annuncio di fine vita di Creator di Mappe di Azure.

Questo articolo descrive come eseguire query su set di dati di Creator per Mappe di Azure usando Web Feature Service (WFS). È possibile usare l'API WFS per eseguire query per tutte le raccolte di funzionalità o una raccolta specifica all'interno di un set di dati. Ad esempio, è possibile usare WFS per trovare tutte le sale riunioni di dimensioni medie in un edificio e un piano specifici.

Prerequisiti

Importante

  • Questo articolo usa l'URL geografico us.atlas.microsoft.com. Se il servizio Creator non è stato creato negli Stati Uniti, è necessario usare un URL geografico diverso. Per altre informazioni, vedere Accesso ai servizi Creator.
  • Negli URL di esempio contenuti in questo articolo è necessario sostituire:
    • {Azure-Maps-Subscription-key} con la chiave di sottoscrizione di Mappe di Azure.

Eseguire query per raccolte di funzionalità

Per eseguire query su tutte le raccolte nel set di dati, creare una nuova richiesta HTTP GET:

Immettere l'URL seguente all’API WFS. La richiesta deve essere simile all'URL seguente:

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

Il corpo della risposta viene restituito in formato GeoJSON e contiene tutte le raccolte nel set di dati. Per semplicità, l'esempio mostra solo la raccolta unit. Per un esempio contenente tutte le raccolte, vedere API WFS - Descrizioni raccolte. Per altre informazioni sulle raccolte, selezionare uno degli URL all'interno dell'elemento links.

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

Eseguire query per una raccolta di funzionalità di unità

Questa sezione illustra l'esecuzione di query API WFS per la raccolta di funzionalità unit.

Per eseguire una query sulla raccolta di unità nel set di dati, creare una nuova richiesta HTTP GET:

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

Al termine della risposta, copiare la funzionalità id per una delle funzionalità unit. Nell'esempio seguente la proprietà id è "UNIT26".

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