Azure Maps como uma origem de Grade de Eventos

  • Artigo

Este artigo fornece as propriedades e o esquema para eventos do Azure Maps. Para obter uma introdução aos esquemas de eventos, consulte Esquema de eventos da Grade de Eventos do Azure. Ele também fornece uma lista de inícios rápidos e tutoriais para usar o Azure Maps como uma fonte de eventos.

Tipos de eventos disponíveis

Uma conta do Azure Maps emite os seguintes tipos de evento:

Tipo de evento Description
Microsoft.Maps.GeofenceEntered Levantado quando as coordenadas recebidas se moveram de fora de uma determinada cerca geográfica para dentro
Microsoft.Maps.GeofenceExited Levantadas quando as coordenadas recebidas se deslocaram de dentro de uma determinada cerca geográfica para o exterior
Microsoft.Maps.GeofenceResult Gerado sempre que uma consulta de cerca 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 Description
source string Caminho completo do recurso para a origem do evento. Este campo não pode ser gravado. O Event Grid fornece este valor.
subject string Caminho definido pelo publicador para o assunto do evento.
type string Um dos tipos de eventos registados para esta origem de 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 eventos de delimitação geográfica.
specversion string Versão da especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Description
apiCategory string Categoria API do evento.
apiName string Nome da API do evento.
issues objeto Lista os problemas ocorridos 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 vedaçã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 do Google Maps. O objeto error tem as seguintes propriedades:

Propriedade Type Description
error ErrorDetails Este objeto é retornado quando ocorre um erro na API do Google Maps

O objeto ErrorDetails é retornado quando ocorre um erro na API do Google Maps. O objeto ErrorDetails ou tem as seguintes propriedades:

Propriedade Type Description
code string O código de status HTTP.
message string Se disponível, uma descrição do erro 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 Description
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 geometries tem itens de geometria com as seguintes propriedades:

Propriedade Type Description
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 mais do que o valor de searchBuffer longe da borda de 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 mais do que o valor de searchBuffer longe da borda de cerca geográfica mais próxima, o valor será -999. Um valor de 999 significa que há grande confiança de que a coordenada está bem fora da cerca geográfica. Um valor de -999 significa que há grande confiança de que a coordenada está bem dentro da cerca geográfica.
geometryid string O ID exclusivo 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 O ID exclusivo retornado do serviço de carregamento do usuário ao carregar uma cerca geográfica. Não será incluído na API de postagem de cerca geográfica.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Description
expiredGeofenceGeometryId string[] Listas do ID de geometria da cerca geográfica que expirou em relação ao tempo do usuário na solicitação.
geometries Geometrias[] Lista as geometrias de vedação que contêm a posição da coordenada ou sobrepõem o searchBuffer em torno da posição.
invalidPeriodGeofenceGeometryId string[] Listas do 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 boolean True se pelo menos um evento for publicado no assinante do evento do Azure Maps, false se nenhum evento for publicado no assinante do evento do Azure Maps.

Tutorials and how-tos (Tutoriais e procedimentos)

Title Description
Reagir a eventos do Azure Maps usando a Grade de Eventos Visão geral da integração do Azure Maps com a Grade de Eventos.
Tutorial: Configurar uma cerca geográfica Este tutorial orienta você pelas etapas básicas para configurar a cerca geográfica usando o Azure Maps. Você usa a Grade de Eventos do Azure para transmitir os resultados da cerca geográfica e configurar uma notificação com base nos resultados da cerca geográfica.

Próximos passos

  • Para obter uma introdução à Grade de Eventos do Azure, consulte O que é a Grade de Eventos?
  • Para obter mais informações sobre como criar uma assinatura da Grade de Eventos do Azure, consulte Esquema de assinatura da Grade de Eventos.