You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

How to use this guide

This is a complete list of metadata fields for Places.

You can use these tables to guide your data entry. We've listed fields in the order they appear in the editor. Each section in the editor has its own table. 

For certain fields, you have a restricted list of options called controlled vocabulariesWe've listed the controlled vocabularies for those fields at the bottom of the page.

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. 
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."

Field label

Definition

Type

Place

An alternate name for the place.

 
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. 
Writing SystemThe alphabet or symbol system used to represent the language. For example, English uses the Latin script.  
EtymologyThe etymological origin of the alternate name.  
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. 

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.

 
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. 

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.

 
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.

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.

 
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.

Feature Types

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

Field label

Definition

Type

Category

 

 
Text Value  
Numeric Value  
Numeric Value  
Show subject's immediate parent  
Show master subject checkbox

Subjects

Assigns related subjects. This is also used to create child KMaps for a subject. Learn more at Add a New KMap.

Field label

Definition

Type

Category

 

 
Text Value  
Numeric Value  
Numeric Value  
Show subject's immediate parent  
Show master subject checkbox

Geocode

Codes or identifiers that refer to this place.

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 shanti-mandala@virginia.edu.

Altitudes

The general elevation of the place.

Feature Relations

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

Essay

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

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

  • Arabic
  • Burmese
  • Chinese
  • Dzongkha
  • English
  • French
  • German
  • Hindi
  • Italian
  • Japanese
  • Korean
  • Latin
  • Mongolian
  • Nepali
  • Pali
  • Polish
  • Prakrit
  • Russian
  • Sanskrit
  • Sinhalese
  • Spanish
  • Thai
  • Tibetan
  • Unknown
  • Urdu
  • Vietnamese

Writing System

  • Cyrillic
  • Devanagari Script
  • Latin Script
  • Simplified Chinese Characters
  • Tibetan Script
  • Traditional Chinese Characters


Geocode Type

ValueDefinition

Postal Code

A postal code (as assigned by a government) for an area. This should be used regardless of the nomenclature assigned by the government.

Use the specific "zip code" geocode type for US postal codes.

Zip Code

The official postal code assigned to districts by the US government, and which is used in writing addresses on letters for mail delivery. They are all numerical and 5 digits in length.

ISO 3166-1 Alpha-2

ISO 3166-1 Alpha-3

ISO 3166-1 Numeric 

GB Code

Official geocodes assigned to administrative units in contemporary China by the Chinese government.

Governing Organization: Standardization Administration of China

 

TBRC Geocode

Codes used by the Buddhist Digital Resource Center (formerly Tibetan Buddhist Resource Center) for places.

Governing Organization: Buddhist Digital Resource Center

Bellezza Site ID 

Royal Government Of Bhutan Code
 

THL Extended GB Code
The Tibetan and Himalayan Library (THL) uses these codes. They are based upon the Chinese government GB codes, but have 4 additional digits at the end to make a total of 10 digits. These additional digits have been added by THL.
GB Code - Ryavec 
Aufschnaiter Lhasa Map ID 
Tibet Heritage Fund Lhasa Building ID 
Lhasa Atlas ID 
FlashMap ID This is used to store the FlashMap ID from Sera, Drepung, Meru Nyingpa, Barkhor, Lhasa Neighborhoods, TU map, and UVa map (and any other FlashMaps). This data is not displayed in public view.
US 2-Character State FIPS Code 
US 8-Character National Standard ANSI Code 
Official United States Postal Service State Abbreviations 
US 2-Character 113th Congressional District FIPS Code 
US Geographic ID 
US AFF Summary Level Code 
US 3-Character County FIPS Code
US 8-Character National Standard ANSI Codehttps://www.census.gov/geo/reference/ansi.html
  
  
  
  
  

Feature Relation Type

Location-based Relationships

has the same location as 

Two features that are located in the same place.


has entirely located within it/ is entirely located in 

A geographical relationship where one feature contains the other feature in its entirety.


is the partial location of/ is partially located in

  • Places that are partially located in several places, or

  • Places that contain parts of other places.

If a place is entirely contained by another feature, use the "is contained by" relationship.

You might be unsure if the place is entirely contained in another place. This might happen for historical units, where you're uncertain about boundaries. In this case, use 'partially located in' to show this uncertainty.

Example:

A historical polity covers a geographical area within part of four contemporary counties. This historical polity's area doesn't completely cover any of the counties. The historical polity 'is partially located in' each of these four counties.


intersects with

Two features that overlap. You may not be sure about the exact relationship between two regions, but know that they overlap in geographical territory at least partially. In this case, we recommend "is the partial location of", not "intersects with." If you think "intersects with" is preferable in your case, let us know. We'll include your case as an example in this documentation.

Example: 

