app.placita.place

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A place saved by a user. The primary entity of Placita: one record per place, stored in the user's own repository.",
      "key": "tid",
      "record": {
        "properties": {
          "category": {
            "description": "Place type from Placita's fixed list, for example restaurant, cafe or museum. Missing or unknown means generic.",
            "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"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "createdAt": {
            "description": "When the place was saved.",
            "format": "datetime",
            "type": "string"
          },
          "location": {
            "description": "Where the place is. Normally community.lexicon.location.geo: coordinates as strings, with the street address in its name field when known.",
            "refs": [
              "community.lexicon.location.geo",
              "community.lexicon.location.address"
            ],
            "type": "union"
          },
          "name": {
            "description": "Name of the place as the user saved it.",
            "maxGraphemes": 100,
            "maxLength": 300,
            "type": "string"
          },
          "note": {
            "description": "The user's own note about the place.",
            "maxGraphemes": 1000,
            "maxLength": 3000,
            "type": "string"
          },
          "noteTitle": {
            "description": "Optional short title for the note.",
            "maxGraphemes": 100,
            "maxLength": 100,
            "type": "string"
          },
          "openingHours": {
            "description": "Opening hours in OpenStreetMap opening_hours syntax, for example Mo-Su 09:00-18:00.",
            "maxLength": 512,
            "type": "string"
          },
          "osmId": {
            "description": "ID of the linked OpenStreetMap feature as a decimal string. Used together with osmType.",
            "maxLength": 32,
            "type": "string"
          },
          "osmType": {
            "description": "Type of the linked OpenStreetMap feature. Set only when the user confirmed the match. Used together with osmId.",
            "knownValues": [
              "node",
              "way",
              "relation"
            ],
            "type": "string"
          },
          "phone": {
            "description": "The place's phone number, as entered or taken from OpenStreetMap.",
            "maxLength": 64,
            "type": "string"
          },
          "photo": {
            "accept": [
              "image/png",
              "image/jpeg",
              "image/webp"
            ],
            "description": "Legacy single photo. Only older records have it. New records use photos.",
            "maxSize": 2000000,
            "type": "blob"
          },
          "photos": {
            "description": "Photos the user uploaded for this place. Up to 4.",
            "items": {
              "accept": [
                "image/png",
                "image/jpeg",
                "image/webp"
              ],
              "maxSize": 2000000,
              "type": "blob"
            },
            "maxItems": 4,
            "type": "array"
          },
          "source": {
            "description": "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"
            ],
            "type": "string"
          },
          "sourcePhotoAuthor": {
            "description": "Creator or credit text returned by Wikimedia Commons for sourcePhotoUrl.",
            "maxLength": 500,
            "type": "string"
          },
          "sourcePhotoLicense": {
            "description": "License of sourcePhotoUrl, e.g. CC BY-SA 4.0. Attribution duty applies when shown.",
            "maxLength": 64,
            "type": "string"
          },
          "sourcePhotoLicenseUrl": {
            "description": "License details URL returned by Wikimedia Commons.",
            "maxLength": 2048,
            "type": "string"
          },
          "sourcePhotoPageUrl": {
            "description": "Source file page URL for attribution and reuse details.",
            "maxLength": 2048,
            "type": "string"
          },
          "sourcePhotoSourceName": {
            "description": "Origin label for the source photo suggestion.",
            "maxLength": 128,
            "type": "string"
          },
          "sourcePhotoUrl": {
            "description": "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,
            "type": "string"
          },
          "sourceUrl": {
            "description": "The link the place was created from, when there was one.",
            "maxLength": 2048,
            "type": "string"
          },
          "status": {
            "default": "want",
            "description": "want means the user wants to go there. been means the user has been there.",
            "knownValues": [
              "want",
              "been"
            ],
            "type": "string"
          },
          "tags": {
            "description": "The user's tags for this place, as strong references to app.placita.tag records.",
            "items": {
              "ref": "com.atproto.repo.strongRef",
              "type": "ref"
            },
            "maxLength": 50,
            "type": "array"
          },
          "visibility": {
            "default": "hidden",
            "description": "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.",
            "knownValues": [
              "hidden",
              "public"
            ],
            "type": "string"
          },
          "website": {
            "description": "The place's website.",
            "maxLength": 2048,
            "type": "string"
          }
        },
        "required": [
          "name",
          "status",
          "visibility",
          "location",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.placita.place",
  "lexicon": 1
}