People

Supported in: Microdata, Microformat (hCard), RDFa

Annotations for contact details and social networking information enable Bing to identify, extract and display rich information about people and their various affiliations and relationships. For example, your website may contain contact information for Dan Jump, CEO, Contoso International, Inc.

Dan Jump

CEO, Contoso International, Inc.

100 Main Street

Birmingham, AL 35201

Executive assistant: Janet Zhong

Marking It Up

Annotations for businesses and organizations will contain one or more of the following properties:

Item property

Microdata

Microformats

RDFa

Description

Name

name

fn

name

Required. The name of the person.

Title

title

title

title

The (job) title of the person.

Affiliation

affiliation

org

affiliation

Name of business or organization the person belongs to.

Role

role

role

role

The role/work responsibilities of the person.

Address

address

adr

address

The address of the person.

URL

url

url

url

A URL for the person’s personal page.

Nickname

nickname

nickname

nickname

The nickname of the person.

Photograph

photo

photo

photo

A URL for a photograph of the person.

Acquaintance

acquaintance

acquaintance

acquaintance

An acquaintance of the person (another person).

Contact

contact

contact

contact

A contact of the person (another person).

Friend

friend

friend

friend

A friend of the person (another person).

Within the address item property, Bing supports the following optional sub-properties for all supported annotation formats:

  • street-address: the street address of the business or organization
  • locality: the city belonging to the street address
  • region: the state or province belonging to the street address
  • postal-code: the postal code belonging to the street address
  • country-name: the country name belonging to the street address

The acquaintance, contact and friend item properties are the three properties of the XHTML Friends Network (XFN) supported by Bing.

Microdata

Example: Annotation for Dan Jump, CEO, Contoso International, Inc.

<div itemscope itemtype="http://data-vocabulary.org/Person">

<div itemprop="name"><strong>Dan Jump</strong></div>

<div>

<span itemprop="title">CEO</span>, <span itemprop="affiliation">Contoso International, Inc.</span>

</div>

<div itemprop="address" itemscope itemtype="http://data-vocabulary.org/Address">

<div itemprop="street-address">100 Main Street</div>

<div>

<span itemprop="locality">Birmingham</span>, <span itemprop="region">AL</span> <span itemprop="postal-code">35201</span>

</div>

</div>

<div>

<strong>Executive assistant:</strong> <span rel="contact">Janet Zhong</span>

</div>

</div>

Breaking It Down

In this example, the first line defines the item type through the vocabulary (itemtype="http://data-vocabulary.org/Person"). We then use a combination of block and inline elements to annotate the person’s name (itemprop="name"), title (itemprop="title") and affiliation (itemprop="affiliation").

To annotate the person’s address, we use an address block (<div itemprop="address" itemscope itemtype="http://data-vocabulary.org/Address">). Within the address block, we define the optional elements street-address, locality, region (for state), and postal-code.

Finally, we annotate the person’s relationship to the executive assistant using the rel attribute as specified by the XFN format.

Microformats (hCard)

Example: Annotation for Dan Jump, CEO, Contoso International, Inc.

<div class="vcard">

<div class="name"><strong>Dan Jump</strong></div>

<div>

<span class="title">CEO</span>, <span class="org">Contoso International, Inc.</span>

</div>

<div class="adr">

<div class="street-address">100 Main Street</div>

<div>

<span class="locality">Birmingham</span>, <span class="region">AL</span> <span class="postal-code">AL</span>

</div>

</div>

<div>

<strong>Executive assistant:</strong> <span rel="contact">Janet Zhong</span>

</div>

</div>

Breaking It Down

In this example, the hCard specification is used to annotate the contact information. In the first line, we define the item type (class="vcard"). This is not an oversight on our behalf. Although the specification is called hCard, it is referred to in the source code as vcard.

After defining the person’s name (class="name"), title (class="title") and affiliation (class="org"), we define the optional elements street-address, locality, region (for state), and postal-code within the address block (<div class="adr">) using separate elements.

Finally, we annotate the person’s relationship to the executive assistant using the rel attribute as specified by the XFN format.

RDFa

Example: Annotation for Dan Jump, CEO, Contoso International, Inc.


<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Person">

<div property="v:name"><strong>Dan Jump</strong></div>

<div>

<span property="v:title">CEO</span>, <span property="v:affiliation">Contoso International, Inc.</span>

</div>

<div rel="v:address">

<div typeof="v:Address">

<div property="v:street-address">100 Main Street</div>

<div>

<span property="v:locality">Birmingham</span>, <span property="v:region">AL</span> <span property="v:postal-code">AL</span>

</div>

</div>

</div>

<div>

<strong>Executive assistant:</strong> <span rel="contact">Janet Zhong</span>

</div>

</div>

Breaking It Down

In this example, the first line declares the namespace (xmlns:v="http://rdf.data-vocabulary.org/#") followed by the item type declaration (typeof="v:Person"). Using a combination of block and inline elements, the syntax first defines the person’s name (property="v:name"), title (property="v:title") and affiliation (property="v:affiliation"), followed by the person’s address and related information.

Note the prefix referring to the namespace we declared in the first line of the syntax (v:). We use the rel attribute, as opposed to the property attribute, to denote the relationship between the different blocks of information.

Finally, we annotate the person’s relationship to the executive assistant using the rel attribute as specified by the XFN format.