org.apache.tika.metadata
Interface IPTC


public interface IPTC

IPTC photo metadata schema. A collection of property definition constants for the photo metadata properties defined in the IPTC standard.

Since:
Apache Tika 1.1
See Also:
IPTC Photo Metadata

Field Summary
static Property ADDITIONAL_MODEL_INFO
          Information about the ethnicity and other facets of the model(s) in a model-released image.
static Property ARTWORK_OR_OBJECT
          A set of metadata about artwork or an object in the item
static Property ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE
          Contains any necessary copyright notice for claiming the intellectual property for artwork or an object in the image and should identify the current owner of the copyright of this work with associated intellectual property rights.
static Property ARTWORK_OR_OBJECT_DETAIL_CREATOR
          Contains the name of the artist who has created artwork or an object in the image.
static Property ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED
          Designates the date and optionally the time the artwork or object in the image was created.
static Property ARTWORK_OR_OBJECT_DETAIL_SOURCE
          The organisation or body holding and registering the artwork or object in the image for inventory purposes.
static Property ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER
          The inventory number issued by the organisation or body holding and registering the artwork or object in the image.
static Property ARTWORK_OR_OBJECT_DETAIL_TITLE
          A reference for the artwork or object in the image.
static Property CATEGORY
          Deprecated.  
static Property CITY
          Name of the city the content is focussing on -- either the place shown in visual media or referenced by text or audio media.
static Property CONTACT_INFO_ADDRESS
          The contact information address part.
static Property CONTACT_INFO_CITY
          The contact information city part.
static Property CONTACT_INFO_COUNTRY
          The contact information country part.
static Property CONTACT_INFO_EMAIL
          The contact information email address part.
static Property CONTACT_INFO_PHONE
          The contact information phone number part.
static Property CONTACT_INFO_POSTAL_CODE
          The contact information part denoting the local postal code.
static Property CONTACT_INFO_STATE_PROVINCE
          The contact information part denoting regional information such as state or province.
static Property CONTACT_INFO_WEB_URL
          The contact information web address part.
static Property CONTROLLED_VOCABULARY_TERM
          A term to describe the content of the image by a value from a Controlled Vocabulary.
static Property COPYRIGHT_NOTICE
          Contains any necessary copyright notice for claiming the intellectual property for this item and should identify the current owner of the copyright for the item.
static Property COPYRIGHT_OWNER
          Owner or owners of the copyright in the licensed image.
static Property COPYRIGHT_OWNER_ID
          The ID of the owner or owners of the copyright in the licensed image.
static Property COPYRIGHT_OWNER_NAME
          The name of the owner or owners of the copyright in the licensed image.
static Property COUNTRY
          Full name of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media.
static Property COUNTRY_CODE
          Code of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media.
static Property CREATOR
          Contains the name of the person who created the content of this item, a photographer for photos, a graphic artist for graphics, or a writer for textual news, but in cases where the photographer should not be identified the name of a company or organisation may be appropriate.
static Property CREATORS_CONTACT_INFO
          The creator's contact information provides all necessary information to get in contact with the creator of this item and comprises a set of sub-properties for proper addressing.
static Property CREATORS_JOB_TITLE
          Contains the job title of the person who created the content of this item.
static Property CREDIT_LINE
          The credit to person(s) and/or organisation(s) required by the supplier of the item to be used when published.
static Property DATE_CREATED
          Designates the date and optionally the time the intellectual content was created rather than the date of the creation of the physical representation.
static Property DESCRIPTION
          A textual description, including captions, of the item's content, particularly used where the object is not text.
static Property DESCRIPTION_WRITER
          Identifier or the name of the person involved in writing, editing or correcting the description of the content.
static Property DIGITAL_IMAGE_GUID
          Globally unique identifier for the item.
static Property DIGITAL_SOURCE_FILE_TYPE
          Deprecated.  
static Property DIGITAL_SOURCE_TYPE
          The type of the source of this digital image
static Property EVENT
          Names or describes the specific event the content relates to.
static Property HEADLINE
          A brief synopsis of the caption.
static Property IMAGE_CREATOR
          Creator or creators of the image.
static Property IMAGE_CREATOR_ID
          The ID of the creator or creators of the image.
