entity

  • This page describes the entity canonical concept dataset, providing a structured way to define concepts representing real-world entities.

  • The dataset includes a concept called "entity" which serves as the base for defining other entity concepts and includes properties for name, description, information URL, and color.

  • Users can access the complete dataset as an XML file and a CSV file for the "entity_order" table, which defines the display order of entities.

  • The "entity" concept can be extended to create specific entity types like airports or industries, each with its own table containing data about individual entities.

  • The dataset utilizes namespaces and attributes for organization and detailed information about entities, ensuring consistency and interoperability.

This page documents the entity canonical concept dataset. The complete XML file is also available for review.

Basic Info

Name Entity concepts
Description Entity concepts.
Namespace http://www.google.com/publicdata/dataset/google/entity
URL http://code.google.com/apis/publicdata/docs/canonical/entity.html

Provider

Name Google Inc.
Description Google Inc.
URL http://www.google.com

Imported Namespaces

No imported namespaces.

Topics

No topics defined.

Concepts

Concept: entity

ID entity [XML]
Name Entity
Type string
Description Base concept for defining concepts that represent entities.
Attributes
entity_order
ID
(implied)		 entity_order [XML]
Concept entity_order
Properties
name
description
info_url
color
ID name [XML]
Name Name
Type string
Description The name used to display an entity. Example: 
  <concept id="airport" extends="entity:entity">
    <info>
      <name>
        <value>Airport</value>
      </name>
      <description>
        <value>Airports, identified by their 3-letter IATA code</value>
      </description>
    </info>
    <table ref="airports_table"/>
  </concept>

The airports_table contains a “name” column, with the name of each airport: 
  airport,name
  MLB,Melbourne International Airport
  SFO,San Francisco International Airport
  LGW,London Gatwick Airport

Note: names can be provided in multiple languages, in different columns, using concept table mappings.
ID description [XML]
Name Description
Type string
Description The description of an entity. Usage example: 
  <concept id="airport" extends="entity:entity">
    <info>
      <name>
        <value>Airport</value>
      </name>
      <description>
        <value>Airports, identified by their 3-letter IATA code</value>
      </description>
    </info>
    <table ref="airports_table"/>
  </concept>

The airports_table contains a “description” column, with a description of each airport: 
              
  airport,name,description
  MLB,Melbourne International Airport, "... located 1 1/2 miles northwest of the downtown business district ..."
  SFO,San Francisco International Airport, "... international airport located 13 miles south of San Francisco ..."
  LGW, London Gatwick Airport,  "... located 5 km (3.1 mi) north of the centre of Crawley, West Sussex ..."
  LHR, London Heathrow Airport, "... largest airport in the United Kingdom ..."
ID info_url [XML]
Name Info Url
Type string
Description A URL where more information can be found about an entity. Usage example: 
  <concept id="airport" extends="entity:entity">
    <info>
      <name>
        <value>Airport</value>
      </name>
      <description>
        <value>Airports, identified by their 3-letter IATA code</value>
      </description>
    </info>
    <table ref="airports_table"/>
  </concept>

The countries table contains an “info_url” column, with an info URL for each country. 
  country,  name,          info_url
  AD,       Andorra,       http://en.wikipedia.org/wiki/Andorra
  AF,       Afghanistan,   http://en.wikipedia.org/wiki/Afghanistan
  AI,       Anguilla,      http://en.wikipedia.org/wiki/Anguilla
  AL,       Albania,       http://en.wikipedia.org/wiki/Albania
ID color [XML]
Name Color
Type string
Description A color, represented by its hexadecimal code (e.g., "#FFAB00"). Example: 
  <concept id="us_political_party" extends="entity:entity">
    <info>
      <name>
        <value>US Political party</value>
      </name>
    </info>
    <table ref="parties_table"/>
  </concept>

The parties_table contains a party_color column: 
  party, name,             color
  rep,   Republican party, #FF0000
  dem,   Democratic party, #0000FF

Concept: entity_order

ID entity_order [XML]
Name Entity order
Type string
Data entity_order_table
Description Specifies the order in which the entities should be displayed. ALPHA is alphabetical order, TABLE is the order of entities in the table. Example: 
  <concept id="industry" extends="entity:entity">
    <info>
      <name>
        <value xml:lang="en">Industry</value>
      </name>
    </info>
    <attribute id="order">
      <value>NATURAL</value>
    </attribute>
    <property id="industry" isParent="true"/>
    <table ref="industries_tbl"/>
  </concept>
Attributes No local attributes.
Properties No local properties.

Slices

No slices defined.

Tables

Table: entity_order_table

ID entity_order_table [XML]
Data entity_order.csv [CSV]
Columns
Name Type
entity_order string