Az Azure Térképek Event Grid-forrásként

  • Cikk

Ez a cikk az Azure Térképek események tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat. Emellett felsorolja az Azure Térképek eseményforrásként való használatához használható rövid útmutatókat és oktatóanyagokat.

Elérhető eseménytípusok

Egy Azure-Térképek-fiók a következő eseménytípusokat bocsátja ki:

Eseménytípus Leírás
Microsoft. Térképek. GeofenceEntered Akkor merül fel, ha a fogadott koordináták egy adott földrajzi helyen kívülről a
Microsoft. Térképek. GeofenceExited Akkor emelik ki, ha a kapott koordináták egy adott földrajzi régióból a külső helyre kerültek
Microsoft. Térképek. GeofenceResult Minden alkalommal megjelenik, amikor egy geofencing-lekérdezés eredményt ad vissza, az állapottól függetlenül

Példaesemények

Az alábbi példa egy GeofenceEntered esemény sémáját mutatja be

{   
   "id":"7f8446e2-1ac7-4234-8425-303726ea3981", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":-999.0, 
            "nearestLat":47.618786, 
            "nearestLon":-122.132151 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceEntered", 
   "time":"2018-11-08T00:54:17.6408601Z", 
   "specversion":"1.0" 
}

Az alábbi példa a GeofenceResult sémáját mutatja be

{   
   "id":"451675de-a67d-4929-876c-5c2bf0b2c000", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"1", 
            "distance":999.0, 
            "nearestLat":47.609833, 
            "nearestLon":-122.148274 
         }, 
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":999.0, 
            "nearestLat":47.621954, 
            "nearestLon":-122.131841 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceResult", 
   "time":"2018-11-08T00:52:08.0954283Z", 
   "specversion":"1.0" 
}

Esemény tulajdonságai

Egy esemény a következő legfelső szintű adatokkal rendelkezik:

Tulajdonság Típus Leírás
source húr Az eseményforrás teljes erőforrás-elérési útja. Ez a mező nem írható. Az értéket az Event Grid adja meg.
subject húr Az esemény tárgyra mutató, a közzétevő által megadott elérési út.
type húr Az eseményforráshoz felvett eseménytípusok egyike.
time húr Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján.
id húr Az esemény egyedi azonosítója.
data object Geofencing eseményadatok.
specversion húr A CloudEvents sémaspecifikációs verziója.

Az adatobjektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
apiCategory húr Az esemény API-kategóriája.
apiName húr Az esemény API-neve.
issues object A feldolgozás során előforduló problémák listája. Ha bármilyen problémát ad vissza, akkor a válasz nem ad vissza geometriákat.
responseCode szám HTTP-válaszkód
geometries object Felsorolja a koordináta-pozíciót tartalmazó vagy a keresésibuffert a pozíció körül átfedő kerítésgeometriákat.

A hibaobjektum akkor jelenik meg, ha hiba történik a Térképek API-ban. A hibaobjektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
error ErrorDetails Ez az objektum akkor jelenik meg, ha hiba történik a Térképek API-ban

Az ErrorDetails objektum akkor jelenik meg, ha hiba történik a Térképek API-ban. Az ErrorDetails vagy objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
code húr A HTTP-állapotkód.
message húr Ha elérhető, a hiba emberi olvasható leírása.
innererror InnerError Ha elérhető, egy objektum, amely szolgáltatásspecifikus információkat tartalmaz a hibáról.

Az InnerError egy olyan objektum, amely szolgáltatásspecifikus információkat tartalmaz a hibáról. Az InnerError objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
code húr A hibaüzenet.

A geometriai objektum felsorolja a kérelem felhasználói idejéhez képest lejárt geofencesek geometriai azonosítóit. A geometriai objektum geometriai elemei a következő tulajdonságokkal rendelkeznek:

Tulajdonság Típus Leírás
deviceid húr Az eszköz azonosítója.
distance húr

Távolság a koordinátától a földrajzi hely legközelebbi szegélyétől. A pozitív azt jelenti, hogy a koordináta kívül esik a geofizikán. Ha a koordináta kívül esik a geoffencián, de a keresésibuffer értéke nagyobb a legközelebbi geofence szegélytől, akkor az érték 999. A negatív azt jelenti, hogy a koordináták a geofencen belül vannak. Ha a koordináta a sokszögben van, de a legközelebbi geofencing szegélytől távol eső searchBuffer értéknél nagyobb, akkor az érték -999. A 999 érték azt jelenti, hogy nagy a megbízhatóság, hogy a koordináta jól kívül esik a geofizikán. A -999 érték azt jelenti, hogy nagy a megbízhatóság a koordinátán belül.
geometryid húr Az egyedi azonosító azonosítja a geofizikai geometriát.
nearestlat szám A geometria legközelebbi pontjának szélessége.
nearestlon szám A geometria legközelebbi pontjának hosszúsága.
udId húr A felhasználófeltöltési szolgáltatástól a geofence feltöltésekor visszaadott egyedi azonosító. Nem fog szerepelni a geofencing post API-ban.

Az adatobjektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
expiredGeofenceGeometryId sztring[] A kérelem felhasználói idejéhez képest lejárt geofencia geometriai azonosítójának listája.
geometries geometriák[] Felsorolja a koordináta-pozíciót tartalmazó vagy a keresésibuffert a pozíció körül átfedő kerítésgeometriákat.
invalidPeriodGeofenceGeometryId sztring[] A kérelemben megadott felhasználói időhöz képest érvénytelen geofencia geometriai azonosítójának listája.
isEventPublished Logikai Igaz, ha legalább egy eseményt közzétett az Azure Térképek esemény-előfizetője, hamis, ha az Azure Térképek esemény-előfizetője nem tett közzé eseményt.

Oktatóanyagok és útmutatók

Cím Leírás
Reagálás az Azure Térképek-eseményekre az Event Grid használatával Az Azure Térképek Event Griddel való integrálásának áttekintése.
Oktatóanyag: Geofence beállítása Ez az oktatóanyag végigvezeti a geofencia Azure-Térképek használatával történő beállításának alapvető lépésein. Az Azure Event Grid használatával streamelheti a geofizikai eredményeket, és beállíthat egy értesítést a geofencia-eredmények alapján.

Következő lépések