Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Azure Mapas se integra à Grade de Eventos do Azure, para que os usuários possam enviar notificações de eventos para outros serviços e disparar processos downstream. A finalidade deste artigo é ajudá-lo a configurar seus aplicativos de negócios para ouvir eventos do Azure Mapas. Isso permite que os usuários reajam a eventos críticos de maneira confiável, escalonável e segura. Por exemplo, os usuários podem criar um aplicativo para atualizar um banco de dados ao criar um tíquete e entregar uma notificação por email sempre que um novo dispositivo entrar em um limite geográfico.
A Grade de Eventos do Azure é um serviço de roteamento de eventos totalmente gerenciado que usa um modelo de publicação-assinatura. A Grade de Eventos tem suporte interno para serviços do Azure, como Azure Functions e Aplicativos Lógicos do Azure. Ela pode entregar alertas de eventos para serviços que não são do Azure usando webhooks. Para obter uma lista completa dos manipuladores de eventos que dá suporte a Grade de Eventos, consulte Uma introdução à Grade de Eventos do Azure.
Tipos de eventos do Azure Mapas
O Event Grid usa assinaturas de eventos para rotear mensagens de eventos para os assinantes. Uma conta do Azure Mapas emite os seguintes tipos de evento:
| Tipo de evento | Descrição |
|---|---|
| Microsoft.Maps.GeofenceEntered | Ativado quando as coordenadas recebidas se movem 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 |
Esquema do evento
O exemplo a seguir mostra o esquema de 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
}
],
"expiredGeofenceGeometryId":[
],
"invalidPeriodGeofenceGeometryId":[
]
},
"eventType":"Microsoft.Maps.GeofenceResult",
"eventTime":"2018-11-08T00:52:08.0954283Z",
"metadataVersion":"1",
"dataVersion":"1.0"
}
Dicas para o consumo de eventos
Os aplicativos que lidam com eventos de cerca geográfica do Azure Mapas devem seguir algumas práticas recomendadas:
- Configure várias assinaturas para rotear eventos para o mesmo manipulador de eventos. É importante não assumir que os eventos são de uma fonte específica. Sempre verifique o tópico da mensagem para garantir que a mensagem veio da origem esperada.
- Use o
X-Correlation-idcampo no cabeçalho de resposta para entender se suas informações sobre objetos estão atualizadas. As mensagens podem ser recebidas fora de ordem ou após um atraso. - Quando uma solicitação de GET ou POST é chamada na API de Cerca Geográfica com o parâmetro de modo definido como
EnterAndExit, um evento de Entrada ou Saída é gerado para cada geometria na cerca geográfica para a qual o status foi alterado desde a última chamada da API da Cerca Geográfica.
Próximas Etapas
Para obter detalhes sobre todos os eventos compatíveis com o Azure Mapas e o esquema, consulte o Azure Mapas como uma origem da Grade de Eventos.
Para saber mais sobre como usar o geofencing para controlar operações em um canteiro de obras, confira: