Retrieve Land Information for a Group

6 June 2020

C10 - added.

getgrouplandinfodata (Commands)
Type	Corrade progressive command
Command	`getgrouplandinfodata`
Description	The `getgrouplandinfodata` can be used to query data for a group following the DirectoryParcel structure and is mostly used to determine the land holdings for a group.
Permissions	`group`, `group`
Parameters	`group`, `password`
Last Changes	C10 - added.

The getgrouplandinfodata can be used to query data for a group following the DirectoryParcel structure and is mostly used to determine the land holdings for a group.

Command Required Parameters Required Corrade Permissions Example

getgrouplandinfodata

group, password

group

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "getgrouplandinfodata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "target", "63c7e5a5-4dfd-4f4c-8202-3bff0d87d40a",
            "data", wasListToCSV(
                [
                    "ActualArea",
                    "BillableArea"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

Optional Parameter	Possible Value	Description
`target`	A group name or UUID.	The group to act upon. If this parameter is omitted, then the command acts upon the configured group passed to the `group` parameter.

Amongst others, the command can be made to query ActualArea and BillableArea that can be used to determine the land holdings of a group by using the following formulas:

ActualArea - represents the total land contributions for a group,
BillableArea - represents the total land for a group that is currently being used,
$ActualArea - BillableArea$ - represents the total land for a group that is available.

Notes

This command relies on directory services to return data such that some of the returned parameters may be unavailable or have default values depending on the grid configuration.
The BillableArea parameter does not seem to appear in the documentation but it is still sent.