A natural area, river, or mountain which spans multiple administrative units, all of which it “intersects with.”


 

is adjacent to

Two places which share a border. If they're close to each other but don't share a border, use “is near.”


 

is near

 Two features near to each other.

Example: 

A tourist site may be "near to" another tourist site. By including this relationship, you can help viewers plan trips.


 

is centered in/ has centered in it

 A place centrally located in another place. This is independent of whether or not a places is "partially located in" another place.

Example:

  • The contemporary Degé County was historically Degé Kingdom. The full extent of the historical Dege Kingdom, however, is not covered by the county and includes other contemporary administrative units. Since Dege County covers the core geographical area of the Kingdom, Degé Kingdom "is centered in" the modern administrative unit Degé County.

    To properly record the relationship, note that Degé Kingdom is also "partially located in" Degé County. This makes it clear that the contemporary county doesn't contain the full extent of the kingdom.

Cultural Relationships

has as an instantiation (has.as.an.instantiation)/ is an instantiation of (is.an.instantiation.of): an instantiation of a metaphysical feature.

Examples: 

  • Padmasambhava’s Copper Colored mountain is a pure land located outside of our ordinary geography, but there are many temples across the plateau understood to exemplify that pure land. These temples are “instantiations” of Padmasambhava’s Copper Colored mountain.

  • Many of the great Buddhist cult mountains are considered “instantiations” of the great mandala of the Buddhist deity Cakrasa?vara.

  • A McDonald's restaurant is an "instantiation" of McDonald's as a corporate entity.

has as a part (has.as.a.part)/ is part of (is.part.of): A relationship where one place is part of another, but not in a hierarchical or administrative manner. Places with this relationship usually (but not always) have the same feature type. If one place is part of another in a hierarchical or administrative way, use "has entirely located within it/is entirely located in."

Example: 

  • Cultural regions can have one large cultural region and many smaller cultural regions that are "part of" it. The Degé cultural region "is part of" the Kham cultural region.

  • A mountain "is part of" a mountain range.

  • An individual field "is part of" a farm or estate (whether the field is contiguous with the farm/estate or not)

  • Use "has entirely located within it/is entirely located in it" to specify a village is part of a township, NOT "has as a part/is part of"

administers (administers)/ is administered by (is.administered.by): an administrative relationship between two places.

Examples:

  • A contemporary township within a county. Albermarle County "administers" Charlottesville. In this case, the authority of the county over the city is more important than the fact that Albermarle County contains Charlottesville geographically.

  • Don't use: for a village located inside a township. Instead, use "is entirely located in" or "is contained by."

  • Don't use: for a mountain (or other geographical feature) located inside a town. The town does not actively administer the mountain; this is different from a county that administers the town.

has as an administrative seat (has.as.an.administrative.seat)/ is the administrative seat of (is.administrative.seat.of): the relationship a nation, historical polity, or political administrative unit has with its capitals or seats.

administrative headquarters of (is.administrative.headquarters.of)/ has as an administrative headquarters (has.as.an.administrative.headquarters): the relationship between an entity (corporation, school district, or other) and its headquarters.

is mother of (is.mother.of)/ is child of (is.child.of): 

is succeeded by (is.succeeded.by)/ succeeds (succeeds): use this relationship when a place succeeds another place. Succession implies both a fundamental difference and a fundamental continuity. Succession also implies that the one feature has supplanted the previous feature. In many cases:

  • both places (the original and the suceeding place) have the same name

  • one place succeeds the other immediately in time

The 'is succeeded by/succeeds' relationship is independant of location. This means the geographical area covered by the two places can vary. Here are some possibilities :

  • both places cover roughly the same geographical area

  • the original place is larger than the successor

  • the original place is larger than the successor, and the successor covers the core area of the preceding feature

You can use other relationships to describe the geographical location relation between the original place and the successor.

Example: 

  • A kingdom is reduced to a county in a new political formation. The county "succeeds" the kingdom.

is owner of (owns)/is owned by (is.owned.by): a relationship of ownership or property

Example:

  • a monastery owns a city residence

  • an estate owns a field

is affiliated with (is.affiliated.with): a non-hierarchal relationship between two places. In this relationship, neither place is 'subordonate' to the other.

Example:

  • Political allies are affiliated with each other.

  • Sacred sites can be linked non-hierarchically.

  • Poggio a Caiano in Italy is a 'sister city' of Charlottesville in the USA. Poggio a Caiano is affiliated to Charlottesville.

is in conflict with (is.in.conflict.with): represents a relationship of conflict

Example: 

  • two polities at war, or in more low-level conflict.

is related to (is.related.to): this is a generic expression of relationship between two places. Use this when none of the other more specific relationship types apply.

Picture Type









  • No labels