メインコンテンツへスキップ
client.photo_faces() -> pd.DataFrame
写真で検出された顔と識別済み人物を紐付ける顔領域（バウンディングボックス）をダウンロードします。

​
戻り値

顔検出データを含む pd.DataFrame を返します。

​
例

from jmail import JmailClient

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

# 人物名を取得するために結合する
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))

​
カラム

ColumnTypeDescription
idint顔検出ごとの一意ID
photo_idintphotos テーブルへの外部キー
person_idintpeople テーブルへの外部キー
bbox_leftfloatバウンディングボックス左端（0〜1に正規化された値）
bbox_topfloatバウンディングボックス上端（0〜1に正規化された値）
bbox_widthfloatバウンディングボックスの幅（0〜1に正規化された値）
bbox_heightfloatバウンディングボックスの高さ（0〜1に正規化された値）
confidencefloat検出の信頼度スコア

​
ダイレクトURL

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