Comparteix a través de

Consultar conjuntos de datos mediante Web Feature Service

  • Article

En este artículo se describe cómo consultar conjuntos de datos de Azure Maps Creator mediante Web Feature Service (WFS). Puede usar la API de WFS para consultar todas las colecciones de características o una recopilación específica dentro de un conjunto de datos. Por ejemplo, puede usar WFS para buscar todas las salas de reuniones de tamaño medio de un edificio y una planta en particular.

Prerrequisitos

En este artículo se usa el mismo mapa de interiores de ejemplo que se usa en el tutorial: Uso de Creator para crear mapas interiores.

Importante

  • En este artículo, se usa la dirección URL geográfica us.atlas.microsoft.com. Si el servicio Creator no se creó en la Estados Unidos, debe usar una dirección URL geográfica diferente. Para más información, consulte Acceso a los servicios de Creator.
  • En los ejemplos de direcciones URL de este artículo, deberá reemplazar:

Consulta de colecciones de características

Para consultar todas las colecciones del conjunto de datos, cree una nueva solicitud HTTP GET:

Escriba la siguiente dirección URL en la API de WFS. La solicitud debe tener un aspecto similar a la siguiente dirección URL:

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

El cuerpo de la respuesta se devuelve en formato GeoJSON y contendrá todas las colecciones del conjunto de datos. Para simplificar, en este ejemplo solo se muestra la colección de unit. Para ver un ejemplo que contenga todas las colecciones, consulte Describe Collections API de WFS. Para obtener más información sobre cualquier colección, puede seleccionar cualquiera de las direcciones URL del 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"
            }
        ]
    },

Consulta de la colección de características unitarias

En esta sección se muestra cómo consultar la API WFS para la colección de unit características.

Para consultar la colección de unidades en el conjunto de datos, cree una nueva solicitud HTTP GET:

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

Una vez que se devuelva la respuesta, copie la característica id de una de las características unit. En el ejemplo siguiente, el id de la característica es "UNIT26". Usa "UNIT26" como característica sid al actualizar el estado de una característica.

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

Pasos siguientes

Cómo crear un conjunto de estados de características