> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/cameras-and-gravadores/integracao-api-cftvip-e-mibo/cameras-e-gravadores/mapa-de-calor-pessoas.md). # Mapa de Calor (Pessoas) Integração: APIs de mapa de calor para obter imagem/dados binários e assinar streams (raw/trace real e histórico) via multipart, com heartbeat e conexão persistente. ## Dicas & Boas Práticas * Mantenha a conexão HTTP de assinatura **sempre ativa**, garantindo que o cliente esteja preparado para reconexão automática em caso de queda de rede. * Utilize o campo **EventBaseInfo.Code** para identificar o tipo de evento e implementar tratamentos específicos para cada código no sistema assinante. * Sempre valide o campo **EventBaseInfo.Action** (`Start`, `Stop` ou `Pulse`) antes de processar o evento, evitando interpretações incorretas do ciclo do evento. * Ao lidar com múltiplos eventos simultâneos, utilize **GroupID**, **CountInGroup** e **IndexInGroup** para correlacionar corretamente eventos pertencentes ao mesmo grupo. *** ### Tabela de Parâmetros

Campo	Tipo	R/O	Descrição	Exemplo
summary	object	R	Resumo das estatísticas de pessoas no vídeo	—
summary.Channel	int	R	Índice do canal de vídeo (inicia em 0)	0
summary.RuleName	string	R	Tipo de regra (`ManNumDetection` ou `NumberStat`)	NumberStat
summary.EnteredSubtotal	object	O	Estatísticas de entrada	—
summary.EnteredSubtotal.Total	int	R	Total de entradas	14
summary.EnteredSubtotal.Today	int	R	Entradas do dia	2
summary.EnteredSubtotal.Hour	int	R	Entradas da hora	1
summary.EnteredSubtotal.TotalInTimeSection	int	O	Entradas após `clearSectionStat`	0
summary.ExitedSubtotal	object	O	Estatísticas de saída	—
summary.ExitedSubtotal.Total	int	R	Total de saídas	32
summary.ExitedSubtotal.Today	int	R	Saídas do dia	3
summary.ExitedSubtotal.Hour	int	R	Saídas da hora	2
summary.ExitedSubtotal.TotalInTimeSection	int	O	Saídas após `clearSectionStat`	0
summary.PassedSubtotal	object	O	Estatísticas de passagem	—
summary.PassedSubtotal.Total	int	R	Total de passagens	32
summary.PassedSubtotal.Today	int	R	Passagens do dia	0
summary.PassedSubtotal.Hour	int	R	Passagens da hora	0
summary.EnteredDupSubtotal	object	O	Entradas duplicadas	—
summary.EnteredDupSubtotal.Total	int	R	Total de entradas duplicadas	14
summary.EnteredDupSubtotal.Today	int	R	Entradas duplicadas do dia	0
summary.EnteredDupSubtotal.Hour	int	R	Entradas duplicadas da hora	0
summary.ExitedDupSubtotal	object	O	Saídas duplicadas	—
summary.ExitedDupSubtotal.Total	int	R	Total de saídas duplicadas	32
summary.ExitedDupSubtotal.Today	int	R	Saídas duplicadas do dia	0
summary.ExitedDupSubtotal.Hour	int	R	Saídas duplicadas da hora	0
summary.InsideSubtotal	object	O	Pessoas dentro da região	—
summary.InsideSubtotal.Total	int	R	Total atual de pessoas	65
summary.InsideSubtotal.ManStayStat	object[]	O	Histórico de permanência	—
summary.InsideSubtotal.ManStayStat.EnterTime	string	O	Horário de entrada	2012-01-04 00:00:00
summary.InsideSubtotal.ManStayStat.ExitTime	string	O	Horário de saída	2012-01-04 00:00:45
summary.EnteredNoDupSubtotal	object	O	Entradas após deduplicação	—
summary.EnteredNoDupSubtotal.Total	uint32	O	Total acumulado	65325
summary.EnteredNoDupSubtotal.Today	uint32	O	Total do dia	32
summary.EnteredNoDupSubtotal.Hour	uint32	O	Total da hora	32
summary.ExitedNoDupSubtotal	object	O	Saídas após deduplicação	—
summary.ExitedNoDupSubtotal.Total	uint32	O	Total acumulado	65325
summary.ExitedNoDupSubtotal.Today	uint32	O	Total do dia	32
summary.ExitedNoDupSubtotal.Hour	uint32	O	Total da hora	32
summary.RealNumber	object	O	Número real corrigido (uso cauteloso)	—
summary.RealNumber.Total	uint32	O	Total acumulado	65325
summary.RealNumber.Today	uint32	O	Total do dia	32
summary.RealNumber.Hour	uint32	O	Total da hora	32
summary.EnteredFilterSubtotal	object	O	Entradas de funcionários	—
summary.EnteredFilterSubtotal.Total	uint32	O	Total acumulado	65325
summary.EnteredFilterSubtotal.Today	uint32	O	Total do dia	32
summary.EnteredFilterSubtotal.Hour	uint32	O	Total da hora	32
summary.ExitedFilterSubtotal	object	O	Saídas de funcionários	—
summary.ExitedFilterSubtotal.Total	uint32	O	Total acumulado	65325
summary.ExitedFilterSubtotal.Today	uint32	O	Total do dia	32
summary.ExitedFilterSubtotal.Hour	uint32	O	Total da hora	32

