Saltar al contenido principal
client.photo_faces() -> pd.DataFrame
Descarga cajas delimitadoras de rostros que vinculan los rostros detectados en fotos con personas identificadas.

​
Devuelve

pd.DataFrame con datos de detección facial.

​
Ejemplo

from jmail import JmailClient

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

# Unir para obtener los nombres de las personas
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))

​
Columnas

ColumnTypeDescription
idintIdentificador único de la detección de rostro
photo_idintClave foránea (FK) a la tabla de fotos
person_idintClave foránea (FK) a la tabla de personas
bbox_leftfloatBorde izquierdo del cuadro delimitador (normalizado entre 0 y 1)
bbox_topfloatBorde superior del cuadro delimitador (normalizado entre 0 y 1)
bbox_widthfloatAncho del cuadro delimitador (normalizado entre 0 y 1)
bbox_heightfloatAltura del cuadro delimitador (normalizado entre 0 y 1)
confidencefloatPuntuación de confianza de la detección

​
URLs directas

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