static Property IMAGE_CREATOR_NAME
          The name of the creator or creators of the image.
static Property IMAGE_REGISTRY_ENTRY
          Both a Registry Item Id and a Registry Organisation Id to record any registration of this item with a registry.
static Property IMAGE_SUPPLIER
          Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property IMAGE_SUPPLIER_ID
          Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property IMAGE_SUPPLIER_IMAGE_ID
          Optional identifier assigned by the Image Supplier to the image.
static Property IMAGE_SUPPLIER_NAME
          Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property INSTRUCTIONS
          Any of a number of instructions from the provider or creator to the receiver of the item.
static Property INTELLECTUAL_GENRE
          Describes the nature, intellectual, artistic or journalistic characteristic of a item, not specifically its content.
static Property IPTC_LAST_EDITED
          The date and optionally time when any of the IPTC photo metadata fields has been last edited
static Property JOB_ID
          Number or identifier for the purpose of improved workflow handling.
static Property KEYWORDS
          Keywords to express the subject of the content.
static Property LICENSOR
          A person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_CITY
          The city of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_COUNTRY
          The country of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_EMAIL
          The email of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_EXTENDED_ADDRESS
          The extended address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_ID
          The ID of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_NAME
          The name of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_POSTAL_CODE
          The postal code of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_REGION
          The region of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_STREET_ADDRESS
          The street address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_TELEPHONE_1
          The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_TELEPHONE_2
          The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LICENSOR_URL
          The URL of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property LOCATION_CREATED
          The location the content of the item was created.
static Property LOCATION_CREATED_CITY
          Name of the city of a location.
static Property LOCATION_CREATED_COUNTRY_CODE
          The ISO code of a country of a location.
static Property LOCATION_CREATED_COUNTRY_NAME
          The name of a country of a location.
static Property LOCATION_CREATED_PROVINCE_OR_STATE
          The name of a subregion of a country - a province or state - of a location.
static Property LOCATION_CREATED_SUBLOCATION
          Name of a sublocation.
static Property LOCATION_CREATED_WORLD_REGION
          The name of a world region of a location.
static Property LOCATION_SHOWN
          A location the content of the item is about.
static Property LOCATION_SHOWN_CITY
          Name of the city of a location.
static Property LOCATION_SHOWN_COUNTRY_CODE
          The ISO code of a country of a location.
static Property LOCATION_SHOWN_COUNTRY_NAME
          The name of a country of a location.
static Property LOCATION_SHOWN_PROVINCE_OR_STATE
          The name of a subregion of a country - a province or state - of a location.
static Property LOCATION_SHOWN_SUBLOCATION
          Name of a sublocation.
static Property LOCATION_SHOWN_WORLD_REGION
          The name of a world region of a location.
static Property MAX_AVAIL_HEIGHT
          The maximum available height in pixels of the original photo from which this photo has been derived by downsizing.
static Property MAX_AVAIL_WIDTH
          The maximum available width in pixels of the original photo from which this photo has been derived by downsizing.
static Property MINOR_MODEL_AGE_DISCLOSURE
          Age of the youngest model pictured in the image, at the time that the image was made.
static Property MODEL_AGE
          Age of the human model(s) at the time this image was taken in a model released image.
static Property MODEL_RELEASE_ID
          Optional identifier associated with each Model Release.
static Property MODEL_RELEASE_STATUS
          Summarizes the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the photograph.
static String NAMESPACE_URI_IPTC_CORE
           
static String NAMESPACE_URI_IPTC_EXT
           
static String NAMESPACE_URI_PLUS
           
static Property ORGANISATION_CODE
          A set of metadata about artwork or an object in the item
static Property ORGANISATION_NAME
          Name of the organisation or company which is featured in the content.
static Property PERSON
          Name of a person the content of the item is about.
static Property PLUS_VERSION
          The version number of the PLUS standards in place at the time of the transaction.
static String PREFIX_IPTC_CORE
           
static String PREFIX_IPTC_EXT
           
static String PREFIX_PLUS
           
static Property[] PROPERTY_GROUP_IPTC_CORE
           
static Property[] PROPERTY_GROUP_IPTC_EXT
           
static Property PROPERTY_RELEASE_ID
          Optional identifier associated with each Property Release.
static Property PROPERTY_RELEASE_STATUS
          Summarises the availability and scope of property releases authorizing usage of the properties appearing in the photograph.
static Property PROVINCE_OR_STATE
          Name of the subregion of a country -- either called province or state or anything else -- the content is focussing on -- either the subregion shown in visual media or referenced by text or audio media.
static Property REGISTRY_ENTRY_CREATED_ITEM_ID
          A unique identifier created by a registry and applied by the creator of the item.
static Property REGISTRY_ENTRY_CREATED_ORGANISATION_ID
          An identifier for the registry which issued the corresponding Registry Image Id.
static Property RIGHTS_USAGE_TERMS
          The licensing parameters of the item expressed in free-text.
static Property SCENE_CODE
          Describes the scene of a news content.
static Property SOURCE
          Identifies the original owner of the copyright for the intellectual content of the item.
static Property SUBJECT_CODE
          Specifies one or more Subjects from the IPTC Subject-NewsCodes taxonomy to categorise the content.
static Property SUBLOCATION
          Name of a sublocation the content is focussing on -- either the location shown in visual media or referenced by text or audio media.
static Property SUPPLEMENTAL_CATEGORIES
          Deprecated.  
static Property TITLE
          A shorthand reference for the item.
static Property URGENCY
          Deprecated.  
 

Field Detail

NAMESPACE_URI_IPTC_CORE

static final String NAMESPACE_URI_IPTC_CORE
See Also:
Constant Field Values

NAMESPACE_URI_IPTC_EXT

static final String NAMESPACE_URI_IPTC_EXT
See Also:
Constant Field Values

NAMESPACE_URI_PLUS

static final String NAMESPACE_URI_PLUS
See Also:
Constant Field Values

PREFIX_IPTC_CORE

static final String PREFIX_IPTC_CORE
See Also:
Constant Field Values

PREFIX_IPTC_EXT

static final String PREFIX_IPTC_EXT
See Also:
Constant Field Values

PREFIX_PLUS

static final String PREFIX_PLUS
See Also:
Constant Field Values

CITY

static final Property CITY
Name of the city the content is focussing on -- either the place shown in visual media or referenced by text or audio media. This element is at the third level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:90 City

See Also:
Photoshop.CITY

COUNTRY

static final Property COUNTRY
Full name of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media. This element is at the top/first level of a top- down geographical hierarchy. The full name should be expressed as a verbal name and not as a code, a code should go to the element "CountryCode"

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:101 Country/Primary Location Name

See Also:
Photoshop.COUNTRY

COUNTRY_CODE

static final Property COUNTRY_CODE
Code of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media. This element is at the top/first level of a top-down geographical hierarchy. The code should be taken from ISO 3166 two or three letter code. The full name of a country should go to the "Country" element.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:100 Country/Primary Location Code


DESCRIPTION

static final Property DESCRIPTION
A textual description, including captions, of the item's content, particularly used where the object is not text.

Note: the XMP property (dc:description) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:120 Caption/Abstract

See Also:
DublinCore.DESCRIPTION

HEADLINE

static final Property HEADLINE
A brief synopsis of the caption. Headline is not the same as Title.

Maps to this IIM property: 2:105 Headline

See Also:
Photoshop.HEADLINE

INTELLECTUAL_GENRE

static final Property INTELLECTUAL_GENRE
Describes the nature, intellectual, artistic or journalistic characteristic of a item, not specifically its content.

The IPTC recognizes that the corresponding IPTC Genre NewsCodes needs photo specific extension to be better usable with this field (as of the release of this standard in the year 2008).

Maps to this IIM property: 2:04 Object Attribute Reference


KEYWORDS

static final Property KEYWORDS
Keywords to express the subject of the content. Keywords may be free text and don't have to be taken from a controlled vocabulary. Codes from the controlled vocabulary IPTC Subject NewsCodes must go to the "Subject Code" field.

Single values of this field should not be restricted to single words but must allow for phrases as well.

Maps to this IIM property: 2:25 Keywords

See Also:
DublinCore.SUBJECT

PROVINCE_OR_STATE

static final Property PROVINCE_OR_STATE
Name of the subregion of a country -- either called province or state or anything else -- the content is focussing on -- either the subregion shown in visual media or referenced by text or audio media. This element is at the second level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:95 Province/State

See Also:
Photoshop.STATE

SCENE_CODE

static final Property SCENE_CODE
Describes the scene of a news content. Specifies one or more terms from the IPTC "Scene-NewsCodes". Each Scene is represented as a string of 6 digits in an unordered list.

Note: Only Scene values from this IPTC taxonomy should be used here. More about the IPTC Scene-NewsCodes at www.newscodes.org.


SUBJECT_CODE

static final Property SUBJECT_CODE
Specifies one or more Subjects from the IPTC Subject-NewsCodes taxonomy to categorise the content. Each Subject is represented as a string of 8 digits in an unordered list.

Note: Only Subjects from a controlled vocabulary should be used here, free text has to be put into the Keyword element. More about IPTC Subject-NewsCodes at www.newscodes.org.


SUBLOCATION

static final Property SUBLOCATION
Name of a sublocation the content is focussing on -- either the location shown in visual media or referenced by text or audio media. This location name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fourth level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:92 Sublocation


DATE_CREATED

static final Property DATE_CREATED
Designates the date and optionally the time the intellectual content was created rather than the date of the creation of the physical representation.

If a software system requires explicit time values and no time is given by the Date Created property the software system should default the time to 00:00:00. If the software system does not require an explicit time value the time part should be left empty as it is.

Note 1: Any content of the IIM dataset 2:60, Time Created, should be merged to this element. Note 2: Implementers are encouraged to provide the creation date and time from the EXIF data of a digital camera to the user for entering this date for the first time.

Maps to this IIM property: 2:55 Date Created

See Also:
Photoshop.DATE_CREATED

DESCRIPTION_WRITER

static final Property DESCRIPTION_WRITER
Identifier or the name of the person involved in writing, editing or correcting the description of the content.

Maps to this IIM property: 2:122 Writer/Editor

See Also:
Photoshop.CAPTION_WRITER

INSTRUCTIONS

static final Property INSTRUCTIONS
Any of a number of instructions from the provider or creator to the receiver of the item.

Maps to this IIM property: 2:40 Special Instruction

See Also:
Photoshop.INSTRUCTIONS

JOB_ID

static final Property JOB_ID
Number or identifier for the purpose of improved workflow handling. This is a user created identifier related to the job for which the item is supplied.

Note: As this identifier references a job of the receiver's workflow it must first be issued by the receiver, then transmitted to the creator or provider of the news object and finally added by the creator to this field.

Maps to this IIM property: 2:103 Original Transmission Reference

See Also:
Photoshop.TRANSMISSION_REFERENCE

TITLE

static final Property TITLE
A shorthand reference for the item. Title provides a short human readable name which can be a text and/or numeric reference. It is not the same as Headline.

Many use the Title field to store the filename of the image, though the field may be used in many ways. Formal identifiers are provided by the Digital Image Id, or the Registry Entry property of the IPTC Extension.

Note 1: This element aligns with the use of Dublin Core's "Title" element. Note 2: the XMP property (dc:title) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:05 Object Name

See Also:
DublinCore.TITLE

COPYRIGHT_NOTICE

static final Property COPYRIGHT_NOTICE
Contains any necessary copyright notice for claiming the intellectual property for this item and should identify the current owner of the copyright for the item. Other entities like the creator of the item may be added in the corresponding field. Notes on usage rights should be provided in "Rights usage terms".

Copyright ownership can be expressed in a more controlled way using the PLUS fields "Copyright Owner", "Copyright Owner ID", "Copyright Owner Name" of the IPTC Extension. It is the user's responsibility to keep the values of the four fields in sync.

Note: the XMP property (dc:rights) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:116 Copyright Notice

See Also:
DublinCore.RIGHTS

CREATOR

static final Property CREATOR
Contains the name of the person who created the content of this item, a photographer for photos, a graphic artist for graphics, or a writer for textual news, but in cases where the photographer should not be identified the name of a company or organisation may be appropriate.

The creator can be expressed in a more controlled way using the "Image Creator" of PLUS in the IPTC Extension additionally. It is the user's responsibility to keep the values of the IPTC Core and the PLUS fields in sync.

Maps to this IIM property: 2:80 By-line

See Also:
DublinCore.CREATOR

CREATORS_CONTACT_INFO

static final Property CREATORS_CONTACT_INFO
The creator's contact information provides all necessary information to get in contact with the creator of this item and comprises a set of sub-properties for proper addressing.

The IPTC Extension Licensor fields should be used instead of these Creator's Contact Info fields if you are using IPTC Extension fields. If the creator is also the licensor his or her contact information should be provided in the Licensor fields.

Note 1 to user interface implementers: All sub-properties of "Creator's contact information" should be shown as group on the form. Note 2: the CreatorContactInfo sub-properties' naming aligns with the vCard specification RFC 2426.


CREATORS_JOB_TITLE

static final Property CREATORS_JOB_TITLE
Contains the job title of the person who created the content of this item. As this is sort of a qualifier the Creator element has to be filled in as mandatory prerequisite for using Creator's Jobtitle.

Maps to this IIM property: 2:85 By-line Title

See Also:
Photoshop.AUTHORS_POSITION

CREDIT_LINE

static final Property CREDIT_LINE
The credit to person(s) and/or organisation(s) required by the supplier of the item to be used when published. This is a free-text field.

Note 1: For more formal identifications of the creator or the owner of the copyrights of this image other rights properties may be used. Note 2: This property was named "Credit" by the IIM metadata, then it was renamed to "Provider" in IPTC Core 1.0. In IPTC Core 1.1. it has been renamed to "Credit Line" as the field is used for this purpose by many users.

Maps to this IIM property: 2:110 Credit

See Also:
Photoshop#CREDIT_LINE

RIGHTS_USAGE_TERMS

static final Property RIGHTS_USAGE_TERMS
The licensing parameters of the item expressed in free-text.

The PLUS fields of the IPTC Extension can be used in parallel to express the licensed usage in more controlled terms.


SOURCE

static final Property SOURCE
Identifies the original owner of the copyright for the intellectual content of the item. This could be an agency, a member of an agency or an individual. Source could be different from Creator and from the entities in the CopyrightNotice.

The original owner can never change. For that reason the content of this property should never be changed or deleted after the information is entered following the news object's initial creation.

Maps to this IIM property: 2:115 Source

See Also:
Photoshop.SOURCE

CONTACT_INFO_ADDRESS

static final Property CONTACT_INFO_ADDRESS
The contact information address part. Comprises an optional company name and all required information to locate the building or postbox to which mail should be sent. To that end, the address is a multiline field.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_CITY

static final Property CONTACT_INFO_CITY
The contact information city part.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_COUNTRY

static final Property CONTACT_INFO_COUNTRY
The contact information country part.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_EMAIL

static final Property CONTACT_INFO_EMAIL
The contact information email address part.

Multiple email addresses can be given. May have to be separated by a comma in the user interface.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple e-mail addresses. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_PHONE

static final Property CONTACT_INFO_PHONE
The contact information phone number part.

Multiple numbers can be given. May have to be separated by a comma in the user interface.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple international numbers. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_POSTAL_CODE

static final Property CONTACT_INFO_POSTAL_CODE
The contact information part denoting the local postal code.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_STATE_PROVINCE

static final Property CONTACT_INFO_STATE_PROVINCE
The contact information part denoting regional information such as state or province.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.


CONTACT_INFO_WEB_URL

static final Property CONTACT_INFO_WEB_URL
The contact information web address part. Multiple addresses can be given, separated by a comma.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple URLs. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.


URGENCY

static final Property URGENCY
Deprecated. 
As this metadata element pertains to distribution management, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:Urgency], and hence, available for future use, but outside the IPTC Core.


CATEGORY

static final Property CATEGORY
Deprecated. 
As this metadata element was earmarked as deprecated already for IIM 4.1, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:Category], and hence available for future use - but outside the IPTC Core. For migrating from Category codes to Subject Codes please read the Guideline for mapping Category Codes to Subject NewsCodes section below.


SUPPLEMENTAL_CATEGORIES

static final Property SUPPLEMENTAL_CATEGORIES
Deprecated. 
As this metadata element was earmarked as deprecated already for IIM 4.1, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:SupplementalCategories], and hence available for future use - but outside the IPTC Core.


ADDITIONAL_MODEL_INFO

