Dela via

Azure Kartor som en Event Grid-källa

  • Artikel

Den här artikeln innehåller egenskaper och schema för Händelser i Azure Kartor. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid. Du får också en lista över snabbstarter och självstudier för att använda Azure Kartor som händelsekälla.

Tillgängliga händelsetyper

Ett Azure Kartor-konto genererar följande händelsetyper:

Händelsetyp beskrivning
Microsoft. Kartor. GeofenceEntered Upphöjt när koordinaterna som tagits emot har flyttats från utanför en viss geofence till inom
Microsoft. Kartor. GeofenceExited Utlöses när koordinaterna har flyttats inifrån en viss geofence till utanför
Microsoft. Kartor. GeofenceResult Utlöses varje gång en geofencing-fråga returnerar ett resultat, oavsett tillstånd

Exempelhändelser

I följande exempel visas schemat för en GeofenceEntered-händelse

{   
   "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" 
}

Följande exempel visar schema för GeofenceResult

{   
   "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" 
}

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Type Description
source sträng Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av de registrerade händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid.
id sträng Unik identifierare för händelsen.
data objekt Geofencing-händelsedata.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Property Type Description
apiCategory sträng API-kategorin för händelsen.
apiName sträng API-namnet på händelsen.
issues objekt Listproblem uppstod under bearbetningen. Om några problem returneras returneras inga geometrier med svaret.
responseCode Nummer HTTP-svarskod
geometries objekt Visar en lista över de stängselgeometrier som innehåller koordinatpositionen eller överlappar searchBuffer runt positionen.

Felobjektet returneras när ett fel inträffar i Kartor-API:et. Felobjektet har följande egenskaper:

Property Type Beskrivning
error ErrorDetails Det här objektet returneras när ett fel inträffar i Kartor-API:et

ErrorDetails-objektet returneras när ett fel inträffar i Kartor-API:et. ErrorDetails eller objektet har följande egenskaper:

Property Type Description
code sträng HTTP-statuskoden.
message sträng Om det finns en mänsklig läsbar beskrivning av felet.
innererror InnerError Om tillgängligt, ett objekt som innehåller tjänstspecifik information om felet.

InnerError är ett objekt som innehåller tjänstspecifik information om felet. InnerError-objektet har följande egenskaper:

Property Type Description
code sträng Felmeddelandet.

Geometriobjektet listar geometri-ID:t för geofences som har upphört att gälla i förhållande till användarens tid i begäran. Geometriobjektet har geometriobjekt med följande egenskaper:

Property Type Description
deviceid sträng Enhetens ID.
distance sträng

Avstånd från koordinaten till geofencens närmaste kantlinje. Positivt innebär att koordinaten ligger utanför geofencen. Om koordinaten ligger utanför geofence, men mer än värdet för searchBuffer bort från närmaste geofence-kantlinje, är värdet 999. Negativt innebär att koordinaten finns inuti geofencen. Om koordinaten finns i polygonen, men mer än värdet för searchBuffer bort från närmaste geofencing-kantlinje, är värdet -999. Värdet 999 innebär att koordinaten är mycket säker på att den ligger långt utanför geofencen. Värdet -999 innebär att koordinaten är mycket säker på att den ligger väl inom geofence.
geometryid sträng Det unika ID:t identifierar geofencegeometrin.
nearestlat Nummer Latitud för geometrins närmaste punkt.
nearestlon Nummer Longitud för geometrins närmaste punkt.
udId sträng Det unika ID som returneras från användarens uppladdningstjänst när en geofence laddas upp. Kommer inte att ingå i geofencing post API.

Dataobjektet har följande egenskaper:

Property Type Beskrivning
expiredGeofenceGeometryId string[] Listor över geometri-ID för geofence som har upphört att gälla i förhållande till användarens tid i begäran.
geometries geometrier[] Visar en lista över de stängselgeometrier som innehåller koordinatpositionen eller överlappar searchBuffer runt positionen.
invalidPeriodGeofenceGeometryId string[] Listor över geometri-ID för geofence som är i en ogiltig period i förhållande till användartiden i begäran.
isEventPublished boolean Sant om minst en händelse publiceras till Azure Kartor händelseprenumerant, falskt om ingen händelse publiceras till Azure Kartor händelseprenumerant.

Självstudier och instruktioner

Title Description
Reagera på Händelser i Azure Kartor med hjälp av Event Grid Översikt över integrering av Azure Kartor med Event Grid.
Självstudie: Konfigurera en geofence Den här självstudien vägleder dig igenom de grundläggande stegen för att konfigurera geofence med hjälp av Azure Maps. Du använder Azure Event Grid för att strömma geofenceresultatet och konfigurera ett meddelande baserat på geofenceresultatet.

Nästa steg