Usługa Azure Mapy jako źródło usługi Event Grid

  • Artykuł

Ten artykuł zawiera właściwości i schemat zdarzeń usługi Azure Mapy. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid. Udostępnia również listę przewodników Szybki start i samouczków dotyczących korzystania z usługi Azure Mapy jako źródła zdarzeń.

Dostępne typy zdarzeń

Konto usługi Azure Mapy emituje następujące typy zdarzeń:

Typ zdarzenia opis
Microsoft. Mapy. GeofenceEntered Podniesione, gdy odebrane współrzędne zostały przeniesione z zewnątrz danego geofencingu do wewnątrz
Microsoft. Mapy. GeofenceExited Podniesione, gdy odebrane współrzędne zostały przeniesione z danego geofencingu na zewnątrz
Microsoft. Mapy. GeofenceResult Wywoływane za każdym razem, gdy zapytanie geofencing zwraca wynik, niezależnie od stanu

Przykładowe zdarzenia

Poniższy przykład przedstawia schemat zdarzenia GeofenceEntered

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

Poniższy przykład przedstawia schemat geofencenceResult 

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

Właściwości zdarzenia

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość Type opis
source string Pełna ścieżka zasobu do źródła zdarzeń. To pole nie jest możliwe do zapisu. Ta wartość jest podawana przez usługę Event Grid.
subject string Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
type string Jeden z zarejestrowanych typów zdarzeń dla tego źródła zdarzeń.
time string Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
id string Unikatowy identyfikator zdarzenia.
data obiekt Dane zdarzeń geofencingu.
specversion string Wersja specyfikacji schematu CloudEvents.

Obiekt danych ma następujące właściwości:

Właściwość Type opis
apiCategory string Kategoria interfejsu API zdarzenia.
apiName string Nazwa interfejsu API zdarzenia.
issues obiekt Wystąpiły problemy z listami podczas przetwarzania. Jeśli zostaną zwrócone jakiekolwiek problemy, nie będą zwracane geometrie z odpowiedzią.
responseCode Liczba Kod odpowiedzi HTTP
geometries obiekt Wyświetla geometrie ogrodzenia, które zawierają położenie współrzędnych lub nakładają się na element searchBuffer wokół pozycji.

Obiekt error jest zwracany, gdy wystąpi błąd w interfejsie API Mapy. Obiekt error ma następujące właściwości:

Właściwość Type Opis
error ErrorDetails Ten obiekt jest zwracany w przypadku wystąpienia błędu w interfejsie API Mapy

Obiekt ErrorDetails jest zwracany, gdy wystąpi błąd w interfejsie API Mapy. Obiekt ErrorDetails lub ma następujące właściwości:

Właściwość Type opis
code string Kod stanu HTTP.
message string Jeśli jest dostępny, czytelny dla człowieka opis błędu.
innererror InnerError Jeśli jest dostępny, obiekt zawierający informacje specyficzne dla usługi dotyczące błędu.

InnerError to obiekt zawierający informacje specyficzne dla usługi dotyczące błędu. Obiekt InnerError ma następujące właściwości:

Właściwość Type opis
code string Komunikat o błędzie.

Obiekt geometrii wyświetla identyfikatory geometrii geofencingów, które wygasły względem czasu użytkownika w żądaniu. Obiekt geometrii ma elementy geometryczne o następujących właściwościach:

Właściwość Type opis
deviceid string Identyfikator urządzenia.
distance string

Odległość od współrzędnej do najbliższej granicy geofencingu. Dodatnie oznacza, że współrzędna znajduje się poza geofencingiem. Jeśli współrzędna znajduje się poza geofencingiem, ale więcej niż wartość parametru searchBuffer z dala od najbliższego obramowania geofencingu, wartość wynosi 999. Ujemna oznacza, że współrzędna znajduje się wewnątrz geofencencji. Jeśli współrzędna znajduje się wewnątrz wielokąta, ale więcej niż wartość searchBuffer z dala od najbliższego obramowania geofencingu, wartość wynosi -999. Wartość 999 oznacza, że współrzędna jest bardzo pewna, że współrzędna znajduje się na zewnątrz geofencingu. Wartość -999 oznacza, że istnieje duża pewność, że współrzędna jest dobrze w obrębie geofencingu.
geometryid string Unikatowy identyfikator identyfikuje geometrię geofencingu.
nearestlat Liczba Szerokość geograficzna najbliższego punktu geometrii.
nearestlon Liczba Długość geograficzna najbliższego punktu geometrii.
udId string Unikatowy identyfikator zwrócony z usługi przekazywania użytkownika podczas przekazywania geofencingu. Nie zostanie uwzględniony w interfejsie API publikowania geofencingu.

Obiekt danych ma następujące właściwości:

Właściwość Type Opis
expiredGeofenceGeometryId string[] Lista identyfikatora geometrii geofencingu, który wygasł względem czasu użytkownika w żądaniu.
geometries geometrie[] Wyświetla geometrie ogrodzenia, które zawierają położenie współrzędnych lub nakładają się na element searchBuffer wokół pozycji.
invalidPeriodGeofenceGeometryId string[] Lista identyfikatora geometrii geofencingu, który jest w nieprawidłowym okresie względem czasu użytkownika w żądaniu.
isEventPublished boolean Wartość true, jeśli co najmniej jedno zdarzenie zostało opublikowane dla subskrybenta zdarzeń usługi Azure Mapy, wartość false, jeśli żadne zdarzenie nie zostało opublikowane dla subskrybenta zdarzeń usługi Azure Mapy.

Samouczki i poradniki

Nazwa opis
Reagowanie na zdarzenia usługi Azure Mapy przy użyciu usługi Event Grid Omówienie integracji usługi Azure Mapy z usługą Event Grid.
Samouczek: konfigurowanie geofencingu Ten samouczek przeprowadzi Cię przez podstawowe kroki konfigurowania geofencingu przy użyciu usługi Azure Maps. Usługa Azure Event Grid służy do przesyłania strumieniowego wyników geofencingu i konfigurowania powiadomienia na podstawie wyników geofencingu.

Następne kroki

  • Aby zapoznać się z wprowadzeniem do usługi Azure Event Grid, zobacz Co to jest usługa Event Grid?
  • Aby uzyskać więcej informacji na temat tworzenia subskrypcji usługi Azure Event Grid, zobacz Schemat subskrypcji usługi Event Grid.