title: analytics/mediawiki/maps/interaction
description: >-
  User interaction recorded by the Extension:Kartographer frontend or backend.
$id: /analytics/mediawiki/maps/interaction/1.0.0
$schema: https://json-schema.org/draft-07/schema#
type: object
allOf:
  - $ref: /fragment/analytics/common/2.0.0#
  - required:
    - action
    properties:
      action:
        type: string
        description: >-
          Type of interaction from the user:

          `fullscreen` - Clicked the thumbnail to open a fullscreen map.

          `nearby-link-click` - The first time a user clicks on an article title
          in the "nearby" popup, recorded at most once per fullscreen map view.

          `nearby-marker-paint` - Sent after the first group of nearby markers
          are displayed, and includes some performance metrics.

          `nearby-show` - The first time "show nearby" button was clicked,
          recorded at most once per fullscreen map view.  There's no event when
          hiding the nearby layer.
        enum:
          - fullscreen
          - nearby-link-click
          - nearby-marker-paint
          - nearby-show
      initial_marker_count:
        type: integer
        description: >-
          Included in `nearby-marker-paint` events, this is the initial number
          of nearby markers that were displayed.
        minimum: 0
      initial_marker_time_ms:
        type: integer
        description: >-
          Included in `nearby-marker-paint` events, this is the number of
          milliseconds elapsed between clicking the "show nearby" button and
          seeing the first markers drawn.
        minimum: 0

examples:
  - $schema:
      $ref: '#/$id'
    meta:
      dt: '2022-01-01T00:00:00Z'
      domain: ar.wikipedia.org
      stream: mediawiki.maps.interaction
    action: 'fullscreen'
  - $schema:
      $ref: '#/$id'
    meta:
      dt: '2022-01-01T00:00:00Z'
      domain: ar.wikipedia.org
      stream: mediawiki.maps.interaction
    action: 'nearby-marker-paint'
    initial_marker_count: 50
    initial_marker_time_ms: 123