static final Property ADDITIONAL_MODEL_INFO
Information about the ethnicity and other facets of the model(s) in a model-released image.

Use the Model Age field for the age of model(s).


ARTWORK_OR_OBJECT

static final Property ARTWORK_OR_OBJECT
A set of metadata about artwork or an object in the item


ORGANISATION_CODE

static final Property ORGANISATION_CODE
A set of metadata about artwork or an object in the item


CONTROLLED_VOCABULARY_TERM

static final Property CONTROLLED_VOCABULARY_TERM
A term to describe the content of the image by a value from a Controlled Vocabulary.

This property is part of the Photo Metadata 2008 specifications, but should not released to the public on the standard Adobe Custom Panels for IPTC metadata or other user interfaces unless agreed by the IPTC.


LOCATION_SHOWN

static final Property LOCATION_SHOWN
A location the content of the item is about. For photos that is a location shown in the image.

If the location the image was taken in is different from this location the property Location Created should be used too.


MODEL_AGE

static final Property MODEL_AGE
Age of the human model(s) at the time this image was taken in a model released image.

The user should be aware of any legal implications of providing ages for young models. Ages below 18 years should not be included.


ORGANISATION_NAME

static final Property ORGANISATION_NAME
Name of the organisation or company which is featured in the content.

May be supplemented by values from a controlled vocabulary in the Organisation Code field.


PERSON

static final Property PERSON
Name of a person the content of the item is about. For photos that is a person shown in the image.


DIGITAL_IMAGE_GUID

static final Property DIGITAL_IMAGE_GUID
Globally unique identifier for the item. It is created and applied by the creator of the item at the time of its creation . This value shall not be changed after that time.

The identifier will probably be generated by the technical means of an imaging device or software and should be applied to the digital image file as early as possible in its life cycle. This identifier does not identify any pictured content, particularly in case of a scan of non- digital images, only this digital representation.

Any algorithm to create this identifier has to comply with the technical requirements to create a globally unique id. Any device creating digital images - e.g. still image cameras, video cameras, scanners - should create such an identifer right at the time of the creation of the digital data and add the id to the set of metadata without compromising performance. It is recommended that this image identifier allows identifying the device by which the image data and the GUID were created. IPTC's basic requirements for unique ids are: - It must be globally unique. Algorithms for this purpose exist. - It should identify the camera body. - It should identify each individual photo from this camera body. - It should identify the date and time of the creation of the picture. - It should be secured against tampering. This field should be implemented in a way to prove it has not been changed since its value has been applied. If the identifier has been created by the imaging device its type and brand can be found in the Exif/technical metadata.


DIGITAL_SOURCE_FILE_TYPE

static final Property DIGITAL_SOURCE_FILE_TYPE
Deprecated. 
The type of the source digital file.

The IPTC recommends not to implement this property any longer.


DIGITAL_SOURCE_TYPE

static final Property DIGITAL_SOURCE_TYPE
The type of the source of this digital image


EVENT

static final Property EVENT
Names or describes the specific event the content relates to.

Examples are: a press conference, dedication ceremony, etc. If this is a sub-event of a larger event both can be provided by the field: e.g. XXXIX Olympic Summer Games (Beijing): opening ceremony. Unplanned events could be named by this property too.


IMAGE_REGISTRY_ENTRY

static final Property IMAGE_REGISTRY_ENTRY
Both a Registry Item Id and a Registry Organisation Id to record any registration of this item with a registry.

Typically an id from a registry is negotiated and applied after the creation of the digital image.

Any user interface implementation must show both sub-properties - Item Id and Organisation Id - as corresponding values. Further an input to both fields should be made mandatory.


IMAGE_SUPPLIER

static final Property IMAGE_SUPPLIER
Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_SUPPLIER_ID

static final Property IMAGE_SUPPLIER_ID
Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_SUPPLIER_NAME

static final Property IMAGE_SUPPLIER_NAME
Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_SUPPLIER_IMAGE_ID

static final Property IMAGE_SUPPLIER_IMAGE_ID
Optional identifier assigned by the Image Supplier to the image.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IPTC_LAST_EDITED

static final Property IPTC_LAST_EDITED
The date and optionally time when any of the IPTC photo metadata fields has been last edited

