Azure Mapas como uma origem da Grade de Eventos

  • Artigo

Este artigo fornece as propriedades e o esquema dos eventos do Azure Mapas. Para obter uma introdução a esquemas de evento, consulte esquema de grade de eventos do Azure. Ele também fornece uma lista de guias de início rápido e de tutoriais para usar o Azure Mapas como uma origem do evento.

Tipos de evento disponíveis

Uma conta do Azure Mapas emite os seguintes tipos de eventos:

Tipo de evento Descrição
Microsoft.Maps.GeofenceEntered Gerado quando as coordenadas recebidas são movidas de fora de uma determinada cerca geográfica para dentro
Microsoft.Maps.GeofenceExited Gerado quando as coordenadas recebidas são movidas de dentro de uma determinada cerca geográfica para fora
Microsoft.Maps.GeofenceResult Gerado sempre que uma consulta de delimitação geográfica retorna um resultado, independentemente do estado

Exemplos de eventos

O exemplo a seguir mostra o esquema de um evento 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" 
}

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

Propriedades do evento

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

Propriedade Type Descrição
source string Caminho de recurso completo para a origem do evento. Este campo não é gravável. A Grade de Eventos fornece esse valor.
subject string Caminho definido pelo publicador para o assunto do evento.
type string Um dos tipos de evento registrados para a origem do evento.
time string A hora em que o evento é gerado com base na hora UTC do provedor.
id string Identificador exclusivo do evento.
data objeto Dados de evento de delimitação geográfica.
specversion string Versão de especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Descrição
apiCategory string Categoria da API do evento.
apiName string Nome da API do evento.
issues objeto Lista os problemas que ocorreram durante o processamento. Se algum problema for retornado, não haverá geometrias retornadas com a resposta.
responseCode número Código de resposta HTTP
geometries objeto Lista as geometrias de delimitação que contêm a posição da coordenada ou sobrepõem o searchBuffer em torno da posição.

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

Propriedade Type Descrição
error ErrorDetails Esse objeto é retornado quando ocorre um erro na API de Mapas

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

Propriedade Type Descrição
code string O código de status HTTP.
message string Se disponível, uma descrição do erro em formato legível por humanos.
innererror InnerError Se disponível, um objeto contendo 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 Type Descrição
code string A mensagem de erro.

O objeto geometries lista IDs de geometria das cercas geográficas que expiraram em relação ao tempo do usuário na solicitação. O objeto de geometrias contém itens de geometria com as seguintes propriedades:

Propriedade Type Descrição
deviceid string ID do dispositivo.
distance string

Distância da coordenada até a borda mais próxima da cerca geográfica. Positivo significa que a coordenada está fora da cerca geográfica. Se a coordenada estiver fora da cerca geográfica, mas for maior que o valor de searchBuffer distante da borda da cerca geográfica mais próxima, o valor será 999. Negativo significa que a coordenada está dentro da cerca geográfica. Se a coordenada estiver dentro do polígono, mas for maior que o valor de searchBuffer distante da borda de delimitação geográfica mais próxima, o valor será -999. Um valor de 999 significa que há uma grande confiança de que a coordenada está bem fora da cerca geográfica. Um valor de -999 significa que há uma grande confiança de que a coordenada está bem dentro da cerca geográfica.
geometryid string A ID exclusiva identifica a geometria da cerca geográfica.
nearestlat número Latitude do ponto mais próximo da geometria.
nearestlon número Longitude do ponto mais próximo da geometria.
udId string A ID exclusiva retornada do serviço de upload do usuário ao carregar uma cerca geográfica. Não será incluída na API de postagem de delimitação geográfica.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Descrição
expiredGeofenceGeometryId string[] Listas da ID de geometria da cerca geográfica que é expirada em relação ao tempo do usuário na solicitação.
geometries geometries[] Lista as geometrias de delimitação que contêm a posição da coordenada ou sobrepõem o searchBuffer em torno da posição.
invalidPeriodGeofenceGeometryId string[] Listas da ID de geometria da cerca geográfica que está em período inválido em relação ao tempo do usuário na solicitação.
isEventPublished booleano True se pelo menos um evento for publicado no assinante de evento do Azure Mapas e false se nenhum evento for publicado no assinante de evento do Azure Mapas.

Tutoriais e instruções

Título Descrição
Reagir a eventos do Azure Mapas usando a Grade de Eventos Visão geral da integração do Azure Mapas com a Grade de Eventos.
Tutorial: configurar uma cerca geográfica Este tutorial orienta você pelas etapas básicas para configurar uma cerca geográfica usando o Azure Mapas. Você usa a Grade de Eventos do Azure para transmitir os resultados da cerca geográfica e configurar uma notificação de acordo com os resultados desse limite.

Próximas etapas