{
  "asyncapi": "3.0.0",
  "info": {
    "title": "analytics/geocodings",
    "version": ""
  },
  "channels": {
    "systemEventsAnalyticsGeocoding": {
      "address": "system-events.analytics.geocoding",
      "messages": {
        "analyticsGeocodingExecuted": {
          "$ref": "#/components/messages/analytics.analyticsGeocodingExecuted"
        }
      }
    }
  },
  "operations": {
    "analyticsGeocodingExecuted": {
      "action": "send",
      "channel": {
        "$ref": "#/channels/systemEventsAnalyticsGeocoding"
      },
      "messages": [
        {
          "$ref": "#/channels/systemEventsAnalyticsGeocoding/messages/analyticsGeocodingExecuted"
        }
      ]
    }
  },
  "components": {
    "messages": {
      "analytics.analyticsGeocodingExecuted": {
        "name": "com.qlik.analytics.geocoding.executed",
        "tags": [
          {
            "name": "geo-operations"
          }
        ],
        "title": "Geocoding performed",
        "payload": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/components/schemas/cloudEventsContextAttributes"
            },
            {
              "$ref": "#/components/schemas/cloudEventsQlikExtensionsAttributes"
            },
            {
              "type": "object",
              "properties": {
                "data": {
                  "$ref": "#/components/schemas/geocodingPayload"
                },
                "type": {
                  "type": "string",
                  "default": "com.qlik.analytics.geocoding.executed",
                  "description": "Unique identifier for the event type."
                },
                "source": {
                  "type": "string",
                  "default": "com.qlik/geo-operations",
                  "description": "Identifies the context in which an event happened."
                }
              }
            }
          ]
        },
        "description": "Published when a geocoding lookup is executed.",
        "x-qlik-deprecated": false,
        "x-qlik-stability": "stable",
        "x-qlik-visibility": "public"
      }
    },
    "schemas": {
      "cloudEventsContextAttributes": {
        "type": "object",
        "required": [
          "id",
          "source",
          "specversion",
          "type"
        ],
        "properties": {
          "id": {
            "type": "string",
            "examples": [
              "5f17a489-01a7-410b-83a1-a2af1421cd46"
            ],
            "minLength": 1,
            "description": "Identifies the event."
          },
          "time": {
            "type": "string",
            "format": "date-time",
            "examples": [
              "2026-04-05T17:31:00Z"
            ],
            "minLength": 1,
            "description": "Timestamp of when the occurrence happened. Must adhere to RFC 3339."
          },
          "type": {
            "type": "string",
            "examples": [
              "com.qlik.analytics.geocoding.executed"
            ],
            "minLength": 1,
            "description": "Describes the type of event related to the originating occurrence."
          },
          "source": {
            "type": "string",
            "format": "uri-reference",
            "examples": [
              "com.qlik/geo-operations"
            ],
            "minLength": 1,
            "description": "Identifies the context in which an event happened."
          },
          "specversion": {
            "type": "string",
            "examples": [
              "1.0"
            ],
            "minLength": 1,
            "description": "The version of the CloudEvents specification which the event uses."
          },
          "datacontenttype": {
            "type": "string",
            "default": "application/json",
            "examples": [
              "application/json"
            ],
            "minLength": 1,
            "description": "Content type of the data value. Must adhere to RFC 2046 format."
          }
        },
        "description": "CloudEvents Specification JSON Schema"
      },
      "cloudEventsQlikExtensionsAttributes": {
        "type": "object",
        "required": [
          "tenantid"
        ],
        "properties": {
          "userid": {
            "type": "string",
            "examples": [
              "69a6a037a234a46a56167985"
            ],
            "description": "Unique identifier for the user that triggered the event."
          },
          "tenantid": {
            "type": "string",
            "examples": [
              "5d9b462Bsc46ZP6zCouVwBzyyk4HSrzu"
            ],
            "description": "Unique identifier for the tenant related to the event."
          }
        }
      },
      "geocodingPayload": {
        "type": "object",
        "examples": [
          {
            "appId": "feca8dc1-ae1d-4eef-a1ca-e0ed05fb9332",
            "lookups": 28,
            "operation": "pointtoaddresslookup",
            "requestId": "7304c306-71a4-4665-bd57-91ae52fb2c36"
          }
        ],
        "required": [
          "requestId",
          "lookups",
          "operation"
        ],
        "properties": {
          "appId": {
            "type": "string",
            "examples": [
              "feca8dc1-ae1d-4eef-a1ca-e0ed05fb9332"
            ],
            "description": "Unique identifier of the app that triggered the event."
          },
          "lookups": {
            "type": "integer",
            "examples": [
              28
            ],
            "description": "Number of rows sent for geocoding in this batch"
          },
          "operation": {
            "enum": [
              "pointtoaddresslookup",
              "addresspointlookup"
            ],
            "type": "string",
            "examples": [
              "pointtoaddresslookup"
            ],
            "description": "Type of operation of the original request"
          },
          "requestId": {
            "type": "string",
            "examples": [
              "7304c306-71a4-4665-bd57-91ae52fb2c36"
            ],
            "description": "The unique identifier of the operation that did the geocoding."
          }
        },
        "description": "Geocoding event payload"
      }
    }
  }
}