Megosztás a következőn keresztül:


WFS - Get Features

A használatával lekérheti a gyűjtemény funkcióinak részletes listáját.

Az Get Features API egy HTTP-kérés GET , amely a megadott gyűjtemény funkcióinak részletes listáját adja vissza.

A WFS API az Open Geospatial Consortium API szabványt követi azadathalmazok lekérdezéséhez szükséges funkciókhoz.

Egy adatkészlet több funkciógyűjteményből áll. A szolgáltatásgyűjtemények hasonló típusú szolgáltatások gyűjteményei, amelyek egy közös sémán alapulnak.

Szolgáltatások lekérése kérelem elküldése

GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items?api-version=2.0
GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items?api-version=2.0&limit={limit}&bbox={bbox}&filter={filter}

URI-paraméterek

Name In Kötelező Típus Description
collectionId
path True

string

Egy adott gyűjtemény azonosítója (neve)

datasetId
path True

string

Annak az adathalmaznak az azonosítója, amelyből lekérdezhető.

geography
path True

string

Ez a paraméter határozza meg, hogy hol található a Azure Maps Creator-erőforrás. Érvényes értékek vagyunk és eu.

api-version
query True

string

Azure Maps API verziószáma.

bbox
query

number[]

Csak a megadott határolókeretet metsző geometriával rendelkező funkciók vannak kiválasztva.

  • Bal alsó sarok, koordinátatengely 1 * Bal alsó sarok, koordinátatengely 2 * Jobb felső sarok, koordinátatengely 1 * Jobb felső sarok, koordinátatengely 2 Az értékek koordináta-referenciarendszere WGS84 hosszúság/szélesség (http://www.opengis.net/def/crs/OGC/1.3/CRS84), kivéve, ha a paraméterben bbox-crsmás koordináta-referenciarendszer van megadva. A WGS84 hosszúsági/szélességi értékei a legtöbb esetben a minimális hosszúság, a minimális szélesség, a maximális hosszúság és a maximális szélesség sorrendje. Azokban az esetekben azonban, amikor a mező az antimeridianra terjed ki, az első érték (a legnyugatibb mező széle) nagyobb, mint a harmadik érték (a legkésõbb doboz széle).
filter
query

string

Kifejezés szűrése adott tulajdonságértékekkel rendelkező szolgáltatások kereséséhez egy adott gyűjteményben. Csak a skaláris típusú és az egyenlő operátorú tulajdonságok támogatottak. Ez egy speciális paraméter, amelyben a paraméter neve megkülönbözteti a kis- és nagybetűk tulajdonságnevét. Ennek a paraméternek a sémája a következő: {property name}={property value}. Hacsak a "filter" nem a gyűjtemény egyik tulajdonságneve, a "filter" paraméternévként nem használható. A "name" tulajdonságértékkel (21N13) rendelkező szolgáltatások kereséséhez használja a "name=21N13" értéket. Több szűrő is támogatott, és több lekérdezési paraméterként kell ábrázolni. Például: =&= A sztringértékek megkülönböztetik a kis- és nagybetűket.

limit
query

integer

Az opcionális korlátparaméter korlátozza a válaszdokumentumban bemutatott funkciók számát. A rendszer csak a válaszdokumentumban a gyűjtemény első szintjén lévő funkciókat számolja meg. Az explicit módon kért szolgáltatásokban található beágyazott objektumok nem számítanak bele.

  • Minimum = 1 * Maximum = 500 * Alapértelmezett = 10

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. A Azure Maps fiók egyedi azonosítóját jelöli, és lekérhető a Azure Maps felügyeleti sík fiók API-jából. A biztonsági Microsoft Entra ID Azure Maps az alábbi cikkekben talál útmutatást.

Válaszok

Name Típus Description
200 OK

ExtendedGeoJsonFeatureCollection

Oké

Other Status Codes

ErrorResponse

Váratlan hiba történt.

Biztonság

AADToken

Ezek az OAuth 2.0-folyamatok Microsoft Entra. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható a Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több, a REST API-khoz Azure Maps engedélyekkel rendelkező egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

  • Ez a biztonsági definíció a fejléc használatával x-ms-client-id jelzi, hogy az alkalmazás melyik Azure Maps erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.

Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlése az Azure felügyeleti síkjáról van konfigurálva Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával. * A Azure Maps Web SDK használata lehetővé teszi az alkalmazások konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps fiókot hoz létre a Azure Portal vagy PowerShell, CLI, Azure SDK vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetén javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre az Azure Maps erőforráson keresztül az Azure felügyeleti síkján keresztül Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

GetFeatures

Mintakérelem

GET https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?api-version=2.0&limit=1&bbox=-122,47,-120,46

Mintaválasz

{
  "type": "FeatureCollection",
  "ontology": "Facility-2.0",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              139.6330405782921,
              35.45768668610856
            ],
            [
              139.63296283234274,
              35.45778390425868
            ],
            [
              139.63308672404617,
              35.45785022906202
            ],
            [
              139.6331451691671,
              35.45777714569986
            ],
            [
              139.6331274703629,
              35.45776767074717
            ],
            [
              139.63314677109963,
              35.45774353588138
            ],
            [
              139.6330405782921,
              35.45768668610856
            ]
          ]
        ]
      },
      "properties": {
        "originalId": "ddbbb583-4621-4e11-8859-299d1057e843",
        "categoryId": "CTG10",
        "isOpenArea": false,
        "navigableBy": [
          "pedestrian"
        ],
        "isRoutable": false,
        "routeThroughBehavior": "allowed",
        "nonPublic": false,
        "levelId": "LVL18",
        "occupants": [],
        "addressId": "DIR16",
        "addressRoomNumber": "",
        "name": "21N13",
        "nameSubtitle": "",
        "nameAlt": ""
      },
      "id": "UNIT39",
      "featureType": ""
    }
  ],
  "numberReturned": 1,
  "links": [
    {
      "href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?api-version=2.0&limit=1",
      "rel": "self"
    },
    {
      "href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit?api-version=2.0",
      "rel": "data"
    },
    {
      "href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?n=PMRG4ZLYOQRDUMJMEJYHEZLWEI5C2ML5&api-version=2.0&limit=1",
      "rel": "next"
    }
  ]
}

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ExtendedGeoJsonFeatureCollection

