Azure Mapas como fonte de Grade de Eventos

Este artigo fornece as propriedades e esquemas para eventos Mapas Azure. Para uma introdução aos esquemas de eventos, consulte o esquema do evento Azure Event Grid. Também lhe dá uma lista de partidas rápidas e tutoriais para usar o Azure Mapas como fonte de evento.

Tipos de eventos disponíveis

Uma conta Azure Mapas emite os seguintes tipos de eventos:

Tipo de evento Descrição
A Microsoft. Mapas. GeofenceEnte Levantado quando as coordenadas recebidas mudaram de fora de uma dada geofência para dentro
A Microsoft. Mapas. GeofenceExited Levantado quando as coordenadas recebidas mudaram de dentro de uma dada geofência para fora
A Microsoft. Mapas. GeofenceResult Levantado cada vez que uma consulta geofencing devolve um resultado, independentemente do estado

Exemplo de eventos

O exemplo a seguir mostra o esquema de um evento GeofenceEnte

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

O exemplo a seguir mostra esquema para 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" 
}

Propriedades do evento

Um evento tem os seguintes dados de alto nível:

Propriedade Tipo Description
topic cadeia (de carateres) Caminho completo de recursos para a fonte do evento. Este campo não é escrito. O Event Grid fornece este valor.
subject string Caminho definido pelo publicador para o assunto do evento.
eventType string Um dos tipos de eventos registados para esta origem de evento.
eventTime string O tempo que o evento é gerado com base no tempo UTC do fornecedor.
id string Identificador único para o evento.
data objeto Dados de eventos geofencing.
dataVersion string A versão do esquema do objeto de dados. O publicador define a versão do esquema.
metadataVersion string A versão do esquema dos metadados do evento. O Event Grid define o esquema das propriedades de nível superior. O Event Grid fornece este valor.

O objeto de dados tem as seguintes propriedades:

Propriedade Tipo Description
apiCategory cadeia (de carateres) Categoria API do evento.
apiName string Nome da API do evento.
issues objeto As questões das listas ocorreram durante o processamento. Se algum problema for devolvido, então não haverá geometrias devolvidas com a resposta.
responseCode número Código de resposta HTTP
geometries objeto Lista as geometrias da vedação que contêm a posição da coordenada ou sobrepõem o searchBuffer em torno da posição.

O objeto de erro é devolvido quando ocorre um erro na API Mapas. O objeto de erro tem as seguintes propriedades:

Propriedade Tipo Description
error ErrorDetails Este objeto é devolvido quando ocorre um erro na API Mapas

O objeto ErrorDetails é devolvido quando ocorre um erro na API Mapas. O ErrorDetails ou o objeto tem as seguintes propriedades:

Propriedade Tipo Description
code cadeia (de carateres) O código de estado HTTP.
message string Se disponível, uma descrição legível humana do erro.
innererror InnerError Se disponível, um objeto que contenha informações específicas do serviço sobre o erro.

O InnerError é um objeto que contém informações específicas do serviço sobre o erro. O objeto InnerError tem as seguintes propriedades:

Propriedade Tipo Description
code cadeia (de carateres) A mensagem de erro.

O objeto de geometria, lista iDs de geometria das geossíferas que expiraram em relação ao tempo de utilizador no pedido. O objeto de geometria tem itens de geometria com as seguintes propriedades:

Propriedade Tipo Description
deviceid cadeia (de carateres) Identificação do dispositivo.
distance string

Distância da coordenada até à fronteira mais próxima da geofence. Positivo significa que a coordenada está fora da geofência. Se a coordenada estiver fora da geofência, mas mais do que o valor de searchBuffer longe da fronteira de geofência mais próxima, então o valor é 999. Negativo significa que a coordenada está dentro da geofence. Se a coordenada estiver dentro do polígono, mas mais do que o valor de searchBuffer longe da fronteira geofencante mais próxima, então o valor é -999. Um valor de 999 significa que há uma grande confiança que a coordenada está bem fora da geo-fence. Um valor de -999 significa que há uma grande confiança que a coordenada está bem dentro da geofence.

geometryid string A identificação única identifica a geometria da geofência.
nearestlat número Latitude do ponto mais próximo da geometria.
nearestlon número Longitude do ponto mais próximo da geometria.
udId string O ID único voltou do serviço de upload do utilizador ao carregar uma geofence. Não será incluído na API de geofencing.

O objeto de dados tem as seguintes propriedades:

Propriedade Tipo Description
expiredGeofenceGeometryId corda[] Listas do ID de geometria da geofência que é expirado em relação ao tempo de utilizador no pedido.
geometries geometrias[] Lista as geometrias da vedação que contêm a posição da coordenada ou sobrepõem o searchBuffer em torno da posição.
invalidPeriodGeofenceGeometryId corda[] Listas do ID de geometria da geofência que se encontra em período inválido em relação ao tempo de utilização no pedido.
isEventPublished boolean É verdade que se pelo menos um evento for publicado no Azure Mapas assinante do evento, falso se nenhum evento for publicado no Azure Mapas assinante do evento.

Tutorials and how-tos (Tutoriais e procedimentos)

Título Descrição
React para Azure Mapas eventos usando a Grade de Eventos Visão geral da integração do Azure Mapas com a Grade de Eventos.
Tutorial: Criar uma geofence Este tutorial acompanha-o através dos passos básicos para configurar a geofência usando o Azure Mapas. Utiliza a Grelha de Eventos Azure para transmitir os resultados da geofence e configura uma notificação com base nos resultados da geofence.

Passos seguintes