Zum Hauptinhalt springen
client.photo_faces() -> pd.DataFrame
Lade Bounding Boxes für Gesichter herunter, die erkannte Gesichter in Fotos identifizierten Personen zuordnen.

Rückgabewert

pd.DataFrame mit Daten zur Gesichtserkennung.

Beispiel

from jmail import JmailClient

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

# Join durchführen, um Personennamen zu erhalten
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))

Spalten

SpalteTypBeschreibung
idintEindeutige ID für eine Gesichtserkennung
photo_idintFK zur Tabelle photos
person_idintFK zur Tabelle people
bbox_leftfloatLinker Rand der Bounding Box (normalisiert auf 0–1)
bbox_topfloatOberer Rand der Bounding Box (normalisiert auf 0–1)
bbox_widthfloatBreite der Bounding Box (normalisiert auf 0–1)
bbox_heightfloatHöhe der Bounding Box (normalisiert auf 0–1)
confidencefloatKonfidenzwert der Erkennung

Direkte URLs

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