Freigeben über

Azure Maps als Ereignisrasterquelle

Dieser Artikel enthält die Eigenschaften und das Schema für Azure Maps-Ereignisse. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema. Außerdem erhalten Sie eine Liste mit Schnellstarts und Lernprogrammen, um Azure Maps als Ereignisquelle zu verwenden.

Verfügbare Ereignistypen

Ein Azure Maps-Konto gibt die folgenden Ereignistypen aus:

Ereignistyp Beschreibung
Microsoft.Maps.GeofenceEntered Wird ausgelöst, wenn empfangene Koordinaten von außerhalb eines bestimmten Geofence-Bereichs verschoben wurden
Microsoft.Maps.GeofenceExited Wird ausgelöst, wenn empfangene Koordinaten innerhalb eines bestimmten Geofence-Raums nach außen verschoben wurden
Microsoft.Maps.GeofenceResult Wird jedes Mal ausgelöst, wenn eine Geofencing-Abfrage ein Ergebnis zurückgibt, unabhängig vom Zustand

Beispielereignisse

Das folgende Beispiel zeigt das Schema eines GeofenceEntered-Ereignisses .

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

Das folgende Beispiel zeigt das 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" 
}

Ereigniseigenschaften

Ein Ereignis enthält die folgenden Daten auf oberster Ebene:

Eigentum Typ Beschreibung
source Schnur Vollständiger Ressourcenpfad zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt.
subject Schnur Publisher-definierter Pfad zum Ereignisbetreff.
type Schnur Einer der registrierten Ereignistypen für diese Ereignisquelle.
time Schnur Die Zeit, zu der das Ereignis basierend auf der UTC-Zeit des Anbieters erzeugt wird.
id Schnur Eindeutiger Bezeichner für das Ereignis.
data Objekt Geofencing-Ereignisdaten.
specversion Schnur CloudEvents-Schemaspezifikationsversion.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigentum Typ Beschreibung
apiCategory Schnur API-Kategorie des Ereignisses.
apiName Schnur API-Name des Ereignisses.
issues Objekt Listet Probleme auf, die während der Verarbeitung aufgetreten sind. Wenn Probleme zurückgegeben werden, werden keine Geometrien mit der Antwort zurückgegeben.
responseCode Nummer HTTP-Antwortcode
geometries Objekt Listet die Zaungeometrien auf, die die Koordinatenposition enthalten oder den searchBuffer um die Position überlappen.

Das Fehlerobjekt wird zurückgegeben, wenn ein Fehler in der Karten-API auftritt. Das Fehlerobjekt weist die folgenden Eigenschaften auf:

Eigentum Typ Beschreibung
error ErrorDetails Dieses Objekt wird zurückgegeben, wenn ein Fehler in der Maps-API auftritt

Das ErrorDetails -Objekt wird zurückgegeben, wenn ein Fehler in der Karten-API auftritt. Das ErrorDetails- oder Objekt verfügt über die folgenden Eigenschaften:

Eigentum Typ Beschreibung
code Schnur Der HTTP-Statuscode.
message Schnur Wenn verfügbar, eine lesbare Beschreibung des Fehlers.
innererror InnerError Falls verfügbar, enthält ein Objekt dienstspezifische Informationen zum Fehler.

Der InnerError ist ein Objekt, das dienstspezifische Informationen zum Fehler enthält. Das InnerError-Objekt verfügt über die folgenden Eigenschaften:

Eigentum Typ Beschreibung
code Schnur Die Fehlermeldung.

Das Geometrieobjekt listet Geometrie-IDs der Geofences auf, die relativ zur Benutzerzeit in der Anforderung abgelaufen sind. Das Geometrieobjekt verfügt über Geometrieelemente mit den folgenden Eigenschaften:

Eigentum Typ Beschreibung
deviceid Schnur ID des Geräts.
distance Schnur

Abstand zwischen der Koordinate und dem nächstgelegenen Rand des Geofence-Bereichs. Positiv bedeutet, dass sich die Koordinate außerhalb des Geofence-Bereichs befindet. Wenn sich die Koordinate außerhalb des Geofence-Bereichs befindet, aber mehr als der Wert von searchBuffer vom nächstgelegenen Geofence-Rahmen entfernt ist, lautet der Wert 999. Negativ bedeutet, dass sich die Koordinate innerhalb des Geofence-Bereichs befindet. Wenn sich die Koordinate innerhalb des Polygons befindet, aber mehr als der Wert von searchBuffer von der nächsten Geofencing-Grenze entfernt ist, beträgt der Wert -999. Ein Wert von 999 bedeutet, dass die Koordinate gut außerhalb des Geofence-Bereichs liegt. Ein Wert von -999 bedeutet, dass die Koordinate gut innerhalb des Geofence-Bereichs liegt.
geometryid Schnur Die eindeutige ID identifiziert die Geofence-Geometrie.
nearestlat Nummer Breitengrad des nächstgelegenen Punkts der Geometrie.
nearestlon Nummer Längengrad des nächstgelegenen Punkts der Geometrie.
udId Schnur Die eindeutige ID, die beim Hochladen eines Geofence-Diensts vom Benutzeruploaddienst zurückgegeben wird. Wird nicht in die Geofencing-Post-API eingeschlossen.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigentum Typ Beschreibung
expiredGeofenceGeometryId string[] Listen der Geometrie-ID des Geofence-Bereichs, der relativ zur Benutzerzeit in der Anforderung abgelaufen ist.
geometries Geometrien[] Listet die Zaungeometrien auf, die die Koordinatenposition enthalten oder den searchBuffer um die Position überlappen.
invalidPeriodGeofenceGeometryId string[] Liste der Geometrie-ID des Geofence-Bereichs, der sich in einem ungültigen Zeitraum relativ zur Benutzerzeit in der Anforderung befindet.
isEventPublished boolean True, wenn mindestens ein Ereignis im Azure Maps-Ereignisabonnent veröffentlicht wird, false, wenn kein Ereignis im Azure Maps-Ereignisabonnent veröffentlicht wird.

Tutorials und Anleitungen

Title Beschreibung
Reagieren auf Azure Maps-Ereignisse mithilfe des Ereignisrasters Übersicht über die Integration von Azure Maps in das Event Grid.
Lernprogramm: Einrichten eines Geofence-Raums Dieses Lernprogramm führt Sie durch die grundlegenden Schritte zum Einrichten von Geofence mithilfe von Azure Maps. Sie verwenden Azure Event Grid, um die Geofence-Ergebnisse zu streamen und eine Benachrichtigung basierend auf den Geofence-Ergebnissen einzurichten.

Nächste Schritte

  • Last updated on