Skip to main content

Appendix

Seat Layout API​

  1. The seat layout of a hall is represented by the twoDimensionView field of the CinemaHallLayout object.
  2. twoDimensionView is an array whereby each element is of type SeatRow which represents the row of the seat layout.
  3. The SeatRow contains the field seats which is an array whose elements represents a seat or an aile.
  4. The seat is represented using the Seat object, meanwhile the aile is represented using null.

Seats Grouping Mechanism​

  1. Depending upon the allocation value of the seat, several seats may be grouped into a single seat. For example, two adjacent seats with allocation values of 2 will be grouped into a single seat.
  2. However, when reserving a grouped seat, the key of each of the seats in the group will need to be passed to the reserveSeats mutation.
  3. The grouped seats will be considered as one single seat, hence only one ticket will be required to purchase the grouped seat.
  4. The following is a sample Javascript code snipppet that shows the suggested algorithm for seats grouping:
for(let i = 0; i < twoDimensionView.length; i++){
    let row = twoDimensionView[i];
    for(let j= 0; j < row.seats.length; j++){
        let seat = row.seats[j];
        let groupedSeat = [];
        let occupy = j+seat.allocation
        if (occupy > row.seats.length){
            continue
        }
        if(seat != null){
            groupedSeat  = seat.splice(j, occupy);
        }

        ......
    }
}

List of Hall Types​

Due to the limitations of the cinema APIs, film formats (2D/STANDARD, 3D, etc) and hall experiences (GETHA LUX SUITE, PLAY+, etc) are a single property, which we refer to as a hall type. As such, our API will return a single value that describes the cinema hall under the type property of the CinemaHall object. Below are some of the hall types that WeTix API may return. The list of hall types below is not fixed and may change over time as we receive different combinations of film formats and hall experiences from the cinemas:

  • STANDARD
  • 3D
  • ATMOS
  • PLAY+
  • ATMOS D-BOX
  • PREMIERE CLASS
  • MAXX
  • GETHA LUX SUITE
  • BIG
  • ATMOS BIG
  • 4DX
  • ATMOS MAXX
  • D-BOX
  • ESCAPE STUDIO
  • STANDARD TAMIL
  • STANDARD TELUGU
  • STANDARD HINDI
  • ATMOS D-BOX MAXX
  • COMFORT CABIN
  • ONYX
  • MX4D
  • ATMOS GETHA LUX SUITE
  • SCREEN X
  • D-BOX MAXX
  • IMAX
  • ATMOS BIG PLAY+

The image below shows sample hall types displayed on WeTix showtimes page.