Consultar conjuntos de datos mediante Web Feature Service
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
- Haber finalizado correctamente el Tutorial: Uso de Creator para crear planos interiores.
- El
datasetId
obtenido en la sección Comprobación del estado de creación del conjunto de datos de Tutorial: Uso de Creator para crear planos interiores.
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:
{Azure-Maps-Subscription-key}
con su clave de suscripción de Azure Maps.{datasetId}
por el valor dedatasetId
obtenido en la sección Comprobación del estado de creación del conjunto de datos del tutorial Uso de Creator para crear mapas de interiores.
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de