Reagálás az Azure Térképek-eseményekre az Event Grid használatával

  • Cikk

Az Azure Térképek integrálható az Azure Event Griddel, így a felhasználók eseményértesítéseket küldhetnek más szolgáltatásoknak, és elindíthatják az alárendelt folyamatokat. A cikk célja, hogy segítsen konfigurálni az üzleti alkalmazásokat az Azure-Térképek események figyeléséhez. Ez lehetővé teszi a felhasználók számára, hogy megbízható, méretezhető és biztonságos módon reagáljanak a kritikus eseményekre. A felhasználók például létrehozhatnak egy alkalmazást, amely frissíti az adatbázist, létrehoz egy jegyet, és e-mail-értesítést küld minden alkalommal, amikor egy eszköz beírja a földrajzi adatokat.

Az Azure Event Grid egy teljes körűen felügyelt esemény-útválasztási szolgáltatás, amely közzétételi-előfizetési modellt használ. Az Event Grid beépített támogatást nyújt olyan Azure-szolgáltatásokhoz, mint az Azure Functions és az Azure Logic Apps. Webhookok használatával eseményriasztásokat képes kézbesíteni nem Azure-szolgáltatásoknak. Az Event Grid által támogatott eseménykezelők teljes listáját az Azure Event Grid bemutatása tartalmazza.

Azure Event Grid functional model

Azure Térképek eseménytípusok

Az Event Grid esemény-előfizetésekkel irányítja át az eseményüzeneteket az előfizetőknek. 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 emelik ki, ha a kapott koordináták egy adott földrajzi helyen kívülről a
Microsoft. Térképek. GeofenceExited Amikor a kapott koordináták egy adott földrajzi régión belülről kívülre 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

Eseményséma

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

{
    "id":"451675de-a67d-4929-876c-5c2bf0b2c000",
    "topic":"/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
            }
        ],
        "expiredGeofenceGeometryId":[
        ],
        "invalidPeriodGeofenceGeometryId":[
        ]
    },
    "eventType":"Microsoft.Maps.GeofenceResult",
    "eventTime":"2018-11-08T00:52:08.0954283Z",
    "metadataVersion":"1",
    "dataVersion":"1.0"
}

Tippek események felhasználásához

Az Azure Térképek geofenciaeseményeket kezelő alkalmazásoknak néhány ajánlott eljárást kell követnie:

  • Több előfizetés konfigurálása az események ugyanarra az eseménykezelőre való átirányításához. Fontos, hogy ne feltételezzük, hogy az események egy adott forrásból származnak. Mindig ellenőrizze az üzenet témakörét, hogy az üzenet a várt forrásból származik-e.
  • X-Correlation-id A válaszfejléc mezőjével megtudhatja, hogy az objektumok adatai naprakészek-e. Megtörténhet, hogy az üzenetek más sorrendben, vagy késve érkeznek.
  • Ha a Geofence API-ban get vagy POST kérést hív meg a módparaméterrel EnterAndExit, a rendszer egy Enter vagy Exit eseményt hoz létre a geofence minden olyan geometriája esetében, amelynek állapota megváltozott az előző Geofence API-híváshoz képest.

További lépések

Az Azure Térképek által támogatott összes eseményről és a sémáról az Azure Térképek event Grid-forrásként való megtekintésével tájékozódhat.

Ha többet szeretne megtudni arról, hogyan vezérelheti a geofencinget az építkezéseken végzett műveletek irányításához, tekintse meg a következőt:

Geofence beállítása az Azure Térképek használatával