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
is_location_locked	If the tag can change location. Used for read only	boolean	read
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,
			"is_location_locked": false,
			"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,
			"is_location_locked": false,
			"class_name": "Tag"
		}
	],
	"class_name": "Connection"
}