Geofencing GeoJSON-adatok

Az Azure Maps GET Geofence és a POST Geofence API lehetővé teszi a koordináták közelségét egy megadott geofence vagy kerítéskészlethez képest. Ez a cikk az Azure Maps GET és POST API-ban használható geofizikai adatok előkészítését ismerteti.

A geofence vagy geofences-készlet adatai, amelyeket az objektum és az Feature objektum formátuma GeoJSON jelöl, az rfc7946-ban van definiálva.FeatureCollection Ezen kívül:

• A GeoJSON objektumtípus lehet objektum Feature vagy FeatureCollection objektum.
• A geometriaobjektum típusa lehet egy Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygonés GeometryCollection.
• Minden funkciótulajdonságnak tartalmaznia kell egy geometryId, a geofencia azonosítására használt tulajdonságot.
• A , tulajdonsággal LineStringMultiPointMultiLineString rendelkező Pointfunkciónak tartalmaznia 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 van.
• A funkció és polygon multipolygon a geometriatípus nem rendelkezik sugártulajdonságokkal.
• validityTime nem kötelező tulajdonság, amely lehetővé teszi a felhasználó számára a geofenciaadatok 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 geofencing-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. Ezen geofenciaadatok geometriai azonosítója a geofence-válasz tömbjében expiredGeofenceGeometryId található.
• A validityPeriod földrajzi hely érvényességi idejének listája. Ha a kérelem értéke userTime az érvényességi időszakon kívül esik, a megfelelő geofenciaadatok érvénytelennek minősülnek, és nem kérdezhetők le. A geofence-adatok geometriaazonosítója a geofence-válasz tömbjében 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őszak kezdő dátuma.
endTime	Datetime	true	Az érvényességi időszak záródátuma.
recurrenceType	húr	false	Az időszak ismétlődési típusa. Az érték lehet Daily, Weekly, Monthlyvagy Yearly. Az alapértelmezett érték Daily.
businessDayOnly	Logikai	false	Azt jelzi, hogy az adatok csak munkanapok alatt érvényesek-e. Az alapértelmezett érték false.

• Az összes koordinátaérték a [hosszúság, szélesség] értékként van ábrázolva.WGS84
• Minden olyan funkció esetében, amely tartalmazza MultiPointa tulajdonságokat MultiLineString, MultiPolygon GeometryCollectiona rendszer az összes elemre alkalmazza a tulajdonságokat. például: Az összes pont MultiPoint ugyanazt a sugarat használja több kör geofencia létrehozásához.
• Pont-kör forgatókönyvben a körgeometria egy Point geometriai objektummal jeleníthető meg a GeoJSON-geometriák kiterjesztése című témakörben ismertetett tulajdonságokkal.

Az alábbiakban egy kör geofencegeometriaként GeoJSON ábrázolt geofence mintatörzsét mutatjuk be 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 minden nap ismétlődik, kivéve a hétvégét. expiredTime azt jelzi, hogy 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
                }
            ]
        }
    }
}