Azure Kaarten als event grid-bron

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor Azure Kaarten-gebeurtenissen. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's. U krijgt ook een lijst met quickstarts en zelfstudies voor het gebruik van Azure Kaarten als gebeurtenisbron.

Beschikbare gebeurtenistypen

Een Azure Kaarten-account verzendt de volgende gebeurtenistypen:

Gebeurtenistype Beschrijving
Microsoft. Kaarten. GeofenceEntered Verhoogd wanneer de ontvangen coördinaten zijn verplaatst van buiten een bepaalde geofence naar binnen
Microsoft. Kaarten. GeofenceExited Verhoogd wanneer de ontvangen coördinaten zijn verplaatst van binnen een bepaalde geofence naar buiten
Microsoft. Kaarten. GeofenceResult Telkens wanneer een geofencingquery een resultaat retourneert, ongeacht de status

Voorbeeld van gebeurtenissen

In het volgende voorbeeld ziet u het schema van een GeofenceEntered-gebeurtenis

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

In het volgende voorbeeld ziet u een schema voor 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" 
}

Eigenschappen van gebeurtenis

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
source tekenreeks Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type tekenreeks Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
time tekenreeks Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id tekenreeks Unieke id voor de gebeurtenis.
data object Geofencing-gebeurtenisgegevens.
specversion tekenreeks CloudEvents schemaspecificatieversie.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
apiCategory tekenreeks API-categorie van de gebeurtenis.
apiName tekenreeks API-naam van de gebeurtenis.
issues object Bevat problemen die zijn opgetreden tijdens de verwerking. Als er problemen worden geretourneerd, worden er geen geometrieën geretourneerd met het antwoord.
responseCode Nummer Code van HTTP-antwoord
geometries object Een lijst met de omheiningsgeometrieën die de coördinaatpositie bevatten of de searchBuffer rond de positie overlappen.

Het foutobject wordt geretourneerd wanneer er een fout optreedt in de Kaarten-API. Het foutobject heeft de volgende eigenschappen:

Eigenschap Type Description
error ErrorDetails Dit object wordt geretourneerd wanneer er een fout optreedt in de Kaarten-API

Het object ErrorDetails wordt geretourneerd wanneer er een fout optreedt in de Kaarten-API. De ErrorDetails of het object heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
code tekenreeks De HTTP-statuscode.
message tekenreeks Indien beschikbaar, een door mensen leesbare beschrijving van de fout.
innererror InnerError Indien beschikbaar, een object met servicespecifieke informatie over de fout.

InnerError is een object met servicespecifieke informatie over de fout. Het Object InnerError heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
code tekenreeks Het foutbericht.

Het geometrieobject bevat geometrie-id's van de geofences die zijn verlopen ten opzichte van de gebruikerstijd in de aanvraag. Het geometrieobject heeft geometrie-items met de volgende eigenschappen:

Eigenschap Type Omschrijving
deviceid tekenreeks Id van apparaat.
distance tekenreeks

Afstand van de coördinaat naar de dichtstbijzijnde rand van de geofence. Positief betekent dat de coördinaat zich buiten de geofence bevindt. Als de coördinaat zich buiten de geofence bevindt, maar meer dan de waarde van searchBuffer weg van de dichtstbijzijnde geofencerand, is de waarde 999. Negatief betekent dat de coördinaat zich in de geofence bevindt. Als de coördinaat zich in de veelhoek bevindt, maar meer dan de waarde van searchBuffer weg van de dichtstbijzijnde geofencingrand, is de waarde -999. Een waarde van 999 betekent dat de coördinaat goed buiten de geofence valt. Een waarde van -999 betekent dat de coördinaat goed binnen de geofence valt.
geometryid tekenreeks De unieke id identificeert de geofencegeometrie.
nearestlat Nummer Breedtegraad van het dichtstbijzijnde punt van de geometrie.
nearestlon Nummer Lengtegraad van het dichtstbijzijnde punt van de geometrie.
udId tekenreeks De unieke id die wordt geretourneerd door de service voor het uploaden van gebruikers bij het uploaden van een geofence. Wordt niet opgenomen in de geofencing-post-API.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Description
expiredGeofenceGeometryId tekenreeks[] Lijsten van de geometrie-id van de geofence die is verlopen ten opzichte van de gebruikerstijd in de aanvraag.
geometries geometrieën[] Een lijst met de omheiningsgeometrieën die de coördinaatpositie bevatten of de searchBuffer rond de positie overlappen.
invalidPeriodGeofenceGeometryId tekenreeks[] Lijsten van de geometrie-id van de geofence die zich in een ongeldige periode bevindt ten opzichte van de gebruikerstijd in de aanvraag.
isEventPublished boolean Waar als ten minste één gebeurtenis wordt gepubliceerd naar de Azure Kaarten gebeurtenisabonnee, onwaar als er geen gebeurtenis wordt gepubliceerd naar de Azure Kaarten gebeurtenisabonnee.

Zelfstudies en handleidingen

Title Beschrijving
Reageren op Azure Kaarten-gebeurtenissen met behulp van Event Grid Overzicht van de integratie van Azure Kaarten met Event Grid.
Zelfstudie: Een geofence instellen In deze zelfstudie doorloopt u de basisstappen voor het instellen van geofence met behulp van Azure Maps. U gebruikt Azure Event Grid om de geofence-resultaten te streamen en een melding in te stellen op basis van de geofence-resultaten.

Volgende stappen