Pular para o conteúdo principal
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

ColunaTipoDescrição
idintID único de detecção de rosto
photo_idintFK para a tabela de fotos
person_idintFK para a tabela de pessoas
bbox_leftfloatBorda esquerda da caixa delimitadora (normalizada entre 0 e 1)
bbox_topfloatBorda superior da caixa delimitadora (normalizada entre 0 e 1)
bbox_widthfloatLargura da caixa delimitadora (normalizada entre 0 e 1)
bbox_heightfloatAltura da caixa delimitadora (normalizada entre 0 e 1)
confidencefloatPontuaçã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