This is a complete list of metadata fields for Places.

You can add notes, citations, and dates to most of these fields. Learn more at Using Notes, Using Dates, Using Citations.

General Information

This contains the identifier for the Knowledge Map, and lets you make the place private or public.

Field label

Definition

Type
Place IDA unique identifier assigned to the place. The place ID can't be changed: it helps you distinguish the place from others with the same name.short text (cannot be changed)
Public?Sets whether the places is visible to the public. You can check this box if you aren't ready to share the place.checkbox


Names

Names for the Knowledge Map. The name of a place can change across languages or time: you can track those changes here. You can also list popular names for a place, like "C'ville" for "Charlottesville." Learn more about this feature with Add Alternate KMap Names

Field label

Definition

Type

Place

An alternate name for the place.

short text
Name TypeThis sets whether the name is official or popular.checkbox
LanguageThe language of the name. This is independent from the 'writing system,' which you can learn more about below.controlled vocabulary
Writing SystemThe alphabet or symbol system used to represent the language. For example, English uses the Latin script. controlled vocabulary
EtymologyThe etymological origin of the alternate name. WYSIWYG
Primary for Popular Romanization View?Popular romanization is an easy-to-pronounce version of names in roman script, which is intended for audiences around the world.checkbox

Caption

A brief, "tweet-sized" description for the KMap. This appears in KMap previews throughout Mandala. The caption should be under 140 characters. Make sure it's general and clear enough to identify the feature from a list.

Field label

Definition

Type

Language

The language of the caption. Each caption should only have one language. If you need to include a translation, add a new caption.

controlled vocabulary 
CaptionThe text of the caption. This should be shorter than 140 characters. Make sure it's general and clear enough to identify the feature from a list.checkbox
AuthorThe author of the summary. By default, this is set to your username.controlled vocabulary

Summaries

A summary of the important aspects of the place. This should be less than 750 characters long. If you want to translate your summary into multiple languages, each language needs its own summary. You can add more than one summary.

Field label

Definition

Type

Language

The language of the summary. Each summary should only have one language. If you need to include a translation, add a new summary.

controlled vocabulary 
CaptionThe text of the summary. This should be shorter than 750 characters.checkbox
AuthorThe author of the summary. By default, this is set to your username.controlled vocabulary

Illustration

A single image that is representative of the subject or place. It appears next to the summary on the main page for the Knowledge Map. Other images, including those that relate to the subject or place but do not illustrate it, can be added using Images in Mandala. Learn more about this feature with Add Illustrations to KMaps.

Field label

Definition

Type

Language

The language of the caption. Each caption should only have one language. If you need to include a translation, add a new caption.

controlled vocabulary 
CaptionThe text of the caption. This should be shorter than 140 characters. Make sure it's general and clear enough to identify the feature from a list.checkbox
AuthorThe author of the summary. By default, this is set to your username.controlled vocabulary

Feature Types

This section lets you define the type of place you're creating -- for example, a village, a mountain, etc.

Field labelDefinitionType
CategoryThe feature type. This is a subject Knowledge Map. For example, "street" (subject id: S3501)kmap
Numeric ValueA number associated with the feature type. short text
Show master subjectThis option lets you display the topmost ancestor of the feature type. For example, for 'Street' this would be 'Geographical Feature'checkbox
Show subject's immediate parentThis option lets you display the parent of the feature type. For example, for 'Street' this would be 'Transportation Routes'checkbox
Text ValueShort text associated with the feature type.short text

Subjects

Assigns related subjects to a place. Each subject can also have a value. 

Field labelDefinitionType
CategoryThe subject you want to connect to the Knowledge Map. kmap
Numeric Value A number associated with the subject. For example, 'Population' could be associated with the actual population of the place.short text
Show master subjectThis option lets you display the topmost ancestor of the related subject. checkbox
Show subject's immediate parentThis option lets you display the parent of the feature type. For example, you could display Population > Children, then enter the child population for the place in the 'numeric value' field.checkbox
Text Value Short text associated with the subject. short text


Geocode

Codes or identifiers that refer to this place.

Field labelDefinitionType
Geocode TypeThe type of geocode. For example, 'Zip Code.' controlled vocabulary
ValueThe value of the geocode. For example, for Zip Code the value might be '22903.'short text


Locations

The latitude and longitude of the place. This is a single point which represents your Place on a map. If you have a GIS shapefile which represents your place, contact mandala@virginia.edu.

Field labelDefinitionType
Latitude

The longitude of the place. Use decimal degrees for this field: for example, 36.134. You can convert degrees, minutes, and seconds to decimal degrees here.

short text
Longitude

The longitude of the place. Use decimal degrees for this field: for example, 36.134. You can convert degrees, minutes, and seconds to decimal degrees here.

short text
AltitudeThe altitude of the place. This is the altitude of a single point to mark the altitude correctly on Google Maps. For more general altitudes, see the Altitude section. short text

Altitudes

The general elevation of the place.

Field labelDefinitionType
AverageThe average altitude for the place. Don't include units, which you should choose in the "Unit" field. short text
EstimateAn estimated altitude for the place. Don't include the unit, which you can define using the "Unit" field.short text
MinimumA minimum altitude for the place. Don't include the unit, which you can define using the "Unit" field. short text
MaximumThe maximum altitude for the place. Don't include the unit, which you can define using the "Unit" field.short text
UnitThe unit for the average altitude, estimate altitude, minimum altitude, and/or maximum altitude of the place. You should enter these numbers in this section's corresponding fields.controlled vocabulary

Feature Relations

You can assign related places here. This is also used to create child KMaps for a place. Learn more about adding children at Add a New KMap.

To assign an existing related place: 

  1. In the "Feature Relations" metadata section, click New Place Relation
  2. Click Select next to the place you want to connect to the original place
  3. Fill out the form using the table below to guide you
  4. Click Create
Field labelDefinitionType
PlaceThe name of the new place you're creating, or the existing place you're relating to the current place.
Feature relation typeThe type of relationship between the original place and the related place. controlled vocabulary
PerspectiveThe perspective for the relationship. Perspectives let you display faceted understandings of a place. They let you switch between different place trees, each with a different "perspective" or focus. You can learn more at Perspectives. controlled vocabulary

Essay

This is a legacy option. You should use Texts in Mandala if you want to add a longer essay to your Knowledge Map.

Homepage Texts

Homepage Texts are featured on the overview page for your place. This lets you add longer content than summaries or captions. To add a homepage text, you'll first work in Mandala Texts: 

  1. Create your content in Mandala Texts: use this guide for help. You can also use an existing Mandala Text. 
  2. Tag your text with the place: use this guide for help. For example, if I wanted the text to appear on the Lhasa overview page, I would tag it with Lhasa
  3. Return to the Places editorial interface to add your Homepage Text

In the Homepage Texts section: 

  1. Click New Homepage Text
  2. Choose your text
    1. If you don't see the text, make sure you tagged it with the appropriate place (see above)
  3. Choose the language of the text
  4. Click Create

Controlled Vocabularies

Name Type

ValueDefinition

Official

The government name for the place. For example, "New York." 
PopularA popular name for the place, used in speech or non-official documents. For example. "The Big Apple."

Language

Writing System

Unit

Feature Relation Type

Geocode Types

Perspectives

Get the full list at Using Perspectives