GeoJSON FeatureCollection Érvényes objektumtípus, amely a numberReturned és a links tömbdel van kibővítve. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonFeature

Érvényes GeoJSON Feature objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonGeometry

Érvényes GeoJSON geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, Vonallánc, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonGeometryCollection

Érvényes GeoJSON GeometryCollection objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonLineString

Érvényes GeoJSON LineString geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonMultiLineString

Érvényes GeoJSON MultiLineString geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonMultiPolygon

Érvényes GeoJSON MultiPolygon objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonObjectType

A következő típust GeoJSON adja meg: FeatureCollection.

GeoJsonPoint

Érvényes GeoJSON Point geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

GeoJsonPolygon

Érvényes GeoJSON Polygon geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

WFSEndpointLink

Más WFS-végpontokra mutató hivatkozások

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ExtendedGeoJsonFeatureCollection

GeoJSON FeatureCollection Érvényes objektumtípus, amely a numberReturned és a links tömbdel van kibővítve. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
features

GeoJsonFeature[]

Az érvényes GeoJSON Feature objektumok listáját tartalmazza.

links

WFSEndpointLink[]

Más WFS-végpontokra mutató hivatkozások.

numberReturned

integer

A visszaadott szolgáltatások száma.

ontology

string

Az adatkészlet ontológiai verziója.

type

GeoJsonObjectType

A következő típust GeoJSON adja meg: FeatureCollection.

GeoJsonFeature

Érvényes GeoJSON Feature objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
featureType

string

A szolgáltatás típusa. Az érték attól függ, hogy az aktuális funkció melyik adatmodell része. Egyes adatmodellek üres értékkel rendelkezhetnek.

geometry GeoJsonGeometry:

Érvényes GeoJSON geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, Vonallánc, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részletekért tekintse meg az RFC 7946-ot .

id

string

A funkció azonosítója.

type string:

Feature

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonGeometry

Érvényes GeoJSON geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, Vonallánc, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
type

GeoJsonObjectType

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonGeometryCollection

Érvényes GeoJSON GeometryCollection objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
geometries GeoJsonGeometry[]:

Érvényes geometriai objektumok listáját GeoJSON tartalmazza. Vegye figyelembe , hogy a GeoJSON koordinátái x, y sorrendben vannak (hosszúság, szélesség).

type string:

GeometryCollection

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonLineString

Érvényes GeoJSON LineString geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

A geometria koordinátái GeoJson LineString .

type string:

LineString

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiLineString

Érvényes GeoJSON MultiLineString geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

A geometria koordinátái GeoJson MultiLineString .

type string:

MultiLineString

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

A geometria koordinátái GeoJson MultiPoint .

type string:

MultiPoint

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiPolygon

Érvényes GeoJSON MultiPolygon objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

Az érvényes GeoJSON Polygon objektumok listáját tartalmazza. Vegye figyelembe , hogy a GeoJSON koordinátái x, y sorrendben vannak (hosszúság, szélesség).

type string:

MultiPolygon

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonObjectType

A következő típust GeoJSON adja meg: FeatureCollection.

Name Típus Description
FeatureCollection

string

GeoJSON FeatureCollection Objektum.

GeoJsonPoint

Érvényes GeoJSON Point geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

Az A Position két vagy több elemet tartalmazó számok tömbje. Az első két elem a hosszúság és a szélesség, pontosan ebben a sorrendben. A magasság/magasság opcionális harmadik elem. A részletekért tekintse meg az RFC 7946-ot .

type string:

Point

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonPolygon

Érvényes GeoJSON Polygon geometriatípus. A részletekért tekintse meg az RFC 7946-ot .

Name Típus Description
coordinates

number[]

A geometriatípus koordinátái GeoJson Polygon .

type string:

Polygon

Megadja a típust GeoJSON . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

Más WFS-végpontokra mutató hivatkozások

Name Típus Description
href

string

A hivatkozás célja.

hreflang

string

Egy tipp, amely azt jelzi, hogy a hivatkozás elhalasztásának eredménye milyen nyelven jelenik meg.

rel

string

A relációs típus.

title

string

A hivatkozás célhelyének címkézésére szolgál, így emberi olvasásra alkalmas azonosítóként (például menübejegyzésként) használható a Content-Language fejlécmező által jelzett nyelven (ha van ilyen).

type

string

Egy tipp, amely azt jelzi, hogy a hivatkozás elhalasztásának eredménye milyen médiatípusúnak kell lennie.