A pin dropped on a map that does not exist yet. The pin creates the place. Hwt-ka-Ptah — the House of the Ka of Ptah — gave Egypt its name. A place becomes so significant that it names everything around it.
tid
Timestamp-based ID
Properties
authorshipRecord
string
did
Optional
Permanent link to the creator. Provenance travels.
canonicalStatus
string
Optional
The canonical standing of this location within its world.
world.ptah.temp.defs#canonicalStatusOfficial, world.ptah.temp.defs#canonicalStatusCommunity, world.ptah.temp.defs#canonicalStatusApocryphalcreatedAt
string
datetime
Required
Timestamp of location creation.
creatorDID
string
did
Required
Who named and defined this place.
depthIndex
integer
Optional
How deep in the geographic hierarchy this location sits. World-level is 0, continent is 1, country is 2, city is 3, and so on. Any rendering layer can read this single number and decide how much geographic context it needs without traversing the full parent chain.
minimum: 0description
string
Optional
What kind of place this is, in plain language.
maxLength: 10240 bytesmaxGraphemes: 1024 graphemeslocationType
string
Optional
The geographic or spatial classification. Open-ended so any kind of world geography works.
maxLength: 640 bytesmaxGraphemes: 64 graphemescity, region, building, territory, landmark, vessel, abstractSpacename
string
Required
What this place is called.
maxLength: 640 bytesmaxGraphemes: 64 graphemesparentLocation
string
at-uri
Optional
If this location exists inside a larger location — a tavern inside a city, a room inside a building. Lets geography nest infinitely. Places come into existence as people need them.
properties
ref
#locationProperties
Optional
Flexible fields — climate, population, controlling faction, notable history. Whatever the world requires.
worldReference
string
at-uri
Required
The AT URI of the world this location exists in.
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"name",
"creatorDID",
"worldReference",
"createdAt"
],
"properties": {
"name": {
"type": "string",
"maxLength": 640,
"description": "What this place is called.",
"maxGraphemes": 64
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Timestamp of location creation."
},
"creatorDID": {
"type": "string",
"format": "did",
"description": "Who named and defined this place."
},
"depthIndex": {
"type": "integer",
"minimum": 0,
"description": "How deep in the geographic hierarchy this location sits. World-level is 0, continent is 1, country is 2, city is 3, and so on. Any rendering layer can read this single number and decide how much geographic context it needs without traversing the full parent chain."
},
"properties": {
"ref": "#locationProperties",
"type": "ref",
"description": "Flexible fields — climate, population, controlling faction, notable history. Whatever the world requires."
},
"description": {
"type": "string",
"maxLength": 10240,
"description": "What kind of place this is, in plain language.",
"maxGraphemes": 1024
},
"locationType": {
"type": "string",
"maxLength": 640,
"description": "The geographic or spatial classification. Open-ended so any kind of world geography works.",
"knownValues": [
"city",
"region",
"building",
"territory",
"landmark",
"vessel",
"abstractSpace"
],
"maxGraphemes": 64
},
"parentLocation": {
"type": "string",
"format": "at-uri",
"description": "If this location exists inside a larger location — a tavern inside a city, a room inside a building. Lets geography nest infinitely. Places come into existence as people need them."
},
"worldReference": {
"type": "string",
"format": "at-uri",
"description": "The AT URI of the world this location exists in."
},
"canonicalStatus": {
"type": "string",
"description": "The canonical standing of this location within its world.",
"knownValues": [
"world.ptah.temp.defs#canonicalStatusOfficial",
"world.ptah.temp.defs#canonicalStatusCommunity",
"world.ptah.temp.defs#canonicalStatusApocryphal"
]
},
"authorshipRecord": {
"type": "string",
"format": "did",
"description": "Permanent link to the creator. Provenance travels."
}
}
},
"description": "A pin dropped on a map that does not exist yet. The pin creates the place. Hwt-ka-Ptah — the House of the Ka of Ptah — gave Egypt its name. A place becomes so significant that it names everything around it."
}