LocationAPI.yaml

        example: 'rel="ZonalTrafficSubscription" href="http://example.com/exampleAPI/location/v1/subscriptions/zonalTraffic/sub123"/'
  ZonalTrafficSubscription:
    description: A type containing zonal traffic subscription
    type: object
    required:
      - callbackReference
      - zoneId
    properties:
      clientCorrelator:
        $ref: '#/definitions/ClientCorrelator'
      callbackReference:
        $ref: '#/definitions/CallbackReference'
      zoneId:
        $ref: '#/definitions/ZoneId'
      interestRealm:
        description: 'Interest realms of access points within a zone (e.g. geographical area, a type of industry etc.).'
        type: array
        items:
          $ref: '#/definitions/InterestRealm'
      userEventCriteria:
        description: 'List of user event values to generate notifications for (these apply to zone identifier or all interest realms within zone identifier specified). If this element is missing, a notification is requested to be generated for any change in user event.'
        type: array
        items:
          $ref: '#/definitions/UserEventType'
      duration:
        $ref: '#/definitions/Duration'
      resourceURL:
        $ref: '#/definitions/ResourceURL'
  ZoneId:
    description: Identifier of zone
    type: string
    example: zone01
  ZoneInfo:
    description: A type containing zone information.
    type: object
    required:
      - zoneId
      - numberOfAccessPoints
      - numberOfUnservicableAccessPoints
      - numberOfUsers
      - resourceURL
    properties:
      zoneId:
        $ref: '#/definitions/ZoneId'
      numberOfAccessPoints:
        $ref: '#/definitions/NumberOfAccessPoints'
      numberOfUnservicableAccessPoints:
        $ref: '#/definitions/NumberOfUnserviceableAccessPoints'
      numberOfUsers:
        $ref: '#/definitions/NumberOfUsers'
      resourceURL:
        $ref: '#/definitions/ResourceURL'
  ZoneList:
    description: Collection of the zone information list.
    type: object
    required:
      - resourceURL
    properties:
      zone:
        description: Collection of the zone information list.
        type: array
        items:
          $ref: '#/definitions/ZoneInfo'
      resourceURL:
        $ref: '#/definitions/ResourceURL'
  ZoneStatusNotification:
    description: A type containing zone status notification.
    type: object
    required:
      - zoneId
      - timestamp
    properties:
      callbackData:
        $ref: '#/definitions/CallbackData'
      zoneId:
        $ref: '#/definitions/ZoneId'
      accessPointId:
        $ref: '#/definitions/AccessPointId'
      numberOfUsersInZone:
        $ref: '#/definitions/NumberOfUsersInZone'
      numberOfUsersInAP:
        $ref: '#/definitions/NumberOfUsersInAP'
      operationStatus:
        $ref: '#/definitions/OperationStatus'
      timestamp:
        $ref: '#/definitions/Timestamp'
      link:
        description: Link to other resources that are in relationship with this notification. The server SHOULD include a link to the related subscription. No other links are required or suggested by this specification.
        type: array
        items:
          $ref: '#/definitions/Link'
        example: 'rel="ZonalStatusSubscription" href="http://example.com/exampleAPI/location/v1/subscriptions/zonalStatus/sub123"'
  ZoneStatusSubscription:
    description: A type containing zone status subscription.
    type: object
    required:
      - callbackReference
      - zoneId
    properties:
      clientCorrelator:
        $ref: '#/definitions/ClientCorrelator'
      resourceURL:
        $ref: '#/definitions/ResourceURL'
      callbackReference:
        $ref: '#/definitions/CallbackReference'
      zoneId:
        $ref: '#/definitions/ZoneId'
      numberOfUsersZoneThreshold:
        $ref: '#/definitions/NumberOfUsersZoneThreshold'
      numberOfUsersAPThreshold:
        $ref: '#/definitions/NumberOfUsersAPThreshold'
      operationStatus:
        description: List of operation status values to generate notifications for (these apply to all access points within a zone).
        type: array
        items:
          $ref: '#/definitions/OperationStatus'