On this page, we explain how you can use GoodRelations to add rich meta-data to your Web pages so that state-of-the art search engines, matchmaking services, and recommender systems will find your company.
GoodRelations is a standardized vocabulary for product, price, and company data that can (1) be embedded into existing static and dynamic Web pages and that (2) can be processed by other computers. This increases the visibility of your products and services in the latest generation of search engines, recommender systems, and other novel applications.
With this recipe, you describe your company (i.e. the corporation or individual human running the business) and your store location plus opening hours.
This is the minimal set of GoodRelations data that any business in the world should expose.
This recipe is the simplest of multiple GoodRelations recipes. You may want to check the GoodRelations cookbook; there could be a more specific recipe for your particular vertical domain.
You can use the GoodRelations Annotator tool to get a handy snippet of extra markup for simple copy-and-paste.
The Global Location Number (GLN, sometimes also referred to as International Location Number or ILN); a thirteen-digit number used to identify parties and physical locations
Main office:1234567890123
Shop:2345678901234
ISIC code for your business: 5610 (code for "Restaurants and mobile food service activities")
Geo positionof your shop (you can easily determine those values for a giving postal address using online services, e.g. the excellent one by Stephen P. Morse at <http://stevemorse.org/jcal/latlon.php>):
Latitude 48.0802626
Longitude 11.6407428
Publishing the Rich Meta-Data
There are at least three ways of adding such rich meta-data to your page:
You can simply insert additional, invisible RDFa markup into your HTML page, most likely directly before the closing "body" element. This is the easiest way. Important:You must paste the code into the page that is available under the URI http://www.example.com/ or change that string in all examples. On most servers, this is the file index.html or index.htm in the root directory.
You can create a dedicated file "goodrelations.rdf" in the RDF/XML format, upload it to your Web server, and link to that file from your Web page. The necessary steps are described here.
You can create a dedicated textfile "goodrelations.n3" in the N3/Turtle format and proceed as in alternative 2. N3/Turtle is just more readable for humans.
When done, you must tell search engines and indexing services of your new data. To do so, simply paste the URI of the page that contains the snippet (likely http://example.org/) into the respective fields of the following submission pages:
URIBurner: [http://linkeddata.uriburner.com/%5DFor that service, simply enter the following URI into your browser once you have published your updated page:
Insert the following additional mark-up directly before the closing
in your Web page, i.e.
...<body><!-- Human-readable content --><div> Hepp's Bagels are the tastiest you can find on campus.</div><!-- Rich meta-data --><divns="http://www.w3.org/1999/xhtml" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"...SNIPPETFROMBELOW...</div></body></html>
Snippet for the basic data
Here is the complete snippet to be used for our example:
As a minimal solution, add a "version" attribute with the value "HTML+RDFa 1.0" to the
element of your document:
<htmlversion="HTML+RDFa 1.0"xml:lang="en">
This is enough for basic access to your rich meta-data.
Your data is, however, much more visible and useful if your page is compliant with the XHTML 1.0 strict specification. If you meet that requirement, you should instead update the page header as follows:
1. Change the DOCTYPE in the header to "XHTML+RDFa"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">
2. Add a "version" attribute with the value "XHTML+RDFa 1.0" to the
element of your document:
<htmlversion="XHTML+RDFa 1.0"xml:lang="en">
3. Check that the
element includes the proper content type and encoding for XHTML:
<headns="http://www.w3.org/1999/xhtml"xml:lang="en"lang="en"><metahttp-equiv="Content-Type"content="text/html; charset=UTF-8"/><title>Your page title blabla...</title></head>
Example in N3/Turtle
Create a new text file "goodrelations.n3" with the following content, upload it to your Web server, and link to that file from your Web page. The necessary steps are described here.
N3/Turtle for the basic data
@prefix foo: <http://www.example.com/#> .
@prefix gr: <http://purl.org/goodrelations/v1#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix media: <http://search.yahoo.com/searchmonkey/media/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix vcard: <http://www.w3.org/2006/vcard/ns#> .
# Part 1: The legal entity (the corporation or person)
foo:myCompany
a gr:BusinessEntity ;
gr:legalName "Hepp's Bagel Bakery Ltd. "^^xsd:string ;
vcard:fn "Hepp's Bagel Bakery Ltd. "@en ;
gr:hasPOS foo:myShop ;
foaf:page <http://www.example.com/> ;
vcard:adr foo:address ;
vcard:tel "+49-89-6004-0"^^xsd:string ;
vcard:url <http://www.example.com/>.
# Part 2: Address details using vcard 2006 standard
foo:address a vcard:Address ;
vcard:country-name "Germany"@en ;
vcard:locality "Neubiberg"@en ;
vcard:postal-code "85577"^^xsd:string ;
vcard:region "Bavaria"@en ;
vcard:street-address "1234 Hepp Road"@en .
# Part 3: The store or shop
foo:myShop
a gr:LocationOfSalesOrServiceProvisioning ;
vcard:adr foo:address ;
vcard:tel "+49-89-6004-4217"^^xsd:string ;
gr:hasOpeningHoursSpecification
foo:Workdays, foo:Saturdays .
# Part 4: Opening hours
foo:Workdays
a gr:OpeningHoursSpecification ;
gr:opens "08:00:00"^^xsd:time ;
gr:closes "18:00:00"^^xsd:time ;
gr:hasOpeningHoursDayOfWeek
gr:Monday, gr:Tuesday, gr:Wednesday, gr:Thursday, gr:Friday .
foo:Saturdays
a gr:OpeningHoursSpecification ;
gr:opens "08:30:00"^^xsd:time ;
gr:closes "14:00:00"^^xsd:time ;
gr:hasOpeningHoursDayOfWeek gr:Saturday .
Create a new file "goodrelations.rdf" in the RDF/XML format with the following content, upload it to your Web server, and link to that file from your Web page. The necessary steps are described here.
Determine the geographical position of your offices and stores
You can attach the address and geo position of your main office and of your shop or shops to the respective elements, even if you don't know the latitude and longitude of your addresses. Simply use free online services to determine them, e.g. the excellent one by Stephen P. Morse at http://stevemorse.org/jcal/latlon.php.
Adding multiple stores
Simply add two or more gr:hasPOS properties from the gr:BusinessEntity and define more than one gr:LocationOfSalesOrServiceProvisioning nodes.
Add information on products, services, and payment options
If you want to be more specific on what products or services your are offering, you may want to use the following extended recipes:
Recipe 4:Simple Example: Minimal example plus a broad description of what you offer plus payment and deliveryoptions (status: to be completed)
Recipe 5:Comprehensive Example: Describing individual products or services including prices etc. (status: to be completed)
Query Example
List the stores and closing hours for Saturdays for all companies with a legal name starting with "Hepp" located in a city staring with "Neubiberg".
