matrix-spec/data/event-schemas/schema/m.room.message$m.location.yaml

---
allOf:
  - $ref: core-event-schema/room_event.yaml
description: This message represents a real-world location.
properties:
  content:
    properties:
      body:
        description: "A description of the location e.g. 'Big Ben, London, UK', or some kind of content description for accessibility e.g. 'location attachment'."
        type: string
      geo_uri:
        description: A [geo URI (RFC5870)](https://datatracker.ietf.org/doc/html/rfc5870) representing this location.
        type: string
      msgtype:
        enum:
          - m.location
        type: string
      info:
        type: object
        properties:
          thumbnail_url:
            description: |-
              The URL to a thumbnail of the location being represented.
              Only present if the thumbnail is unencrypted.
            type: string
          thumbnail_file:
            description: |-
              Information on the encrypted thumbnail file, as specified in
              [End-to-end encryption](/client-server-api/#sending-encrypted-attachments).
              Only present if the thumbnail is encrypted.
            title: EncryptedFile
            type: object
          thumbnail_info:
            allOf:
              - $ref: core-event-schema/msgtype_infos/thumbnail_info.yaml
            description:  Metadata about the image referred to in `thumbnail_url`.
        title: LocationInfo
    required:
      - msgtype
      - body
      - geo_uri
    type: object
  type:
    enum:
      - m.room.message
    type: string
title: LocationMessage
type: object