Government Service – Schema.org

Overview

A vocabulary for describing Government Service was included in Schema.org  version 1.0d (November 2013). Also see Vocabulary for describing Civic Services – draft, Civic Services – draft 01, Civic Services – draft 02, and Civic Services – RDFS – draft.

Government Service is a more specific type of Service.

In fact, the vocabulary for Government Service adds only one property to the vocabulary for Service:

serviceOperator – typeof Organization

The serviceOperator property enables the representation of a service that is provided by an organization, but operated by another organization, like a subcontractor.

Also note that Schema.org includes GovernmentOrganization, which is a more specific type of Organization, having no additional properties.

Thing > Intangible > Service > GovernmentService

A service provided by a government organization, e.g. food stamps, veterans benefits, etc.
Property Expected Type Description
Properties from GovernmentService
serviceOperator Organization The operating organization, if different from the provider. This enables the representation of services that are provided by an organization, but operated by another organization like a subcontractor.
Properties from Service
availableChannel ServiceChannel A means of accessing the service (e.g. a phone bank, a web site, a location, etc.)
produces Thing The tangible thing generated by the service, e.g. a passport, permit, etc.
provider Person
or Organization
The organization or agency that is providing the service.
serviceArea AdministrativeArea The geographic area where the service is provided.
serviceAudience Audience The audience eligible for this service.
serviceType Text The type of service being offered, e.g. veterans’ benefits, emergency relief, etc.
Properties from Thing
additionalType URL An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax – the ‘typeof’ attribute – for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
alternateName Text An alias for the item.
description Text A short description of the item.
image URL URL of an image of the item.
name Text The name of the item.
potentialAction Action Indicates a potential Action, which describes an idealized action in which this thing would play an ‘object’ role.
sameAs URL URL of a reference Web page that unambiguously indicates the item’s identity. E.g. the URL of the item’s Wikipedia page, Freebase page, or official website.
url URL URL of the item.

Example 1

Without markup

<div>NYC Food Service Establishment Permit, issued by Department of Health and Mental Hygiene.
(issued through NYC Food Service Establishment Permit Service; valid in New York for 1 year).</div>

Microdata

<div itemscope itemtype="http://schema.org/GovernmentPermit">
 <span itemprop="name">NYC Food Service Establishment Permit</span>
 <div itemprop="issuedBy" itemscope itemtype="http://schema.org/GovernmentOrganization">
 <span itemprop="name">Department of Health and Mental Hygiene"</span>
 </div>
 <div itemprop="issuedThrough" itemscope itemtype="http://schema.org/GovernmentService">
 <span itemprop="name">NYC Food Service Establishment Permit Service</span>
 </div>
 <div itemprop="validIn" itemscope itemtype="http://schema.org/AdministrativeArea">
 <span itemprop="name">New York</span>
 </div>
 <time itemprop="validFor" content="P1Y">1 year</time>
</div>

RDFa

<div vocab="http://schema.org/" typeof="GovernmentPermit">
 <span property="name">NYC Food Service Establishment Permit</span>
 <div property="issuedBy" typeof="GovernmentOrganization">
 <span property="name">Department of Health and Mental Hygiene"</span>
 </div>
 <div property="issuedThrough" typeof="GovernmentService">
 <span property="name">NYC Food Service Establishment Permit Service</span>
 </div>
 <div property="validIn" typeof="AdministrativeArea">
 <span property="name">New York</span>
 </div>
 <time property="validFor" content="P1Y">1 year</time>
</div>

JSON-LD

<script type="application/ld+json">
{
 "@context": "http://schema.org",
 "@type": "GovernmentPermit",
 "issuedBy": {
 "@type": "GovernmentOrganization",
 "name": "Department of Health and Mental Hygiene\""
 },
 "issuedThrough": {
 "@type": "GovernmentService",
 "name": "NYC Food Service Establishment Permit Service"
 },
 "name": "NYC Food Service Establishment Permit",
 "validFor": "",
 "validIn": {
 "@type": "AdministrativeArea",
 "name": "New York"
 }
}
</script>

Example 2

Without Markup

This example shows a JSON-LD description of services that do not necessarily have a direct
human-oriented HTML description. It describes a GovernmentService named "Veterans Affairs Emergency Mental Health" its operator, service area and service details, such as its Veterans Crisis Line (including phone contact line
hours of operation, language and other details).

JSON-LD

<script type='application/ld+json'>
{
 "@context": "schema.org",
 "@type": "GovernmentService",
 "name": "Veterans Affairs Emergency Mental Health",
 "serviceType": "Psychiatric Emergency Services",
 "operator": {
 "@type": "GovernmentOrganization",
 "name": "US Department of Veterans Affairs"
 },
 "serviceArea": {
 "@type": "AdministrativeArea",
 "name": "Massachusetts"
 },
 "serviceAudience": {
 "@type": "CivicAudience",
 "name": "Veterans"
 },
 "availableChannel": {
 "@type": "ServiceChannel",
 "name": "Urgent Care Clinic",
 "availableLanguage": {
 "@type": "Language",
 "name": "Spanish"
 },
 "serviceLocation": {
 "@type": "Hospital",
 "name": "VA Boston -- West Roxbury",
 "address": {
 "@type": "PostalAddress",
 "streetAddress": "1400 VFW Parkway",
 "addressLocality": "West Roxbury",
 "addressRegion": "MA",
 "postalCode": "02132"
 }
 }
 }
}
</script>

Related additions in Schema.org version 1.0d

ContactPoint – e. g. now provides a mechanism for describing contact points for services which support users with hearing impairments.

Organization – a small but useful improvement, adding department and subOrganization properties that relate organizations to each other. This can be used when describing common situations,  when details such as opening hours or contact information vary by department.