Adathalmazok lekérdezése a webszolgáltatás használatával

  • Cikk

Ez a cikk azt ismerteti, hogyan kérdezheti le az Azure Térképek Creator-adatkészleteket a Web Feature Service (WFS) használatával. A WFS API-val lekérdezheti az adathalmaz összes funkciógyűjteményét vagy egy adott gyűjteményét. A WFS használatával például megkeresheti az összes közepes méretű tárgyalót egy adott épület- és emeletszinten.

Előfeltételek

  • Az oktatóanyag sikeres befejezése : Beltéri térképek létrehozása a Creator használatával.
  • A datasetId beltéri térképek létrehozására vonatkozó oktatóanyag a Use Creator adathalmaz-létrehozási állapotánakellenőrzése szakaszában található.

Ez a cikk ugyanazt a minta beltéri térképet használja, mint az oktatóanyagban: A Létrehozó használata beltéri térképek létrehozásához.

Fontos

  • Ez a cikk a us.atlas.microsoft.com földrajzi URL-címet használja. Ha a Létrehozó szolgáltatás nem a Egyesült Államok lett létrehozva, más földrajzi URL-címet kell használnia. További információ: Access to Creator Services.
  • A cikkben szereplő URL-példákban a következőt kell lecserélnie:
    • {Azure-Maps-Subscription-key}az Azure Térképek-előfizetési kulccsal.
    • {datasetId}a datasetId beltéri térképek létrehozására vonatkozó oktatóanyag a Use Creator adathalmaz-létrehozási állapotánakellenőrzése szakaszában található.

Funkciógyűjtemények lekérdezése

Az adathalmaz összes gyűjteményének lekérdezéséhez hozzon létre egy új HTTP GET-kérést:

Adja meg a WFS API következő URL-címét. A kérésnek a következő URL-címhez hasonlóan kell kinéznie:

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

A válasz törzse GeoJSON formátumban lesz visszaadva, és az adathalmaz összes gyűjteményét tartalmazza. Az egyszerűség kedvéért az itt látható példa csak a gyűjteményt unit mutatja. Az összes gyűjteményt tartalmazó példa megtekintéséhez tekintse meg a WFS Describe Collections API-t. Ha többet szeretne megtudni a gyűjteményekről, az elemen belül links bármelyik URL-címet kiválaszthatja.

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

Lekérdezés egységfunkció-gyűjteményhez

Ez a szakasz a WFS API lekérdezését mutatja be a unit funkciógyűjteményhez.

Az adathalmaz egységgyűjteményének lekérdezéséhez hozzon létre egy új HTTP GET-kérést:

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

A válasz visszaadása után másolja ki az egyik funkció funkcióját idunit . Az alábbi példában a funkció id a "UNIT26". A funkcióállapot frissítésekor használja a "UNIT26" funkciótid.

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

Következő lépések

Szolgáltatásállapot-halmaz létrehozása