app.placita.place
A place saved by a user. The primary entity of Placita: one record per place, stored in the user's own repository.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | placita.app |
| Indexed |
Record
record · key tidProperties
category
stringPlace type from Placita's fixed list, for example restaurant, cafe or museum. Missing or unknown means generic.
maxLength: 32knownValues: generic | restaurant | fastfood | cafe | bar | beer | wine | nightclub | bakery | grocery | clothing | shopping | lodging | campsite | museum | attraction | viewpoint | worship | park | playground | sports | swimming | zoo | cinema | theatre | library | school | college | hospital | pharmacy | doctor | dentist | bank | atm | post | police | fuel | parking | bus | rail | airport | ferry
When the place was saved.
Where the place is. Normally community.lexicon.location.geo: coordinates as strings, with the street address in its name field when known.
Name of the place as the user saved it.
maxLength: 300maxGraphemes: 100
note
stringThe user's own note about the place.
maxLength: 3000maxGraphemes: 1000
noteTitle
stringOptional short title for the note.
maxLength: 100maxGraphemes: 100
openingHours
stringOpening hours in OpenStreetMap opening_hours syntax, for example Mo-Su 09:00-18:00.
maxLength: 512
osm
refDetails in OpenStreetMap's own words (structured address, tags). Copied from OpenStreetMap when the place is linked (see checkedAt), and editable by the person (see editedAt). May also hold details typed for a place with no link. A copy made at a point in time: it is not kept up to date.
osmId
stringID of the linked OpenStreetMap feature as a decimal string. Used together with osmType.
maxLength: 32
osmType
stringType of the linked OpenStreetMap feature. Set only when the user confirmed the match. Used together with osmId.
knownValues: node | way | relation
phone
stringThe place's phone number, as entered or taken from OpenStreetMap.
maxLength: 64
photo
blobLegacy single photo. Only older records have it. New records use photos.
maxSize: 2000000accept: image/png, image/jpeg, image/webp
photoCredit
stringWho took the photos in photos, when they are not the person who owns this record, for example because they were copied from a public place of another person. Free text such as Photos by @alice.example. Only set together with photos.
maxLength: 300maxGraphemes: 100
photos
arrayPhotos the user uploaded for this place. Up to 4.
maxSize: 2000000accept: image/png, image/jpeg, image/webp
placeCode
stringAn opaque random code that names the place itself, for a place with no confirmed OpenStreetMap link. The person who first saves such a place makes it; every copy another person saves keeps it unchanged, so copies of one place can be found together. Not set when the place has an OpenStreetMap link, which names the place instead. Lowercase letters and the digits 2 to 7.
maxLength: 64
postRef
refReference to the Bluesky post this place was shared as. The post links to this person's public page for the place. Set when the owner shares the place from Placita; absent otherwise.
rating
integerThe user's own rating of the place, from 1 (poor) to 5 (excellent). Only set when status is been. Absent means not rated.
minimum: 1maximum: 5
source
stringWhere the place came from: a map or review link the user pasted, an OpenStreetMap search result, or manual entry.
knownValues: google | foursquare | osm | apple | tripadvisor | manual
sourcePhotoAuthor
stringCreator or credit text returned by Wikimedia Commons for sourcePhotoUrl.
maxLength: 500
sourcePhotoLicense
stringLicense of sourcePhotoUrl, e.g. CC BY-SA 4.0. Attribution duty applies when shown.
maxLength: 64
sourcePhotoLicenseUrl
stringLicense details URL returned by Wikimedia Commons.
maxLength: 2048
sourcePhotoPageUrl
stringSource file page URL for attribution and reuse details.
maxLength: 2048
sourcePhotoSourceName
stringOrigin label for the source photo suggestion.
maxLength: 128
sourcePhotoUrl
stringURL of a free-licensed photo found for this place (Wikimedia Commons, OSM image tag, Wikidata P18). Not a blob - it is a reference to an external image, with attribution.
maxLength: 2048
sourceUrl
stringThe link the place was created from, when there was one.
maxLength: 2048
want means the user wants to go there. been means the user has been there.
default: "want"knownValues: want | been
tags
arrayThe user's tags for this place, as strong references to app.placita.tag records.
maxLength: 50
Whether Placita shows this place in public discovery. This is a display hint only: every record in an AT Protocol repository can be read by anyone, including hidden ones.
default: "hidden"knownValues: hidden | public
website
stringThe place's website.
maxLength: 2048
#osmAddress
objectA structured address, as OpenStreetMap returns it. Every part is optional.
Properties
city
stringCity, town or village.
maxLength: 200
country
stringCountry name.
maxLength: 200
countryCode
stringTwo-letter ISO 3166-1 country code, upper case.
minLength: 2maxLength: 2
houseNumber
stringHouse or building number.
maxLength: 32
postcode
stringPostal code.
maxLength: 32
state
stringRegion or state.
maxLength: 200
street
stringStreet or road name.
maxLength: 200
suburb
stringNeighbourhood, quarter or suburb.
maxLength: 200
#osmDetails
objectAddress and tags in OpenStreetMap's vocabulary: a copy of what OpenStreetMap knew about the linked feature at checkedAt, and/or what the person typed (editedAt). Data copied from OpenStreetMap is (c) OpenStreetMap contributors, available under the Open Database Licence (ODbL). Treat the values as suggestions: they can be wrong or out of date, and the user's own fields always win.
Properties
address
refThe structured address OpenStreetMap has for the feature.
checkedAt
string · datetimeWhen the details were copied from OpenStreetMap. Absent for details that were only typed.
editedAt
string · datetimeWhen the person last changed these details by hand, or typed them. Details with no checkedAt were never copied from OpenStreetMap.
tags
arrayRaw OpenStreetMap tags (key and value) of the feature, such as cuisine, wheelchair or wikidata. Tags already stored in other fields (name, website, phone, opening hours) and OpenStreetMap-internal tags (source, note, fixme) are left out. At most 60.
maxLength: 60
#osmTag
objectOne OpenStreetMap tag.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
social.skyphone.spot.review
recordA public review of a real-world place (restaurant, cafe, shop, etc.). Designed so any AT Protocol app can read, render, and aggregate place reviews regardless of which app created them.
-
app.beaconbits.venue
recordA user-created venue definition
-
social.passports.place
objectA place embedded inline in a passport entry. Self-contained: carries name, coordinates, and enough identifiers for any AT Proto consumer to look up richer data from ATGeo (https://atgeo.org). atgeoCollection + atgeoRkey let consumers fetch full detail (alt names, categories, address) without this record depending on an external service at read time.
-
us.polhem.spots.places.entry
recordA record for keeping track of a place in Spots
-
at.noted.place
recordA place with a review