2.15 Syntax Guidelines

To ensure consistency and interoperability, this document outlines the required formats for our schema.org and odta-based domain specifications. The following table serves as a practical guide, providing clear examples for various common data topics like dates, distances, and locations.

For each topic, the table details the correct schema.org property to use, the expected data type, and provides both a simple value and a complete JSON example. Please adhere strictly to these guidelines to ensure all data is structured uniformly.

topic	schema.org property	data type	example	json example
Number	`schema:numberOfPages`, `schema:elevation`, ...	https://schema.org/Integer	`12`	`{"@context": "https://schema.org", "@type": "Article", "name": "Beispielartikel", "numberOfPages": 12, "wordCount": 3500}`
URL	`schema:url`	`schema:URL`	`https://www.example.de`	`{"@context": "https://schema.org", "@type": "WebSite", "url": "https://www.beispiel.de"}`
email address	`schema:email`	`schema:Text`	`[email protected]`	`{"@context": "https://schema.org", "@type": "Person", "name": "Max Mustermann", "email": "[email protected]"}`
week days	`schema:dayOfWeek`	`schema:DayOfWeek`	IRI: `http://schema.org/Monday`	`{"@context": "https://schema.org", "@type": "OpeningHoursSpecification", "dayOfWeek": ["http://schema.org/Monday", "http://schema.org/Wednesday", "http://schema.org/Friday"], "opens": "08:00:00", "closes": "18:00:00"}`
date	`schema:startDate`, `schema:endDate`, ...	`schema:Date` or `schema:DateTime`	`2025-06-15`, `2025-07-07T15:48:56-12:00`	`{"@context": "https://schema.org", "@type": "Event", "name": "Beispielveranstaltung", "startDate": "2025-06-15", "endDate": "2025-06-15"}`
time	`schema:doorTime`, `schema:opens`, ...	`schema:Time`	`09:30:00`	`{"@context": "https://schema.org", "@type": "OpeningHoursSpecification", "dayOfWeek": "http://schema.org/Tuesday", "opens": "09:30:00", "closes": "17:15:00"}`
elevation of a location	`schema:elevation`	`schema:Number`	`8848`	`{"@context": "https://schema.org", "@type": "Place", "name": "Chomolungma", "geo": {"@type": "GeoCoordinates", "latitude": 27.9881, "longitude": 86.925, "elevation": 8848}}`
Incline/decline of routes	`schema:additionalProperty` --> `schema:name` + `schema:value`	`schema:PropertyValue` --> `schema:Text` + `schema:Number`	`{"@type":"PropertyValue", "name":"Steigung", "value":5, "unitText":"%"}`	`{"@context": "https://schema.org", "@type": "Route", "name": "Wanderweg XY", "distance": {"@type": "QuantitativeValue", "value": 12.5, "unitCode": "KM"}, "additionalProperty": {"@type": "PropertyValue", "name": "Steigung", "value": 5, "unitText": "%"}}`
way points	`odta:wayPoint`	`schema:Place`	`{"@type":"Place", "geo":{...}}`	`{"@context": "https://schema.org", "@type": "Route", "name": "Radstrecke Muster", "hasPart": [{"@type": "Place", "name": "Wegpunkt A", "geo": {"@type": "GeoCoordinates", "latitude": 50.1109, "longitude": 8.6821, "elevation": 120}}, {"@type": "Place", "name": "Wegpunkt B", "geo": {"@type": "GeoCoordinates", "latitude": 50.115, "longitude": 8.69, "elevation": 150}}]}`
distance	`schema:distance`	`schema:QuantitativeValue`--> `schema:value` + `schema:unitCode`	`{"@type":"QuantitativeValue", "value":45, "unitCode":"KM"}`	`{"@context": "https://schema.org", "@type": "Trip", "name": "Radtour an der Lahn", "distance": {"@type": "QuantitativeValue", "value": 45, "unitCode": "KM"}, "description": "45 km lange Tour entlang der Lahn"}`
language	`schema:inLanguage`	`schema:Text` (ISO 639-Code) or `schema:Language`	`"de"` or `{"@type":"Language", "name":"Deutsch", "alternateName":"de"}`	`{"@context": "https://schema.org", "@type": "WebPage", "name": "Beispielseite", "inLanguage": "de"}`
currency	`schema:priceCurrency`	`schema:Text`	`"EUR"`	`{"@context": "https://schema.org", "@type": "Product", "name": "Beispiel-Produkt", "offers": {"@type": "Offer", "price": 49.90, "priceCurrency": "EUR", "availability": "http://schema.org/InStock"}}`
zip code	`schema:postalCode`	`schema:Text`	`79350`	`{"@context": "https://schema.org", "@type": "PostalAddress", "streetAddress": "Musterstraße 1", "postalCode": "10623", "addressLocality": "Berlin", "addressCountry": "DE"}`