Sdílet prostřednictvím

Azure Mapy jako zdroj Event Gridu

  • Článek

Tento článek obsahuje vlastnosti a schéma událostí Azure Mapy. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid. Poskytuje také seznam rychlých startů a kurzů pro použití Azure Mapy jako zdroje událostí.

Dostupné typy událostí

Účet Azure Mapy generuje následující typy událostí:

Typ události Popis
Microsoft. Mapy. GeofenceEntered Vyvolána při přesunu souřadnic mimo danou geofenci do
Microsoft. Mapy. GeofenceExited Vyvolána, když byly souřadnice přijaty přesunuty z dané geografické zóny do vnější
Microsoft. Mapy. GeofenceResult Vyvolá se pokaždé, když geofencingový dotaz vrátí výsledek bez ohledu na stav.

Příklady událostí

Následující příklad ukazuje schéma události 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" 
}

Následující příklad ukazuje schéma pro 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" 
}

Vlastnosti události

Událost má následující data nejvyšší úrovně:

Vlastnost Type Description
source string Úplná cesta prostředku ke zdroji událostí. Toto pole není zapisovatelné. Tuto hodnotu poskytuje Event Grid.
subject string Cesta k předmětu události, kterou definuje vydavatel.
type string Jeden z registrovaných typů události pro tento zdroj události.
time string Čas vygenerování události na základě času UTC poskytovatele.
id string Jedinečný identifikátor události.
data objekt Data událostí geografické fencingu
specversion string Verze specifikace schématu CloudEvents

Datový objekt má následující vlastnosti:

Vlastnost Type Description
apiCategory string Kategorie rozhraní API události
apiName string Název rozhraní API události.
issues objekt Během zpracování došlo k problémům se seznamy. Pokud se vrátí nějaké problémy, nebudou vráceny žádné geometrie s odpovědí.
responseCode Číslo Kód odpovědi protokolu HTTP
geometries objekt Zobrazí seznam geometrií plotu, které obsahují pozici souřadnic nebo překrývají vyhledáváníBuffer kolem pozice.

Objekt chyby se vrátí, když dojde k chybě v rozhraní API Mapy. Objekt chyby má následující vlastnosti:

Vlastnost Type Popis
error ErrorDetails Tento objekt se vrátí, když dojde k chybě v rozhraní MAPY API.

ErrorDetails objekt je vrácen, když dojde k chybě v rozhraní Mapy API. ErrorDetails nebo objekt má následující vlastnosti:

Vlastnost Type Description
code string Stavový kód HTTP
message string Pokud je k dispozici, popis chyby čitelný člověkem.
innererror Vnitřní chyba Pokud je k dispozici, objekt obsahující informace o chybě specifické pro službu.

InnerError je objekt obsahující informace o chybě specifické pro službu. Objekt InnerError má následující vlastnosti:

Vlastnost Type Description
code string Chybová zpráva

Objekt geometrie uvádí ID geometrie geofence, jejichž platnost vypršela vzhledem k času uživatele v požadavku. Objekt geometrie obsahuje položky geometrie s následujícími vlastnostmi:

Vlastnost Type Description
deviceid string ID zařízení.
distance string

Vzdálenost od souřadnice k nejbližšímu ohraničení geografické zóny. Pozitivní znamená, že souřadnice je mimo geofence. Pokud je souřadnice mimo geofence, ale více než hodnota searchBuffer daleko od nejbližšího ohraničení geografické zóny, pak je hodnota 999. Negativní znamená, že souřadnice je uvnitř geografické zóny. Pokud je souřadnice uvnitř mnohoúhelníku, ale více než hodnota searchBuffer daleko od nejbližšího ohraničení geografické fencingu, je hodnota -999. Hodnota 999 znamená, že souřadnice je dobrá mimo geofence. Hodnota -999 znamená, že souřadnice je dobře v rámci geografické zóny.
geometryid string Jedinečné ID identifikuje geometrii geofence.
nearestlat Číslo Zeměpisná šířka nejbližšího bodu geometrie.
nearestlon Číslo Zeměpisná délka nejbližšího bodu geometrie.
udId string Jedinečné ID vrácené službou pro nahrání uživatele při nahrávání geografické zóny. Do rozhraní API geograficky fencingu se nezahrnou.

Datový objekt má následující vlastnosti:

Vlastnost Type Popis
expiredGeofenceGeometryId string[] Seznamy ID geometrie geografické zóny, jehož platnost vypršela vzhledem k času uživatele v požadavku.
geometries geometrie[] Zobrazí seznam geometrií plotu, které obsahují pozici souřadnic nebo překrývají vyhledáváníBuffer kolem pozice.
invalidPeriodGeofenceGeometryId string[] Seznamy ID geometrie geografické zóny, která je v neplatném období vzhledem k času uživatele v požadavku.
isEventPublished boolean Hodnota True, pokud je alespoň jedna událost publikovaná pro předplatitele události Azure Mapy, nepravda, pokud se pro předplatitele události Azure Mapy nepublikuje žádná událost.

Kurzy a postupy

Titulek Popis
Reakce na události Azure Mapy pomocí Event Gridu Přehled integrace azure Mapy se službou Event Grid
Kurz: Nastavení geografické zóny Tento kurz vás provede základy nastavení geografické zóny pomocí Azure Mapy. Azure Event Grid použijete k streamování výsledků geografické zóny a nastavení oznámení na základě výsledků geografické zóny.

Další kroky

  • Úvod do Azure Event Gridu najdete v tématu Co je Event Grid?
  • Další informace o vytvoření odběru služby Azure Event Grid najdete ve schématu odběru služby Event Grid.