# Get the adaptive grid and the values of a generic object Get information about the adaptive grid and the values of a generic object by using the [GetHyperCubeBinnedData method](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/EngineJSONAPI/Content/service-genericobject-gethypercubebinneddata.htm). This method supports data binning. Information noteThe generic object should contain two measures and one dimension. ## Examples Example 1: [](https://help.qlik.com/en-US/sense-developer/Subsystems/EngineAPI/Content/Sense_EngineAPI/WorkingWithAppsAndVisualizations/RenderLayout/get-adaptive-grid-values-generic-object.htm) #### The goal of this example is to render the layout of a scatter plot visualization that contains a lot of data. The refinement level is low and cells are rendered. Depending on the refinement level, cells (group of points) are rendered instead of points. The generic object is a hypercube that contains two measures Sales and Loyalty and one dimension Customer. In the case of the scatter plot visualization shown below, the level of details is not high, so cells are rendered. ![Scatter point grid chart example, with Sales on the X axis and Loyalty on the Y axis](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/EngineAPI/Content/Resources/Images/ui-gen-example-GetHyperCubeAdaptiveGrid-group-cells-2.png) The corresponding request from the client is: ``` { "method": "GetHyperCubeBinnedData", "handle": 6, "params": [ "/qHyperCubeDef", [ { "qTop": 0, "qLeft": 0, "qWidth": 3, "qHeight": 17017 } ], { "qWidth": 0, "qHeight": 0 }, [ { "qLeft": -2644351.631545414, "qTop": 911.3638368475922, "qWidth": 45786832.74927128, "qHeight": 915.7366549854255 } ], 1000, 5, 0 ], "id": 66, "jsonrpc": "2.0" } ``` In the first array: * qWidth is 3 because the generic object contains two measures and one dimension. * qHeight is 17017 to render 17017 dimension values. In the second array: * qLeft gives the lowest value of the Sales measure. * qTop gives the highest value of the Loyalty measure. * qWidth gives the highest value of the Sales measure. * (qTop- qHeight ) gives the lowest value of the Loyalty measure. The maximum number of cells in the grid is 1000. The level of details that is provided is 5. The engine returns: ``` { "jsonrpc": "2.0", "id": 66, "result": { "qDataPages": [ { "qMatrix": [ [ { "qNum": 8702, "qElemNumber": 0, "qState": "L" } ], [ { "qText": "[36054269.925000,66.225000,37857027.481250,35.112500]", "qNum": 1, "qElemNumber": 363266048, "qState": "L" } ], [ { "qText": "[55884603.043750,128.450000,57687360.600000,97.337500]", "qNum": 1, "qElemNumber": 1396244480, "qState": "L" } ], [ { "qText": "[14421179.250000,66.225000,16223936.806250,35.112500]", "qNum": 1, "qElemNumber": -68288512, "qState": "L" } ], [ { "qText": "[14421179.250000,252.900000,16223936.806250,221.787500]", "qNum": 1, "qElemNumber": 1949958144, "qState": "L" } ], [ { "qText": "[16223936.806250,97.337500,18026694.362500,66.225000]", "qNum": 1, "qElemNumber": 50462720, "qState": "L" } ], [ { "qText": "[19829451.918750,66.225000,21632209.475000,35.112500]", "qNum": 1, "qElemNumber": -1226702848, "qState": "L" } ], [ { "qText": "[21632209.475000,97.337500,23434967.031250,66.225000]", "qNum": 1, "qElemNumber": -1107951616, "qState": "L" } ], [ { "qText": "[7210149.025000,66.225000,9012906.581250,35.112500]", "qNum": 13, "qElemNumber": -1270087680, "qState": "L" } ], [ { "qText": "[7210149.025000,97.337500,9012906.581250,66.225000]", "qNum": 3, "qElemNumber": -765198336, "qState": "L" } ], [ { "qText": "[7210149.025000,128.450000,9012906.581250,97.337500]", "qNum": 1, "qElemNumber": -260833280, "qState": "L" } ], [ { "qText": "[9012906.581250,66.225000,10815664.137500,35.112500]", "qNum": 7, "qElemNumber": -2042363904, "qState": "L" } ], [ { "qText": "[9012906.581250,128.450000,10815664.137500,97.337500]", "qNum": 2, "qElemNumber": -1033109504, "qState": "L" } ], [ { "qText": "[10815664.137500,66.225000,12618421.693750,35.112500]", "qNum": 3, "qElemNumber": 1480327168, "qState": "L" } ], [ { "qText": "[12618421.693750,66.225000,14421179.250000,35.112500]", "qNum": 2, "qElemNumber": 708050944, "qState": "L" } ], [ { "qText": "[12618421.693750,128.450000,14421179.250000,97.337500]", "qNum": 1, "qElemNumber": 1717305344, "qState": "L" } ], [ { "qText": "[5407391.468750,66.225000,7210149.025000,35.112500]", "qNum": 37, "qElemNumber": 282591232, "qState": "L" } ], [ { "qText": "[3604633.912500,66.225000,5407391.468750,35.112500]", "qNum": 76, "qElemNumber": 1827143680, "qState": "L" } ], [ { "qText": "[1801876.356250,35.112500,3604633.912500,4.000000]", "qNum": 1, "qElemNumber": -1437597696, "qState": "L" } ], [ { "qText": "[-881.200000,35.112500,1801876.356250,4.000000]", "qNum": 8702, "qElemNumber": -1946157056, "qState": "L" } ], [ { "qText": "[1801876.356250,66.225000,3604633.912500,35.112500]", "qNum": 223, "qElemNumber": 637534208, "qState": "L" } ], [ { "qText": "[-881.200000,66.225000,1801876.356250,35.112500]", "qNum": 7563, "qElemNumber": 128974848, "qState": "L" } ], [ { "qText": "[3604633.912500,97.337500,5407391.468750,66.225000]", "qNum": 10, "qElemNumber": -1962934272, "qState": "L" } ], [ { "qText": "[3604633.912500,128.450000,5407391.468750,97.337500]", "qNum": 6, "qElemNumber": -1458569216, "qState": "L" } ], [ { "qText": "[5407391.468750,97.337500,7210149.025000,66.225000]", "qNum": 6, "qElemNumber": 787480576, "qState": "L" } ], [ { "qText": "[5407391.468750,128.450000,7210149.025000,97.337500]", "qNum": 6, "qElemNumber": 1291845632, "qState": "L" } ], [ { "qText": "[1801876.356250,97.337500,3604633.912500,66.225000]", "qNum": 21, "qElemNumber": 1142423552, "qState": "L" } ], [ { "qText": "[-881.200000,97.337500,1801876.356250,66.225000]", "qNum": 223, "qElemNumber": 633864192, "qState": "L" } ], [ { "qText": "[1801876.356250,128.450000,3604633.912500,97.337500]", "qNum": 11, "qElemNumber": 1646788608, "qState": "L" } ], [ { "qText": "[-881.200000,128.450000,1801876.356250,97.337500]", "qNum": 53, "qElemNumber": 1138229248, "qState": "L" } ], [ { "qText": "[7210149.025000,159.562500,9012906.581250,128.450000]", "qNum": 1, "qElemNumber": -8388608, "qState": "L" } ], [ { "qText": "[7210149.025000,190.675000,9012906.581250,159.562500]", "qNum": 1, "qElemNumber": 243793920, "qState": "L" } ], [ { "qText": "[9012906.581250,159.562500,10815664.137500,128.450000]", "qNum": 1, "qElemNumber": -780664832, "qState": "L" } ], [ { "qText": "[9012906.581250,221.787500,10815664.137500,190.675000]", "qNum": 1, "qElemNumber": -276299776, "qState": "L" } ], [ { "qText": "[-881.200000,159.562500,1801876.356250,128.450000]", "qNum": 7, "qElemNumber": 1390673920, "qState": "L" } ], [ { "qText": "[-881.200000,190.675000,1801876.356250,159.562500]", "qNum": 8, "qElemNumber": 1642856448, "qState": "L" } ], [ { "qText": "[-881.200000,221.787500,1801876.356250,190.675000]", "qNum": 2, "qElemNumber": 1895038976, "qState": "L" } ], [ { "qText": "[-881.200000,252.900000,1801876.356250,221.787500]", "qNum": 1, "qElemNumber": 2147221504, "qState": "L" } ], [ { "qText": "[1801876.356250,159.562500,3604633.912500,128.450000]", "qNum": 2, "qElemNumber": 1899233280, "qState": "L" } ], [ { "qText": "[1801876.356250,190.675000,3604633.912500,159.562500]", "qNum": 2, "qElemNumber": -2143551488, "qState": "L" } ], [ { "qText": "[3604633.912500,159.562500,5407391.468750,128.450000]", "qNum": 2, "qElemNumber": -1206124544, "qState": "L" } ], [ { "qText": "[3604633.912500,190.675000,5407391.468750,159.562500]", "qNum": 1, "qElemNumber": -953942016, "qState": "L" } ], [ { "qText": "[5407391.468750,159.562500,7210149.025000,128.450000]", "qNum": 2, "qElemNumber": 1544290304, "qState": "L" } ], [ { "qText": "[5407391.468750,190.675000,7210149.025000,159.562500]", "qNum": 1, "qElemNumber": 1796472832, "qState": "L" } ], [ { "qText": "[5407391.468750,221.787500,7210149.025000,190.675000]", "qNum": 1, "qElemNumber": 2048655360, "qState": "L" } ], [ { "qText": "[-881.200000,284.012500,1801876.356250,252.900000]", "qNum": 1, "qElemNumber": -2021523456, "qState": "L" } ], [ { "qText": "[-881.200000,377.350000,1801876.356250,346.237500]", "qNum": 1, "qElemNumber": -1643249664, "qState": "L" } ], [ { "qText": "[1801876.356250,284.012500,3604633.912500,252.900000]", "qNum": 1, "qElemNumber": -1512964096, "qState": "L" } ], [ { "qText": "[1801876.356250,315.125000,3604633.912500,284.012500]", "qNum": 1, "qElemNumber": -1386872832, "qState": "L" } ], [ { "qText": "[5407391.468750,315.125000,7210149.025000,284.012500]", "qNum": 1, "qElemNumber": -1741815808, "qState": "L" } ], [ { "qText": "[5407391.468750,377.350000,7210149.025000,346.237500]", "qNum": 1, "qElemNumber": -1489633280, "qState": "L" } ], [ { "qText": "[12618421.693750,999.600000,14421179.250000,968.487500]", "qNum": 1, "qElemNumber": 448987136, "qState": "L" } ] ], "qTails": [], "qArea": { "qLeft": 0, "qTop": 0, "qWidth": 3, "qHeight": 51 } }, { "qMatrix": [], "qTails": [], "qArea": { "qLeft": 0, "qTop": 0, "qWidth": 0, "qHeight": 0 } } ] } } ``` Information about the adaptive cell grid is returned. Cells (group of points) are rendered and not points because the refinement level is too low. Therefore the values of the measures and the values of the dimension are not returned. Concerning the adaptive grid cell: * the maximum number of points in a cell is 8702 (in qNum of the first array). * the coordinates (expressed in the measure range) are returned for each cell (in qText). * the number of points in each cell is returned (in qNum). * the identifier of each cell is returned (in qElemNumber). Example 2: [](https://help.qlik.com/en-US/sense-developer/Subsystems/EngineAPI/Content/Sense_EngineAPI/WorkingWithAppsAndVisualizations/RenderLayout/get-adaptive-grid-values-generic-object.htm) #### The goal of this example is to render the layout of a scatter plot visualization that contains a lot of data. The refinement level is high and points are rendered. The generic object contains two measures Sales and Loyalty and one dimension Customer. In the case of the scatter plot visualization shown below, the level of details is high, so points are rendered. ![Example scatter plot chart visualization with individual Customer data points charted by Sales and Loyalty](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/EngineAPI/Content/Resources/Images/ui-gen-example-GetHyperCubeAdaptiveGrid-points.png) The corresponding request from the client is: ``` { "method": "GetHyperCubeBinnedData", "handle": 6, "params": [ "/qHyperCubeDef", [ { "qTop": 0, "qLeft": 0, "qWidth": 3, "qHeight": 17017 } ], { "qWidth": 0, "qHeight": 0 }, [ { "qLeft": 11085992.444266044, "qTop": 361.31534864125564, "qWidth": 14131738.502861504, "qHeight": 282.63477005723007 } ], 1000, 6, 0 ], "id": 23, "jsonrpc": "2.0" } ``` In the first array: * qWidth is 3 because the generic object contains two measures and one dimension. * qHeight is 17017 to render 17017 dimension values. In the second array: * qLeft gives the lowest value of the Sales measure. * qTop gives the highest value of the Loyalty measure. * qWidth gives the highest value of the Sales measure. * (qTop- qHeight ) gives the lowest value of the Loyalty measure. The maximum number of cells in the grid is 1000. The level of details that is provided is 6. The engine returns: ``` { "jsonrpc": "2.0", "id": 23, "result": { "qDataPages": [ { "qMatrix": [], "qTails": [], "qArea": { "qLeft": 0, "qTop": 0, "qWidth": 0, "qHeight": 0 } }, { "qMatrix": [ [ { "qText": "Rsl Contractors, Ltd", "qNum": 0, "qElemNumber": 4818, "qState": "L" }, { "qText": "2.3201e+007", "qNum": 23201033.97, "qElemNumber": 0, "qState": "L" }, { "qText": "82.4", "qNum": 82.39999999999999, "qElemNumber": 0, "qState": "L" } ], [ { "qText": "Khs&s Contractors", "qNum": 0, "qElemNumber": 2134, "qState": "L" }, { "qText": "1.79704e+007", "qNum": 17970402.81, "qElemNumber": 0, "qState": "L" }, { "qText": "83.2", "qNum": 83.19999999999999, "qElemNumber": 0, "qState": "L" } ], [ { "qText": "David Weekley Homes", "qNum": 0, "qElemNumber": 8790, "qState": "L" }, { "qText": "1.59806e+007", "qNum": 15980569.24, "qElemNumber": 0, "qState": "L" }, { "qText": "224", "qNum": 224, "qElemNumber": 0, "qState": "L" } ], [ { "qText": "Jdi Contractor & Supply", "qNum": 0, "qElemNumber": 4262, "qState": "L" }, { "qText": "1.41034e+007", "qNum": 14103439.920000002, "qElemNumber": 0, "qState": "L" }, { "qText": "108", "qNum": 108, "qElemNumber": 0, "qState": "L" } ] ], "qTails": [], "qArea": { "qLeft": 0, "qTop": 0, "qWidth": 3, "qHeight": 4 } } ] } } ``` The first array ( "qMatrix": []) is empty because points are rendered. The refinement is high. The second array returned the measure values and the dimension values for each point that is rendered. The state is L for each cell. It corresponds to the default state for a cell. Four points are rendered in total.