Passer au contenu principal
client.photo_faces() -> pd.DataFrame
Télécharge les boîtes englobantes de visages qui font le lien entre les visages détectés sur les photos et les personnes identifiées.

​
Renvoie

pd.DataFrame contenant les données de détection de visages.

​
Exemple

from jmail import JmailClient

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

# Jointure pour récupérer les noms des personnes
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))

​
Colonnes

ColonneTypeDescription
idintIdentifiant unique de détection de visage
photo_idintClé étrangère vers la table photos
person_idintClé étrangère vers la table people
bbox_leftfloatBord gauche de la boîte englobante (normalisée entre 0 et 1)
bbox_topfloatBord supérieur de la boîte englobante (normalisée entre 0 et 1)
bbox_widthfloatLargeur de la boîte englobante (normalisée entre 0 et 1)
bbox_heightfloatHauteur de la boîte englobante (normalisée entre 0 et 1)
confidencefloatScore de confiance de la détection

​
URL directes

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