*** ### Obter Informações do Mapa de Calor **Tópicos**: Recupera a imagem do mapa de calor gerada dentro de um intervalo de tempo específico. * **Métodos: `GET`**`/cgi-bin/heatMap.cgi?action=getPicByTime` **Exemplo:** ```powershell http:///cgi-bin/heatMap.cgi?action=getPicByTime&channel=1&StartTime=2015-08-20%20 00:00:00&EndTime=2015-08-21%2023:59:59&PtzPresetId=1 ``` **Resposta:** ```http HTTP/1.1 200 OK Server: Device/1.0 Content-Type: application/octet-stream Content-Length: ``` ### Obter Informações do Mapa de Calor Baseado em Pessoas **Tópicos**: Obtém dados binários do mapa de calor baseado em estatísticas de movimentação/presença de pessoas. * **Métodos: `GET`**`/cgi-bin/videoStatServer.cgi?action=getHeatMap` **Exemplo:** ```http http:///cgi-bin/videoStatServer.cgi?action=getHeatMap&channel=1&PlanID=2&StartTime =2010-05-12%2020:00:00&EndTime=2010-05-12%2022:00:00&HeatMapType=AverageStayTime ``` **Resposta:** ```http HTTP/1.1 200 OK Server: Device/1.0 Content-Type: application/octet-stream Content-Length: ``` ### Assinar Informações de Rastreamento em Tempo Real **Tópicos**: Mantém uma conexão persistente que envia dados de rastreamento em tempo real, incluindo mensagens de heartbeat. * **Métodos: `GET`**`/cgi-bin/videoStatServer.cgi?action=attachRealTraceProc` **Exemplo:** ```http http:///cgi-bin/videoStatServer.cgi?action=attachRealTraceProc&channel=1&heartbeat=5 ``` **Resposta:** ```http HTTP/1.1 200 OK Server: Device/1.0 Content-Type: multipart/x-mixed-replace; boundary= Connection: closed -- Content-Type: application/octet-stream Content-Length: -- Content-Type: text/plain Content-Length: 11 Heartbeat -- Content-Type: application/octet-stream Content-Length: --/cgi-bin/videoStatServer.cgi?action=getHistoryTrace&channel=1&PlanID=2&StartTi me=2010-05-12%2020:00:00&EndTime=2010-05-12%2022:00:00 ``` **Resposta:** ```http HTTP/1.1 200 OK Server: Device/1.0 Content-Type: multipart/x-mixed-replace; boundary= Connection: closed -- Content-Type: application/octet-stream Content-Length: -- Content-Type: application/octet-stream Content-Length: -- ``` ### Assinar Dados Brutos do Mapa de Calor **Tópicos**: Assinatura contínua que transmite dados brutos do mapa de calor com heartbeat para manter a conexão ativa. * **Métodos: `GET`**`/cgi-bin/HeatMapManager.cgi?action=attachRaw` **Exemplo:** ```http http:///cgi-bin/HeatMapManager.cgi?action=attachRaw&channel=1&heartbeat=5 ``` **Resposta:** ```http HTTP/1.1 200 OK Server: Device/1.0 Content-Type: multipart/x-mixed-replace; boundary= Connection: closed -- Content-Type: application/octet-stream Content-Length: -- Content-Type: text/plain Content-Length: 11 Heartbeat - Content-Type: application/octet-stream Content-Length: -- ``` *** Notas Finais: * Todas as rotas retornam **dados binários**, exigindo cliente compatível para leitura de stream. * Métodos com `attach` mantêm **conexão persistente**, ideal para aplicações de monitoramento contínuo. * O parâmetro **heartbeat** evita encerramento automático da conexão. * Intervalos de tempo devem estar no formato `YYYY-MM-DD HH:MM:SS` (URL encoded). * Ferramentas simples de teste HTTP podem não interpretar corretamente respostas multipart, prefira clientes com suporte a streaming. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://portal-integracao.intelbras.com.br/cameras-and-gravadores/integracao-api-cftvip-e-mibo/cameras-e-gravadores/mapa-de-calor-pessoas.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.