The public use of this property is deprecated by IPTC Extension version 1.1. It may only still be used by a private user interface for a use scoped to a company. If used this field should be a timestamp of the latest change applied to any of the fields.

The value of this property should never be set by software. XMP-aware software should reflect any changes to metadata by the xmp:MetadataDate property of the XMP Basic scheme.


LOCATION_CREATED

static final Property LOCATION_CREATED
The location the content of the item was created.

If the location in the image is different from the location the photo was taken the IPTC Extension property Location Shown in the Image should be used.


MAX_AVAIL_HEIGHT

static final Property MAX_AVAIL_HEIGHT
The maximum available height in pixels of the original photo from which this photo has been derived by downsizing.


MAX_AVAIL_WIDTH

static final Property MAX_AVAIL_WIDTH
The maximum available width in pixels of the original photo from which this photo has been derived by downsizing.


PLUS_VERSION

static final Property PLUS_VERSION
The version number of the PLUS standards in place at the time of the transaction.

This property was included into the IPTC Extension schema from PLUS version 1.2 as all other PLUS properties. To reflect this the value of "PLUS Version" should be set to the string "1.2.0"


COPYRIGHT_OWNER

static final Property COPYRIGHT_OWNER
Owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


COPYRIGHT_OWNER_ID

static final Property COPYRIGHT_OWNER_ID
The ID of the owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


COPYRIGHT_OWNER_NAME

static final Property COPYRIGHT_OWNER_NAME
The name of the owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_CREATOR

static final Property IMAGE_CREATOR
Creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_CREATOR_ID

static final Property IMAGE_CREATOR_ID
The ID of the creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


IMAGE_CREATOR_NAME

static final Property IMAGE_CREATOR_NAME
The name of the creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR

static final Property LICENSOR
A person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_ID

static final Property LICENSOR_ID
The ID of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_NAME

static final Property LICENSOR_NAME
The name of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_CITY

static final Property LICENSOR_CITY
The city of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_COUNTRY

static final Property LICENSOR_COUNTRY
The country of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_EMAIL

static final Property LICENSOR_EMAIL
The email of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_EXTENDED_ADDRESS

static final Property LICENSOR_EXTENDED_ADDRESS
The extended address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_POSTAL_CODE

static final Property LICENSOR_POSTAL_CODE
The postal code of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_REGION

static final Property LICENSOR_REGION
The region of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_STREET_ADDRESS

static final Property LICENSOR_STREET_ADDRESS
The street address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_TELEPHONE_1

static final Property LICENSOR_TELEPHONE_1
The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_TELEPHONE_2

static final Property LICENSOR_TELEPHONE_2
The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


LICENSOR_URL

static final Property LICENSOR_URL
The URL of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


MINOR_MODEL_AGE_DISCLOSURE

static final Property MINOR_MODEL_AGE_DISCLOSURE
Age of the youngest model pictured in the image, at the time that the image was made.

This age should not be displayed to the public on open web portals and the like. But it may be used by image repositories in a B2B enviroment.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


MODEL_RELEASE_ID

static final Property MODEL_RELEASE_ID
Optional identifier associated with each Model Release.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


MODEL_RELEASE_STATUS

static final Property MODEL_RELEASE_STATUS
Summarizes the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the photograph.

It is recommended to apply the PLUS controlled value Unlimited Model Releases (MR- UMR) very carefully and to check the wording of the model release thoroughly before applying it.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


PROPERTY_RELEASE_ID

static final Property PROPERTY_RELEASE_ID
Optional identifier associated with each Property Release.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


PROPERTY_RELEASE_STATUS

static final Property PROPERTY_RELEASE_STATUS
Summarises the availability and scope of property releases authorizing usage of the properties appearing in the photograph.

It is recommended to apply the value PR-UPR very carefully and to check the wording of the property release thoroughly before applying it.

This is a PLUS version 1.2 property included in the IPTC Extension schema.


ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE

static final Property ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE
Contains any necessary copyright notice for claiming the intellectual property for artwork or an object in the image and should identify the current owner of the copyright of this work with associated intellectual property rights.


ARTWORK_OR_OBJECT_DETAIL_CREATOR

static final Property ARTWORK_OR_OBJECT_DETAIL_CREATOR
Contains the name of the artist who has created artwork or an object in the image.


ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED

