Businesses and organizations

Annotations for businesses and organizations help Bing identify and map locations referred in for example event descriptions and reviews, and enable us to supplement and validate our data sources.

For example, your organization’s website may contain the following contact information block:

Contoso International, Inc. 100 Main Street Birmingham, AL 35201

Phone: 205-555-1234Website: http://www.contoso.com

Marking It Up

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

 

Item property

Microdata

Microformats

RDFa

Description

Names

name

fn org (both are required; values are required to be identical when used separately)

name

Required. Name of the business or organization.

Address

address

adr

address

The address details of the business or organization.

Geographic coordinates

geo

geo

geo

The latitude/longitude pair for the location.

Telephone numbers

tel

tel

tel

The telephone number of the business or organization.

URL

url

url

url

The website of the business or organization.

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

Microdata

Example: Contact details for Contoso International, Inc.

<div itemscope itemtype="http://data-vocabulary.org/Organization"> <div itemprop="name"><strong>Contoso International, Inc.</strong></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>Phone:</strong> <span itemprop="tel">205-555-1234</span> </div> <div> <strong>Website:</strong> <a href="http://www.contoso.com" itemprop="url">http://www.contoso.com</a> </div> <span itemprop="geo" itemscope itemtype="http://data-vocabulary.org/Geo"> <meta itemprop="latitude" content="33.5188" /> <meta itemprop="longitude" content="-86.8083" /> </span> </div>

Breaking It Down

In this example, the first line defines the item type through the vocabulary (itemtype="http://data-vocabulary.org/Organization"). We then use a combination of block and inline elements to define the example’s address, starting with the item property declaration for address (<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 use meta elements embedded in the body (newly supported in HTML 5) to annotate invisible content, in this example the latitude/longitude pair for the address.

Microformats (hCard)

Example: Contact details for Contoso International, Inc.

<div class="vcard"> <div class="fn org"><strong>Contoso International, Inc.</strong></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">35201</span> </div> </div> <div> <strong>Phone:</strong> <span class="tel">205-555-1234</span> </div> <div> <strong>Website:</strong> <a href="http://www.contoso.com" class="url">http://www.contoso.com</a> </div> <span class="geo"> <span class="latitude"> <span class="value-title" title="33.5188" ></span> </span> <span class="longitude"> <span class="value-title" title="-86.8083"></span> </span> </span> </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.

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 use a series of span elements to annotate invisible content, in this example the latitude/longitude pair for the address.

RDFa

Example: Contact details for Contoso International, Inc.

<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Organization"> <div property="v:name"><strong>Contoso International, Inc.</strong></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">35201</span> </div> </div> </div> <div> <strong>Phone:</strong> <span property="v:tel">205-555-1234</span> </div> <div> <strong>Website:</strong> <a href="http://www.contoso.com" rel="v:url">http://www.contoso.com</a> </div> <span rel="v:geo"> <span typeof="v:Geo"> <span property="v:latitude" content="33.5188"></span> <span property="v:longitude" content="-86.8083"></span> </span> </span> </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:Organization"). Using a combination of block and inline elements, the syntax defines the example’s address (<div typeof="v: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 use a series of span elements to annotate invisible content, in this example the latitude/longitude pair for the address.