photo_faces() - Jmail Data API

client.photo_faces() -> pd.DataFrame

Baixe caixas delimitadoras de rostos que associam rostos detectados em fotos a pessoas identificadas.

Retorno

pd.DataFrame com dados de detecção facial.

Exemplo

from jmail import JmailClient

client = JmailClient()
faces = client.photo_faces()
people = client.people()

# Junção para obter nomes de pessoas
import pandas as pd
merged = faces.merge(people[["id", "name"]], left_on="person_id", right_on="id", suffixes=("", "_person"))
print(merged.groupby("name").size().sort_values(ascending=False).head(20))

Colunas

Coluna	Tipo	Descrição
`id`	int	ID único de detecção de rosto
`photo_id`	int	FK para a tabela de fotos
`person_id`	int	FK para a tabela de pessoas
`bbox_left`	float	Borda esquerda da caixa delimitadora (normalizada entre 0 e 1)
`bbox_top`	float	Borda superior da caixa delimitadora (normalizada entre 0 e 1)
`bbox_width`	float	Largura da caixa delimitadora (normalizada entre 0 e 1)
`bbox_height`	float	Altura da caixa delimitadora (normalizada entre 0 e 1)
`confidence`	float	Pontuação de confiança da detecção

URLs diretas

https://data.jmail.world/v1/photo_faces.parquet
https://data.jmail.world/v1/photo_faces.ndjson.gz