Tag

A tag of an individual in a media item as represented in the Family Graph API.

The tag object contains information about where an individual is tagged a media item such as a photo, document, video or audio. The x, y, w and h fields represent the position of the tag in the media item, where x and y are the top-left corner of the tag and w and h are the width and height of the tag respectively. When all 4 values are zero, the meaning is that the individual appears in the media item but the position is not known or not defined. They can only be non-zero if the media item is a photo. All coordinates are returned as values between 0 and 1 and are proprotional to the width and height of the photo.


Fields

The Tag object contains the following fields:

Name Description Type Access Mode

id

The tag's id

id

read

individual

The individual tagged in the media item

Individual object: id and name fields

read, write

media_item

The media item where the individual is tagged

MediaItem object: id and name fields

read

x

The x coordinate of the top left corner of the tag

float between 0 and 1

read, write

y

The y coordinate of the top left corner of the tag

float between 0 and 1

read, write

w

The width of the tag

float between 0 and 1

read, write

h

The height of the tag

float between 0 and 1

read, write

is_personal_photo

If the tag should be personal photo or not. Used for write only

boolean

read, write

class_name

The object class name

string

read

Example

https://familygraph.myheritage.com/photo-144530322-1-1000007/tags (open in browser)
{
"data": [
{
"id": "tag-144530322-1-1000007-50A3775519F90DC33084C04727DA5897",
"individual": {
"id": "individual-144530322-1000001",
"name": "John Fitzgerald Kennedy"
},
"media_item": {
"id": "photo-144530322-1-1000007",
"name": "John Jr. plays under the desk of his fatherm JFK."
},
"x": 0.42071881606765,
"y": 0.043333333333333,
"w": 0.12473572938689,
"h": 0.13,
"class_name": "Tag"
},
{
"id": "tag-144530322-1-1000007-50A3775512BE2913965098BE14BBF748",
"individual": {
"id": "individual-144530322-1000004",
"name": "John Fitzgerald \"John-John\" Kennedy, Jr."
},
"media_item": {
"id": "photo-144530322-1-1000007",
"name": "John Jr. plays under the desk of his fatherm JFK."
},
"x": 0.43128964059197,
"y": 0.58166666666667,
"w": 0.15644820295983,
"h": 0.16,
"class_name": "Tag"
}
],
"class_name": "Connection"
}