static final Property ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED
Designates the date and optionally the time the artwork or object in the image was created. This relates to artwork or objects with associated intellectual property rights.


ARTWORK_OR_OBJECT_DETAIL_SOURCE

static final Property ARTWORK_OR_OBJECT_DETAIL_SOURCE
The organisation or body holding and registering the artwork or object in the image for inventory purposes.


ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER

static final Property ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER
The inventory number issued by the organisation or body holding and registering the artwork or object in the image.


ARTWORK_OR_OBJECT_DETAIL_TITLE

static final Property ARTWORK_OR_OBJECT_DETAIL_TITLE
A reference for the artwork or object in the image.


LOCATION_SHOWN_CITY

static final Property LOCATION_SHOWN_CITY
Name of the city of a location. This element is at the fourth level of a top-down geographical hierarchy.


LOCATION_SHOWN_COUNTRY_CODE

static final Property LOCATION_SHOWN_COUNTRY_CODE
The ISO code of a country of a location. This element is at the second level of a top-down geographical hierarchy.

Note 1: an implementer would have to derive from the length of the value string whether this is the country code from the two or three letter scheme as no explicit indication can be provided.


LOCATION_SHOWN_COUNTRY_NAME

static final Property LOCATION_SHOWN_COUNTRY_NAME
The name of a country of a location. This element is at the second level of a top-down geographical hierarchy.


LOCATION_SHOWN_PROVINCE_OR_STATE

static final Property LOCATION_SHOWN_PROVINCE_OR_STATE
The name of a subregion of a country - a province or state - of a location. This element is at the third level of a top-down geographical hierarchy.


LOCATION_SHOWN_SUBLOCATION

static final Property LOCATION_SHOWN_SUBLOCATION
Name of a sublocation. This sublocation name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fifth level of a top-down geographical hierarchy.


LOCATION_SHOWN_WORLD_REGION

static final Property LOCATION_SHOWN_WORLD_REGION
The name of a world region of a location. This element is at the first (topI) level of a top- down geographical hierarchy.


LOCATION_CREATED_CITY

static final Property LOCATION_CREATED_CITY
Name of the city of a location. This element is at the fourth level of a top-down geographical hierarchy.


LOCATION_CREATED_COUNTRY_CODE

static final Property LOCATION_CREATED_COUNTRY_CODE
The ISO code of a country of a location. This element is at the second level of a top-down geographical hierarchy.

Note 1: an implementer would have to derive from the length of the value string whether this is the country code from the two or three letter scheme as no explicit indication can be provided.


LOCATION_CREATED_COUNTRY_NAME

static final Property LOCATION_CREATED_COUNTRY_NAME
The name of a country of a location. This element is at the second level of a top-down geographical hierarchy.


LOCATION_CREATED_PROVINCE_OR_STATE

static final Property LOCATION_CREATED_PROVINCE_OR_STATE
The name of a subregion of a country - a province or state - of a location. This element is at the third level of a top-down geographical hierarchy.


LOCATION_CREATED_SUBLOCATION

static final Property LOCATION_CREATED_SUBLOCATION
Name of a sublocation. This sublocation name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fifth level of a top-down geographical hierarchy.


LOCATION_CREATED_WORLD_REGION

static final Property LOCATION_CREATED_WORLD_REGION
The name of a world region of a location. This element is at the first (topI) level of a top- down geographical hierarchy.


REGISTRY_ENTRY_CREATED_ITEM_ID

static final Property REGISTRY_ENTRY_CREATED_ITEM_ID
A unique identifier created by a registry and applied by the creator of the item. This value shall not be changed after being applied. This identifier is linked to a corresponding Registry Organisation Identifier.


REGISTRY_ENTRY_CREATED_ORGANISATION_ID

static final Property REGISTRY_ENTRY_CREATED_ORGANISATION_ID
An identifier for the registry which issued the corresponding Registry Image Id.


PROPERTY_GROUP_IPTC_CORE

static final Property[] PROPERTY_GROUP_IPTC_CORE

PROPERTY_GROUP_IPTC_EXT

static final Property[] PROPERTY_GROUP_IPTC_EXT


Copyright © 2007-2012 The Apache Software Foundation. All Rights Reserved.