Link to this sectionContagem de objetos em regiões com Ultralytics YOLO26#

A solução RegionCounter no Ultralytics YOLO26 rastreia objetos em quadros de vídeo e, em cada quadro, conta os objetos cujo centro da bbox cai dentro de cada região definida por você. Cada região é desenhada no quadro com sua própria contagem ao vivo, permitindo monitorar várias zonas, como corredores de lojas, faixas de rodovias ou áreas de produção, com uma única chamada Python ou comando CLI.

Link to this sectionPor que usar a contagem de regiões?#

• Várias zonas de uma só vez: Passe um dicionário de polígonos nomeados e cada zona receberá uma contagem independente desenhada no quadro, para que um fluxo de vídeo cubra todas as áreas que lhe interessam.
• Rastreamento integrado: A solução executa a detecção do YOLO26 e o rastreamento de objetos internamente, portanto, não há um pipeline de rastreamento separado para configurar.
• Contagens que você pode ler programaticamente: Cada quadro processado retorna um objeto de resultados com um dicionário de contagens de regiões, pronto para painéis, alertas ou registro de logs.

Link to this sectionAplicações no mundo real#

Varejo	Ruas comerciais
Contagem de pessoas em regiões com Ultralytics YOLO	Contagem de multidões em regiões com Ultralytics YOLO

Link to this sectionComo contar objetos em regiões com Ultralytics YOLO#

Execute a solução RegionCounter em uma fonte de vídeo via CLI ou Python. Uma região pode ser uma lista de pontos (uma única zona) ou um dicionário que mapeia nomes de zonas para listas de pontos. O exemplo Python abaixo conta objetos em duas regiões nomeadas e grava os quadros processados em um arquivo de vídeo de saída:

# Run a region counting example
yolo solutions region show=True

# Pass a source video
yolo solutions region source="path/to/video.mp4"

# Pass a custom region
yolo solutions region region="[(20, 400), (1080, 400), (1080, 360), (20, 360)]"

Link to this sectionArgumentos do RegionCounter()#

Aqui tens uma tabela com os argumentos do RegionCounter:

A solução RegionCounter permite a utilização de parâmetros de rastreamento de objetos:

Adicionalmente, as seguintes definições de visualização são suportadas:

Link to this sectionComo a contagem de regiões funciona#

A solução RegionCounter transforma cada região fornecida em um polígono, com pelo menos três pontos por região. Uma lista simples de pontos torna-se uma zona única chamada Region#01, enquanto um dicionário mantém seus próprios nomes de zonas; cada zona é desenhada com sua própria cor da paleta Ultralytics. Cada quadro é então processado em três etapas:

1. O rastreamento YOLO26 detecta e segue cada objeto no quadro
2. Para cada objeto rastreado, a solução calcula o centro da bbox e verifica quais polígonos de região o contêm
3. A contagem de cada região é desenhada em seu centro, e as contagens são reiniciadas antes do próximo quadro

Como as contagens reiniciam a cada quadro, o número mostrado em uma região representa sua ocupação atual, ou seja, quantos objetos estão dentro dela naquele momento, e não um total acumulado. Para contar objetos cruzando uma fronteira de forma cumulativa, use a solução ObjectCounter em vez disso.

Cada chamada também retorna um objeto de resultados cujo atributo plot_im contém o quadro anotado e cujo dicionário region_counts mapeia nomes de regiões para suas contagens, para que você possa alimentar esses números na sua própria lógica de aplicação.

Link to this sectionConclusão#

A solução RegionCounter do Ultralytics YOLO26 monitora contagens de objetos ao vivo em quantas zonas nomeadas você precisar com apenas algumas linhas de código. Para ir além, conte cruzamentos de fronteiras com a contagem de objetos, rastreie objetos dentro de uma única zona com o TrackZone ou explore as outras Soluções Ultralytics.

Link to this sectionFAQ#

Link to this sectionComo a contagem de objetos em regiões funciona no Ultralytics YOLO26?#

O Ultralytics YOLO26 conta objetos em regiões rastreando cada objeto no quadro e testando se o centro da bbox do objeto está dentro de cada polígono definido pelo usuário. A contagem exibida em uma região é sua ocupação atual para aquele quadro, não um total acumulado. As opções de configuração estão listadas na seção Argumentos do RegionCounter().

Link to this sectionComo posso contar objetos em várias regiões de uma só vez?#

Passe o argumento region como um dicionário que mapeia nomes de zonas para listas de pontos, como no exemplo principal:

from ultralytics import solutions

region_points = {
    "region-01": [(50, 50), (250, 50), (250, 250), (50, 250)],
    "region-02": [(640, 640), (780, 640), (780, 720), (640, 720)],
}
regioncounter = solutions.RegionCounter(region=region_points, model="yolo26n.pt", show=True)

Cada zona nomeada é desenhada com sua própria cor com uma contagem independente.

Link to this sectionComo obtenho as contagens de regiões programaticamente?#

O objeto retornado por cada chamada regioncounter(im0) contém um dicionário region_counts que mapeia nomes de regiões para suas contagens, juntamente com plot_im (o quadro anotado) e total_tracks (o número de objetos rastreados). Imprima o objeto de resultados para inspecionar todos os campos disponíveis.

Link to this sectionPosso contar apenas classes de objetos específicas em uma região?#

Sim. Passe o argumento classes com os índices das classes que deseja manter, por exemplo classes=[0] para contar apenas pessoas com um modelo pré-treinado no COCO. A lista completa de argumentos relacionados ao rastreamento está na seção Argumentos do RegionCounter().

Link to this sectionQual é a diferença entre RegionCounter e ObjectCounter?#

O RegionCounter mostra quantos objetos estão dentro de cada zona poligonal no quadro atual, enquanto o ObjectCounter conta objetos cumulativamente à medida que cruzam uma linha ou limite de região, rastreando totais de entrada e saída. Use o RegionCounter para ocupação ao vivo de uma ou mais zonas e o ObjectCounter para contagem de entrada e saída; regiões em formato de linha são suportadas apenas pelo ObjectCounter.