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.

Repository @placita.app did:plc:sg5d3buklhrsufaej4n4hjzx namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityplacita.app
Indexed

Record

record · key tid

Properties

category

string

Place type from Placita's fixed list, for example restaurant, cafe or museum. Missing or unknown means generic.

  • maxLength: 32
  • knownValues: 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

createdAt

requiredstring · datetime

When the place was saved.

location

requiredunion

Where the place is. Normally community.lexicon.location.geo: coordinates as strings, with the street address in its name field when known.

name

requiredstring

Name of the place as the user saved it.

  • maxLength: 300
  • maxGraphemes: 100

note

string

The user's own note about the place.

  • maxLength: 3000
  • maxGraphemes: 1000

noteTitle

string

Optional short title for the note.

  • maxLength: 100
  • maxGraphemes: 100

Opening hours in OpenStreetMap opening_hours syntax, for example Mo-Su 09:00-18:00.

  • maxLength: 512

osm

ref

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

Reference

osmId

string

ID of the linked OpenStreetMap feature as a decimal string. Used together with osmType.

  • maxLength: 32

osmType

string

Type of the linked OpenStreetMap feature. Set only when the user confirmed the match. Used together with osmId.

  • knownValues: node | way | relation

phone

string

The place's phone number, as entered or taken from OpenStreetMap.

  • maxLength: 64

photo

blob

Legacy single photo. Only older records have it. New records use photos.

  • maxSize: 2000000
  • accept: image/png, image/jpeg, image/webp

Who 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: 300
  • maxGraphemes: 100

photos

array

Photos the user uploaded for this place. Up to 4.

itemsblob
  • maxSize: 2000000
  • accept: image/png, image/jpeg, image/webp

placeCode

string

An 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

Reference 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

integer

The user's own rating of the place, from 1 (poor) to 5 (excellent). Only set when status is been. Absent means not rated.

  • minimum: 1
  • maximum: 5

source

string

Where 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

Creator or credit text returned by Wikimedia Commons for sourcePhotoUrl.

  • maxLength: 500

License of sourcePhotoUrl, e.g. CC BY-SA 4.0. Attribution duty applies when shown.

  • maxLength: 64

License details URL returned by Wikimedia Commons.

  • maxLength: 2048

Source file page URL for attribution and reuse details.

  • maxLength: 2048

Origin label for the source photo suggestion.

  • maxLength: 128

URL 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

string

The link the place was created from, when there was one.

  • maxLength: 2048

status

requiredstring

want means the user wants to go there. been means the user has been there.

  • default: "want"
  • knownValues: want | been

tags

array

The user's tags for this place, as strong references to app.placita.tag records.

  • maxLength: 50
itemsref

visibility

requiredstring

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

string

The place's website.

  • maxLength: 2048

#osmAddress

object

A structured address, as OpenStreetMap returns it. Every part is optional.

Properties

city

string

City, town or village.

  • maxLength: 200

country

string

Country name.

  • maxLength: 200

Two-letter ISO 3166-1 country code, upper case.

  • minLength: 2
  • maxLength: 2

House or building number.

  • maxLength: 32

postcode

string

Postal code.

  • maxLength: 32

state

string

Region or state.

  • maxLength: 200

street

string

Street or road name.

  • maxLength: 200

suburb

string

Neighbourhood, quarter or suburb.

  • maxLength: 200

#osmDetails

object

Address 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

The structured address OpenStreetMap has for the feature.

Reference

checkedAt

string · datetime

When the details were copied from OpenStreetMap. Absent for details that were only typed.

editedAt

string · datetime

When the person last changed these details by hand, or typed them. Details with no checkedAt were never copied from OpenStreetMap.

tags

array

Raw 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
itemsref
Reference

#osmTag

object

One OpenStreetMap tag.

Properties

key

requiredstring

The tag key, for example cuisine.

  • maxLength: 64

value

requiredstring

The tag value, for example italian;pizza. Values over 255 characters are not stored.

  • maxLength: 1024
  • maxGraphemes: 255

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A 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.

  • A user-created venue definition

  • A 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.

  • A record for keeping track of a place in Spots

  • A place with a review