Azure Mapy jako zdroj Event Gridu

Článek
03/05/2024

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.

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

Následující příklad ukazuje schéma události GeofenceEntered .

{   
   "id":"7f8446e2-1ac7-4234-8425-303726ea3981", 
   "topic":"/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":[   
      ] 
   }, 
   "eventType":"Microsoft.Maps.GeofenceEntered", 
   "eventTime":"2018-11-08T00:54:17.6408601Z", 
   "metadataVersion":"1", 
   "dataVersion":"1.0" 
}

Následující příklad ukazuje schéma pro GeofenceResult

{   
   "id":"451675de-a67d-4929-876c-5c2bf0b2c000", 
   "topic":"/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":[   
      ] 
   }, 
   "eventType":"Microsoft.Maps.GeofenceResult", 
   "eventTime":"2018-11-08T00:52:08.0954283Z", 
   "metadataVersion":"1", 
   "dataVersion":"1.0" 
}

Vlastnosti události

Schéma cloudových událostí
Schéma událostí Event Gridu

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

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

Vlastnost	Type	Description
`topic`	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.
`eventType`	string	Jeden z registrovaných typů události pro tento zdroj události.
`eventTime`	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
`dataVersion`	string	Verze schématu datového objektu. Verzi schématu definuje vydavatel.
`metadataVersion`	string	Verze schématu metadat události. Schéma vlastností nejvyšší úrovně definuje Event Grid. Tuto hodnotu poskytuje Event Grid.

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.

Sdílet prostřednictvím