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

Geofencing GeoJSON-adatok

  • Cikk

A Azure Maps GET Geofence és POST Geofence API lehetővé teszi, hogy lekérje a koordináták közelségét egy megadott geofencehez vagy kerítéskészlethez képest. Ez a cikk a GET és a POST API Azure Maps használható geofenciaadatok előkészítését ismerteti.

Az objektum és FeatureCollection az objektum GeoJSON által formázott geofence vagy geofences-készlet adatai az Featurerfc7946-ban lesznek definiálva. Ezen kívül:

  • A GeoJSON-objektum típusa lehet objektum Feature vagy FeatureCollection objektum.
  • A Geometry Object típus lehet egy Point, MultiPoint, , LineString, MultiLineString, Polygon, MultiPolygonés GeometryCollection.
  • Minden funkciótulajdonságnak tartalmaznia kell egy geometryId, amely a geofencia azonosítására szolgál.
  • A ( , MultiPoint, ) MultiLineStringLineStringtulajdonságnak Pointtartalmaznia radius kell a tulajdonságokat. radius az érték mérése méterben történik, az radius érték 1 és 10000 között mozog.
  • polygon A és multipolygon a geometria típusú funkció nem rendelkezik sugártulajdonságokkal.
  • validityTime nem kötelező tulajdonság, amely lehetővé teszi a felhasználó számára a geoadat-adatok lejárt időtartamának és érvényességi idejének beállítását. Ha nincs megadva, az adatok soha nem járnak le, és mindig érvényesek.
  • A expiredTime a georedundáns adatok lejárati dátuma és időpontja. Ha a kérelem értéke userTime ennél az értéknél későbbi, a megfelelő geofenciaadatok lejárt adatoknak minősülnek, és nem kérdezhetők le. Ekkor a geofenciaadatok geometriaAzonosítója szerepel a tömbben a geofencia-válaszban expiredGeofenceGeometryId .
  • Az validityPeriod a földrajzi hely érvényességi idejének listája. Ha a kérelem értéke userTime kívül esik az érvényességi időtartamon, a megfelelő geoadat érvénytelennek minősül, és nem kérdezi le. A geofenciaadatok geometriaazonosítója a geofencia-válaszban található tömbben invalidPeriodGeofenceGeometryId található. Az alábbi táblázat az validityPeriod elem tulajdonságait mutatja be.
Név Típus Kötelező Leírás
startTime Datetime true Az érvényességi idő kezdő dátuma.
endTime Datetime true Az érvényességi időszak záródátuma.
recurrenceType sztring hamis Az időszak ismétlődési típusa. Az érték lehet Daily, Weekly, Monthly, vagy Yearly. Az alapértelmezett érték Daily.
businessDayOnly Logikai hamis Azt jelzi, hogy az adatok csak munkanapok alatt érvényesek-e. Az alapértelmezett érték false.
  • Az összes koordinátaérték [hosszúság, szélesség] a következőben WGS84van megadva: .
  • Minden olyan funkció esetében, amely tartalmazza MultiPointa , MultiLineString, MultiPolygon vagy GeometryCollection, tulajdonságot, a rendszer az összes elemre alkalmazza a tulajdonságokat. például: Az összes pont ugyanabban a sugárban MultiPoint több körös geofencet alkot.
  • Pont-kör forgatókönyvben egy körgeometria ábrázolható a PointGeoJSON-geometriák kiterjesztése című témakörben ismertetett tulajdonságokkal rendelkező geometriai objektummal.

Az alábbiakban GeoJSON egy mintakérési törzset mutatunk be egy kör geofencegeometriaként egy középpont és egy sugár használatával. A geofenciaadatok érvényes időtartama 9:00 és 2018-10-2217:00 között kezdődik, és a hétvégét kivéve minden nap ismétlődik. expiredTime azt jelzi, hogy ezek a geofenciaadatok lejártnak minősülnek, ha userTime a kérelem későbbi, mint 2019-01-01.

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "geometryId" : "1",
        "subType": "Circle",
        "radius": 500,
        "validityTime": 
        {
            "expiredTime": "2019-01-01T00:00:00",
            "validityPeriod": [
                {
                    "startTime": "2018-10-22T09:00:00",
                    "endTime": "2018-10-22T17:00:00",
                    "recurrenceType": "Daily",
                    "recurrenceFrequency": 1,
                    "businessDayOnly": true
                }
            ]
        }
    }
}