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
vagyFeatureCollection
objektum. - A geometriaobjektum típusa lehet egy
Point
,MultiPoint
,LineString
,MultiLineString
,Polygon
,MultiPolygon
ésGeometryCollection
. - Minden funkciótulajdonságnak tartalmaznia kell egy
geometryId
, a geofencia azonosítására használt tulajdonságot. - A , tulajdonsággal
LineString
MultiPoint
MultiLineString
rendelkezőPoint
funkciónak tartalmazniaradius
kell a tulajdonságokat.radius
az érték mérése méterben történik, azradius
é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ékeuserTime
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ébenexpiredGeofenceGeometryId
található. - A
validityPeriod
földrajzi hely érvényességi idejének listája. Ha a kérelem értékeuserTime
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ébeninvalidPeriodGeofenceGeometryId
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 , Monthly vagy 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
MultiPoint
a tulajdonságokatMultiLineString
,MultiPolygon
GeometryCollection
a rendszer az összes elemre alkalmazza a tulajdonságokat. például: Az összes pontMultiPoint
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-22
17: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
}
]
}
}
}